开始使用 AWS Gems

要开始将 AWS Gems 与 O3DE 项目中的 AWS 服务结合使用，请完成以下步骤。

1. 创建一个AWS账号 ，如果你还没有。

2. 按照 为 O3DE 配置 AWS 凭证 中的说明配置 AWS 凭证。

   a. 使用aws configure list命令配置确认您有凭据。

3. 安装 AWS 云开发套件 (CDK) 。

   a. 使用 cdk --version 命令确认AWS CDK的安装情况。

4. 在启用 AWS Core Gem（和您需要的其他 AWS Gem）的情况下构建 O3DE 项目。

5. 为您启用的 AWS Gem 部署 AWS CDK 应用程序。查看 部署AWS CDK应用程序了解详细指南。

6. 使用 Resource Mapping Tool配置 资源映射文件。

7. 将资源映射文件与项目关联。请参阅下一节标题为 Project Settings（项目设置）。

您现在应该能够在 Lua 脚本、Script Canvas 或 C++ 中使用 AWS 函数与您的 AWS 资源进行通信。查看 AWS Core脚本编程了解脚本示例。

阻止调用 Amazon EC2 实例元数据服务

AWS Gem 使用 AWS C++ 开发工具包 调用 AWS 资源。除非您的项目在 Amazon EC2 计算上运行，否则建议您通过将 AWS_EC2_METADATA_DISABLED 环境变量设置为true来关闭 Amazon EC2 实例元数据服务 （IMDS） 查询。

AWS Gem 使用 AWS C++ 开发工具包 调用 AWS 资源。除非您的项目在 Amazon EC2 计算上运行，否则建议您通过将 AWS_EC2_METADATA_DISABLED 环境变量设置为true来关闭 Amazon EC2 实例元数据服务 （IMDS） 查询。

设置此环境变量将防止 SDK 资源不必要地尝试联系 Amazon EC2 IMDS 以获取配置、区域和凭证信息，这可能会导致延迟和网络资源浪费。

# macOS / Linux
export AWS_EC2_METADATA_DISABLED=true

# Windows (for all sessions)
setx AWS_EC2_METADATA_DISABLED true

# Windows (for just this session)
set AWS_EC2_METADATA_DISABLED=true

项目设置

启动时，AWS Core Gem 将在项目的注册表目录中查找awscoreconfiguration.setreg文件： <ProjectName>\Registry.

如果要设置以下任何选项，则需要创建此文件。使用示例中所示的格式。 2

注意:

如果对此文件进行更改，则需要重新启动 O3DE 编辑器。

注册表设置文件示例：

  {
    "Amazon":
    {
      "AWSCore": {
          "ProfileName": "testprofile",
          "ResourceMappingConfigFileName": "default_aws_resource_mappings.json",
          "AllowAWSMetadataCredentials": false
      }
    }
  }