This repository contains modifiable source code for the AWS GameKit package for Unity in the form of an Embedded Package. If you don’t need to modify the AWS GameKit package, you can download the latest tarball .tgz
file from the releases page and add it to a Unity project using the Unity Package Manager.
To modify this package we recommend cloning this repo and opening it as a blank Unity project. After making your changes, follow the Packaging steps below to generate a custom plugin package, which you can then add to your Unity projects.
See Packages/com.amazonaws.gamekit/README.md for instructions on installing the Package Manager package.
git clone https://github.com/aws/aws-gamekit-unity
This package needs the GameKit C++ SDK binaries in order to work. There are two ways to get the binaries:
Use pre-built binaries:
com.amazonaws.gamekit-<version>.tgz
file.<expanded contents>/package/Plugins/]
into <root of this repo>/Package/com.amazonaws.gamekit/Plugins
and overwrite any existing files with the same name.Build the binaries:
.meta
files for the binaries will be deleted by Unity in the next step.refresh_plugin.py
as described in the Update Plugin with new binaries and headers
section of the
AWS GameKit C++ SDK README.aws-gamekit-unity
project.Packages/AWS GameKit/Runtime/Scripts
.If you ever need to regenerate the solution:
Edit > Preferences
and click Regenerate project files
See Assets/AWS_GameKit_Tests/README.md for instructions on running the unit tests.
Follow these instructions to debug the C# code: https://docs.unity3d.com/Manual/ManagedCodeDebugging.html
Follow these instructions to debug the AWS GameKit C++ SDK on Windows and step through from C# into C++ and back. You'll have two instances of Visual Studio open: one for C# and one for C++.
One-time setup:
Optional - Building the GameKit C++ SDK
above, ensure Debug binaries are being created instead of release./Packages/com.amazonaws.gamekit/Plugins/Windows/x64
Each time:
Unity.exe
aws-gamekit-unity - Untitled Scene - PC, Mac & Linux
Debugging > Unity
).Play Mode
or by interacting with AWS GameKit through the Unity editor.Run the following commands in order to create the com.amazonaws.gamekit-<version>.tgz
file:
cd path/to/aws-gamekit-unity
python export_unitypackage.py UNITY_APPLICATION_FULL_PATH
Where UNITY_APPLICATION_FULL_PATH
is like:
"C:\Program Files\Unity\Hub\Editor\2021.3.4f1\Editor\Unity.exe"
/Applications/Unity/Hub/Editor/2021.3.4f1/Unity.app/Contents/MacOS/Unity