终止支持通知：2026 年 5 月 20 日， AWS 将终止对的支持。 AWS SimSpace Weaver 2026 年 5 月 20 日之后，您将无法再访问 SimSpace Weaver 控制台或 SimSpace Weaver 资源。有关更多信息，请参阅[AWS SimSpace Weaver 终止支持](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # AWS SimSpace Weaver 版本 我们不断改进 AWS SimSpace Weaver。如果您想利用新功能和功能更新，则必须在我们发布新版本时下载最新的 SimSpace Weaver 应用程序 SDK。要使用更新的版本运行现有模拟，可能需要更新其架构和代码，然后启动新的模拟实例。您无需升级，并且可以继续使用以前的版本运行现有模拟。您可以查看此页面，了解不同版本之间的区别。目前支持所有版本。 **重要** 最新版本的《[AWS SimSpace Weaver 用户指南》](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/)仅涵盖最新版本的服务。您可以在[AWS SimSpace Weaver 指南目录中找到以前版本的文档，该目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)可从[主文档登录页面](https://docs.aws.amazon.com/simspaceweaver)获得。 ## 最新版本 最新版本是：1.17.0 ## 如何查找您的当前版本 如果您使用 SimSpace Weaver 应用程序 SDK 创建了模拟，则`create-project`脚本会将 SDK 库版本下载到您的子目录中。`sdk-folder`包含该开发工具包库的子目录的名称包含 SDK 版本号：`SimSpaceWeaverAppSdk-sdk-version`。例如，1.16.0 版本的库已在。`SimSpaceWeaverAppSdk-1.16.0` 您还可以在的文本文件`app_sdk_distributable_version.txt`中找到 SimSpace Weaver 应用程序 SDK 可分发包的版本。`sdk-folder` ## 下载最新版本 使用以下链接可下载最新版本。 + [完整的应用程序 SDK 可分发程序包](https://artifacts.simspaceweaver.us-east-2.amazonaws.com/latest/SimSpaceWeaverAppSdkDistributable.zip) + [仅应用程序 SDK 库](https://artifacts.simspaceweaver.us-east-2.amazonaws.com/latest/SimSpaceWeaverAppSdk.zip) 您也可以从[SimSpace Weaver 控制台](https://console.aws.amazon.com/simspaceweaver)中下载完整的 SimSpace Weaver App SDK 可分发软件包。 AWS 管理控制台从导航窗格中，选择**下载应用程序 SDK**。 **警告** 请勿使用下载任何看似 SimSpace Weaver 应用程序 SDK 可分发包的内容。 AWS CLI 仅使用此页面上的下载链接或控制台中的下载链接。不支持任何其他下载方法或位置，因为其他位置可能包含过时、不正确或有恶意的代码。 ### 应用程序 SDK 下载故障排除 我们使用亚马逊 CloudFront (CloudFront) 来分发应用程序 SDK .zip 文件。您可能会遇到以下几种情况。 + **下载的程序包不是最新版本** + 如果您下载的.zip 文件不包含最新版本，则可能是您的 CloudFront 边缘站点的缓存尚未更新。在 24 小时后重新下载。 + **您在使用下载链接时收到 HTTP 4xx 或 5xx 错误** + 在 24 小时后重试。如果您遇到同样的错误，请使用 [SimSpace Weaver 控制台](https://console.aws.amazon.com/simspaceweaver)底部的**反馈**链接报告问题。选择**报告问题**作为反馈**类型**。 + **您的浏览器报告无法加载该页面** + 您可能遇到了本地网络或浏览器配置问题。确认您可以加载其他页面。清除您的浏览器缓存，然后重试。确保您没有设置可能阻止下载网址的防火墙规则。 + **尝试保存文件时出现错误** + 检查您的本地文件系统权限，确保您拥有保存文件的正确权限。 + **将显示您的浏览器 **AccessDenied**** + 如果您在浏览器中手动输入网址，请检查拼写是否正确。如果您使用下载链接，请确保浏览器中的网址没有受到任何干扰；请再次使用该链接。 ## 安装最新版本 **安装最新版本** 1. [下载最新版本](#service-versions_download-latest-version)。 1. 将 SimSpaceWeaverAppSdkDistributable .zip 解压缩到一个文件夹。 1. `python setup.py`从解压缩的最新版本 SimSpace Weaver 应用程序 SDK 文件夹中运行。 1. 使用已解压缩的最新版本 SimSpace Weaver 应用程序 SDK 文件夹，而不是以前的版本。 ## 服务版本 | 版本 | 备注 | 发行日期 | 文档 | 下载应用程序 SDK | | --- | --- | --- | --- | --- | | 1.17.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) 有关更多信息，请参阅[版本注释](service-versions_1-17-0.md)。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2024 年 4 月 17 日 | 本指南 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html)参阅[故障排除](#service-versions_download-latest-version_troubleshooting)。 | | 1.16.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2024 年 2 月 12 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html)参阅[故障排除](#service-versions_download-latest-version_troubleshooting)。 | | 1.15.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 12 月 4 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.15.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 11 月 2 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.15.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 9 月 22 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.15.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 8 月 31 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.14.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 7 月 26 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.13.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 6 月 7 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.13.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 4 月 29 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.12.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 3 月 27 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.12.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 3 月 1 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.12.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/simspaceweaver/latest/userguide/service-versions.html) | 2023 年 2 月 28 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | | 1.12.0 | 公开发行版本 (GA) | 2022 年 11 月 29 日 | 参见[AWS SimSpace Weaver 指南目录](https://docs.aws.amazon.com/simspaceweaver/latest/catalog/userguide.html)。 | 不可供下载 | # AWS SimSpace Weaver 版本 1.17.0 此版本是对 A SimSpace Weaver pp SDK 可分发包的全面改版。我们用基于 Python 的脚本替换了过时的 Windows 批处理和 Linux Bash 脚本。 **重要** 现在，Python 3.9 是使用脚本和示例的必要条件，而不仅仅是用于 Python SDK。 **Contents** + [ ## 1.17.0 的主要变化 ](#service-versions_1-17-0_changelog) + [ ## 将项目更新到 1.17.0 ](#service-versions_1-17-0_update-project) + [ ## 关于版本 1.17.0 的常见问题 ](#service-versions_1-17-0_faq) ## 1.17.0 的主要变化 + 简化了项目创建 + 运行后`setup.py`，您只需复制粘贴示例即可创建自己的项目。 + 一键式示例 + 分发 zip 文件现在包含在设置发行版后可以使用的 ready-to-use示例。 + 现在，每个 SDK 都存在于自己的目录中：`cpp``python``unreal`、、和`unity`。根据您使用的 SDK，您可能需要更新路径。 + 对帮助脚本的改进。 + 脚本现在包含多个 AWS CLI 选项，以最大限度地提高其灵活性。 + 集成的控制台客户端启动和连接是快速入门的一部分。 + 改进了控制台输出。 + Unreal 和 Unity 示例构建现在可以使用`quick-start`，无需再手动执行任何步骤。 + SimSpace Weaver Local 现在只需调用即可工作`quick-start`，不再需要手动构建和启动。 + SimSpace Weaver Local `quick-start`集成了对记录应用程序输出的支持。 + SimSpace Weaver Local 现在可以在非 GUI 环境中启动，例如在 ssh 会话中。 + “自定义容器” 功能现已集成到`quick-start`脚本中。 + 增加了对亚马逊 Linux 2 (AL2) 的支持：适用于 Windows 的脚本工作流程， AL2 现在可以与之媲美。以前， AL2 项目需要更多的手动步骤，SimSpace Weaver Local 不支持 AL2。 + 虚幻引擎和Unity插件现已包含在 SimSpace Weaver 应用程序SDK可发行包中。 + 的错误修复 SimSpace Weaver Local + 修复了可以为实体分配相同实体 ID 的错误。 + 修复了两个分区可以分配相同分区 ID 的错误。 + 修复了与应用程序尝试写入其不拥有的实体相关的错误。 + 解决了内存泄漏问题。 ## 将项目更新到 1.17.0 1. 设置 1.17.0 发行版：请再次完成安装过程，因为我们在 1.17.0 中对其进行了更改。有关更多信息，请参阅 [正在设置 SimSpace Weaver](setting-up.md)。 1. 现在，每个 Weaver App SDK 都存在于自己的目录中。更新您的构建路径以反映这一点。 1. C\$1\$1 目录：`SimSpaceWeaverAppSdk/cpp` + C SimSpace Weaver \$1\$1 应用程序 SDK 现在使用`FindSimSpaceWeaverAppSdk.cmake`文件。此文件设置了一个链接到的`weaver`目标，并包含了在中为 Weaver 构建时的重要错误修复。 AWS 云你应该使用它而不是直接链接到二进制文件。 1. Python 目录：`SimSpaceWeaverAppSdk/python` 1. Unity 插件：`SimSpaceWeaverAppSdk/unity` 1. 虚幻引擎插件：`SimSpaceWeaverAppSdk/unreal` 1. 之前的`tools`脚本不适用于新的 SimSpace Weaver 发行版。要在项目中使用新`tools`脚本，请执行以下操作： 1. 删除您的旧`tools/windows``tools/linux`、和`tools/local`目录。 1. 复制与您的项目使用相同 SimSpace Weaver 应用程序 SDK 的示例项目的`tools`目录。在复制此目录`setup.py`***之前***，请确保已运行。 **重要** 仅保证这些工具脚本可以与示例项目配合使用。您可能需要编辑这些脚本，尤其是脚本，才能与您的项目配合使用。`build.py`任何编辑都是您的项目所独有的，因此我们无法提供任何指导。 ## 关于版本 1.17.0 的常见问题 **我必须更新到 1.17.0 版本吗？** 这不是必需的更新，因为 SimSpace Weaver API 或 SimSpace Weaver 应用程序 SDK 没有变化。如果要使用 1.17.0，则必须更新到 1.17.0 SimSpace Weaver Local，其中包含多个错误修复。 **所需的最低 Python 版本是多少？** Python 3.9 是最低版本。 **所需的最低 CMake 版本是多少？** CMake 3.13 版本是最低版本。 **需要的最低版本的虚幻引擎是多少？** 虚幻引擎5.0是最低限度。 **要求的 Unity 的最低版本是多少？** Unity 版本 2022.3.19.F1 是最低版本。 # AWS SimSpace Weaver 版本 1.15.1 该版本是最初在 SimSpace Weaver 版本 1.15.0 中发布的 Python SDK 的**必需**更新。它修复了 AWS 云中导致基于 Python 的模拟失败的版本不匹配问题。请使用此版本，而不是 1.15.0。 ## 将现有 Python 项目更新到 1.15.1 如果您已有使用 Python SDK 版本 1.15.0 创建的现有 Python 项目，则必须执行以下步骤，以便将其更新到 1.15.1，从而使其可在 AWS 云中运行。 您还可以使用 Python SDK 1.15.1 创建一个新的 Python 项目，然后将您的自定义代码转移到新项目中，这样就不必执行此过程。 **将 1.15.0 Python 项目更新到 1.15.1** 1. 转到您的 Python 项目的文件夹。 1. 在 `src/PythonBubblesSample/bin/run-python` 中更改以下行： ``` export PYTHONPATH=$PYTHONPATH:/roapp/lib ``` 更改为以下来源： ``` export PYTHONPATH=$PYTHONPATH:$LD_LIBRARY_PATH:/roapp/lib ``` 1. 在 `CMakeLists.txt` 中删除以下几行： + ``` file(COPY "${SDK_PATH}/libweaver_app_sdk_python_v1_$ENV{PYTHON_VERSION}.so" DESTINATION "${ZIP_FILES_DIR}/lib/weaver_app_sdk_v1") ``` + ``` file(RENAME "${ZIP_FILES_DIR}/lib/weaver_app_sdk_v1/libweaver_app_sdk_python_v1_$ENV{PYTHON_VERSION}.so" "${ZIP_FILES_DIR}/lib/weaver_app_sdk_v1/libweaver_app_sdk_python_v1.so") ``` + ``` message(" * COPYING WEAVER PYTHON SDK TO BUILD DIR ${ZIP_FILES_DIR}....") ``` + ``` file(COPY ${SDK_DIR} DESTINATION ${ZIP_FILES_DIR}/lib/weaver_app_sdk_v1) ``` ## 有关版本 1.15.1 的故障排除 ### 更新 1.15.0 Python 模拟后，它无法在中启动 AWS 云 **征兆：**启动模拟后大约过了 5-10 分钟，模拟管理日志报告 `internal error` 且模拟状态为 `FAILED`。 如果应用程序 zip 文件中包含 1.15.0 Python SDK 的库文件，则可能会发生这种情况。请确保您已完成更新项目的步骤，并确保您的 zip 文件中没有 `libweaver_app_sdk_python_v1.so`，也没有以任何方式对其进行引用。 ## 有关版本 1.15.1 的常见问题解答 **除了 Python SDK 之外，该版本还会影响其他方面吗？** 否。 **我必须更新为版本 1.15.1 吗？** 如果您不打算在空间应用程序中使用 Python，则不必更新到 1.15.1。如果你更新到 1.15.0，则基于 Python 的模拟将无法在中运行。 AWS 云如果您使用的是 1.15.0，我们建议您更新到 1.15.1。 **什么是 `$LD_LIBRARY_PATH`？** 当您的模拟在 AWS 云中运行时，这是 Python SDK 的位置。这是 1.15.1 的新特征。我们进行此更改是为了避免将来出现 Python 版本问题。从功能上而言，链接到该目录与在 1.15.0 中链接到 `libweaver_app_sdk_python_v1.so` 相同。