Lumberyard
Distributing Lumberyard Apps
Android
Requirements:
* Lumberyard and Android SDK installed on Windows 10
Step 1 - Download Android SDK Components
Use Android's SDK Manager to download following components:
- Google Play APK Expansion Library
- Google Play Licensing Library
- Android SDK Platform-Tools
- Android SDK Tools
Step 2 - Download and Setup Lumberyard Components
Run Lumberyard's Setup Assistant.
If you haven't installed Lumberyard core, click Custom Install and verify that the engine root path is correct.
On the Getting Started page, enable the following items.
- Compile the game code
- Compile the engine and asset pipeline
- Compile the Lumberyard Editor and tools
- Compile for Android devices
On the Required Software section, install and configure paths for the following items.
- Android Native Development (NDK)
- Android Software Development Kit (SDK) Tools
- Java SE Development Kit (JDK) - Make sure you use the official Java SE 8 from Oracle or Java SE 8 OpenJDK reference implementation. Other JDK releases won't work and you will have WAF errors during clean builds.
Step 3 - Enable OpenGL ES 3.X for Lumberyard
Close the editor and all of its componenets. Then, open lumberyard_version\dev\AssetProcessorPlatformConfig.ini in a text editor to make the following changes.
- Remove the semicolon before
es3=enabled
to enable it. Your development platform gets enabled automatically, so you don't have to enablepc
orosx_gl
unless they are required by your custom build schemes.
[Platforms]
;pc=enabled
es3=enabled
;ios=enabled
;osx_gl=enabled
Step 4 - Generate Android Studio Project
Run Project Configurator to activate your current project.
Using a command line app, navigate to lumberyard_version\dev folder.
Run
lmbr_waf.bat configure
to generate your Android Studio project if you haven't already.
Step 5 - Generate Shaders for Release
Build, deploy, and run your app on an Android device by using Lumberyard Editor's Deployment Tool Plugin. Run remote shader compiler if it doesn't launch automatically.
In your app, explore every area in every level to ensure that all shader permutations required for the app are generated.
Once you complete exploring all included levels, close the app.
Embed the shader PAK files into your app or put them in a remotely accessible location where your app can access later. PAK files are located in lumberyard_version\dev\Build\es3\game_project_name folder. For more details, please refer to this.
Step 6 - Build
Using a command line app or terminal, navigate to lumberyard_version\dev folder.
Determine your build's target CPU architecture. (i.e armv8)
Determine your build's type. (i.e profile, debug, release)
Run the following command to build your APK. Make sure the CPU arch and build type is set correctly in the following command.
REM : replace 'armv8' and release 'words' if necessary.
lmbr_waf.bat -p all build_android_armv8_clang_release --package-projects-automatically=True
Step 7 - Upload to TestFairy
Once your APK is built, you can choose your favourite upload method to finalize distribution. Make sure the correct CPU architecture is set for the project binaries path.
To upload with curl, run the following command in lumberyard_version\dev\BinAndroidCPU_ARCHClang folder. Make sure your APK file name is set correctly.
curl https://upload.testfairy.com/api/upload -F api_key='your_api_key' -F file=@ProjectName.apk
Optionally, you can download and use TestFairy command line uploader if you don't have curl installed.
Last updated on 2023-05-23