Local development differences in version 1.15.3 - AWS SimSpace Weaver
Changes to filesUpdate an existing C++ projectRun a new Python projectUpdate an existing Unity projectUpdate an existing Unreal Engine projectFAQ

End of support notice: On May 20, 2026, AWS will end support for AWS SimSpace Weaver. After May 20, 2026, you will no longer be able to access the SimSpace Weaver console or SimSpace Weaver resources. For more information, see AWS SimSpace Weaver end of support.

Local development differences in version 1.15.3

This section describes changes in development with SimSpace Weaver Local starting in version 1.15.3. These changes impact workflows for SimSpace Weaver Local projects in C++, Python, Unity, and Unreal Engine.

Changes to files

  • SimSpaceWeaverAppSdkLocal library files are now named weaver_app_sdk_cxx_v1_full_local.

    • You can find these files in sdk-folder\SimSpaceWeaverAppSdk-1.15.3\lib\weaverlocal\windows.

  • Your projects should no longer link to or include SimSpaceWeaverAppSDK-1.15.1\include\aws\weaverruntime\local_ffi.

  • The Python scripts for SimSpace Weaver Local no longer require cmake.

  • There are new or renamed Python scripts for SimSpace Weaver Local:

    • build-local — Builds the Python app for launch. It puts all of your Python code and the SimSpace Weaver Local library files in the buildlocal directory.

    • local-config — Defines the environment variables for the local scripts.

    • start-python-locally — Sets up the app's PythonPath and starts Python.

    • The following scripts are equivalent to the cloud scripts with similar names:

      • quick-start-local

      • start-simulation-local

      • stop-simulation-local

Update an existing C++ project to SimSpace Weaver Local 1.15.3

Requirements
To update your project

  1. Make sure that your project includes the required header:

    #include <aws/weaverruntime/ffi/weaver_app_sdk_cxx_ffi_v1/src/lib.rs.h>
    Note

    This is usually included in aws\weaverruntime\detail.h

  2. Make sure that your project does not include the following deprecated header:

    #include <aws/weaverruntime/local_ffi/Bridge.h>
    Note

    This is usually included in aws\weaverruntime\detail.h

  3. In your CMake file or build script, replace SimSpaceWeaverAppSdkLocal static library names with the new weaver_app_sdk_cxx_v1_full_local name.

  4. If you haven't run sdk-folder\docker-create-image.bat from version 1.15.3, run it now. You only need to do this 1 time.

  5. Follow the usual procedures to build and run your project.

Troubleshooting

You get linker errors (unresolved external symbol)

Your compiler outputs linker errors such as the following (line breaks added for readability).

Error    LNK2019    unresolved external symbol 
  "class outcome_v2_92ee5284::basic_result<class 
  Aws::WeaverRuntime::Application,
  enum Aws::WeaverRuntime::ffi::weaver_app_sdk_cxx_ffi_v1::ErrorCode
To fix the problem

  • Make sure your project does not include <aws/weaverruntime/local_ffi/Bridge.h>.

You get a type incompatibility error

You might get an error such as the following (line breaks added for readability).

the object has type qualifiers that are not compatible with the member function 
  object type is: const rust::cxxbridge1::String
To fix the problem

  1. Update your SimSpace Weaver header files with the 1.15.3 versions.

  2. Make sure any use of rust::cxxbridge1::String is similar to the following: 

    rust::cxxbridge1::String domain_name = domain.name.value;
if (domain.type_ == Api::DomainType::Spatial && Name.Compare(domain_name.c_str()) == 0)

Run a new Python project in SimSpace Weaver Local 1.15.3

Requirements
To run your project

  1. In a command prompt window, go to project-folder\tools\local\windows.

  2. Run quick-start-local.bat

    4 spatial apps, 1 view app, and 1 client should start locally. The client should display bubbles.

Troubleshooting

You get an error that says GLIBCXX isn't found

The following error indicates a failure to import the SimSpace Weaver Python app SDK. A likely cause is that your C++ libraries are out of date.

ImportError: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.29' not found
To fix the problem

  1. Update the source of your libstdc++ libraries (such as gcc or msvc) to a version that includes the specified version of GLIBCXX (in the example provided, the version is 3.4.29).

  2. Make sure that the system environment variable LD_LIBRARY_PATH is set to the correct path to lib64.

The quick start script fails

The quick start script fails with a message such as the following.

python: can't open file 'C:\usr\project\buildlocal\bIn\bubbles_tkinter_client.py':
  [Errno 2] No such file or directory
To fix the problem

  1. Go to project-folder\tools\local\windows and edit local-config.bat.

  2. Make sure that the following environment variables are set to the correct paths for your local system:

    • TOOLS_DIR is set to your project-folder\tools

    • TOOLS_DIR_WINDOWS is set to your project-folder\tools\local\windows

    • PROJECT_ROOT is set to your project-folder

    • BUILD_DIR is set to your project-folder\buildlocal

    • APP_SDK_DIR is set to your sdk-folder

Update an existing Unity project to SimSpace Weaver Local 1.15.3

Requirements
To update your project

  1. In Unity, remove the existing AWS SimSpace Weaver package.

    1. Open your existing Unity project.

    2. In the editor window, choose Window > Package Manager.

    3. Under Packages - Unity Technologies, select AWS SimSpace Weaver and choose Remove.

  2. In your version 1.15.3 sdk-folder, run download-unity-package.bat

  3. Follow the instructions in Unity_SDK_for_AWS_SimSpace_Weaver.pdf to add the newly downloaded SimSpaceWeaverUnityPackage.zip as the AWS SimSpace Weaver package in the Unity editor.

Update an existing Unreal Engine project to SimSpace Weaver Local 1.15.3

Requirements
To update your project

  1. Close all Unreal project and code editor windows.

  2. In a command prompt window, go to your version 1.15.3 sdk-folder.

  3. Run update-unreal-project.bat --path project-folder --name project-name.

    Note

    This replaces your existing plugin with the new plugin. Any modifications are erased.

  4. Follow the instructions in AWS_SimSpace_Weaver_Unreal_Guide.pdf to build your project for SimSpace Weaver Local.

Troubleshooting

Failure to delete exsiting plugin files

You might get errors similar to the following.

cannot remove '/usr/src/project/{PROJECT_NAME}/src/PathfindingSampleUnrealSpatial/PathfindingUnrealProject/Plugins/SimSpaceWeaverAppSdkPlugin/Binaries/Win64/UnrealEditor-WeaverAppSdk.dll': Operation not permitted
cannot remove '/usr/src/project/{PROJECT_NAME}/src/PathfindingSampleUnrealSpatial/PathfindingUnrealProject/Plugins/SimSpaceWeaverAppSdkPlugin/Binaries/Win64/UnrealEditor-WeaverAppSdkLocal.dll': Operation not permitted
cannot remove '/usr/src/project/{PROJECT_NAME}/src/PathfindingSampleUnrealSpatial/PathfindingUnrealProject/Plugins/SimSpaceWeaverAppSdkPlugin/Binaries/Win64/UnrealEditor-WeaverCppMetrics.dll': Operation not permitted
To fix the problem

  1. Make sure that the Unreal project editor window and code editors are closed.

  2. Run update-unreal-project.bat.

Frequently asked questions about SimSpace Weaver Local 1.15.3

  • Q1: How do I change my SimSpace Weaver Local environment variables for my Python project?

    • Edit project-folder\tools\windows\local-config for your Python project.