Lumberyard Android support - Lumberyard User Guide

Lumberyard Android support

Open 3D Engine (O3DE), the successor to Lumberyard, is now available in Developer Preview. Download O3DE or visit the AWS Game Tech blog to learn more.

In this section, you'll learn about the system requirements for Android. You will also learn how to set up your Amazon Lumberyard installation for Android builds, configure your project for Android support, and build and deploy to devices. When you finish your development cycle and are ready to release, that's covered here too. Along the way, you'll want to use the troubleshooting guide and reference materials to help resolve any issues you might find.

Minimum device requirements

Lumberyard has the following minimum requirements to deploy to Android. These are only minimum device specs. Newer devices offer better performance and require fewer optimizations. Most devices released in 2017 or later meet these criteria.

CPU

ARMv8 quad-core

GPU

OpenGL ES 3.0 or 3.1 support

OS Android 5.0 (API level 21)

If your Lumberyard project requires higher minimum specifications than these to achieve what you consider acceptable performance, you can set your own device and capability requirements through the Google Play Store. See the Android documentation for more information.

Prerequisites

To get started with your Lumberyard project on Android, you need the following software installed, in addition to Lumberyard. If you need to, download Lumberyard now. Lumberyard can be configured for Android development either when you install it, or after you set up your Android tools. See Set up your environment to develop for Android with Lumberyard for more information.

  • An Android development environment. This can be either Android Studio or the standalone command line tools. For developers not already familiar with working with Android, we recommend Android Studio, which includes the command-line tools. Download Android developer tools.

  • The required minimum development SDKs:

    • Microsoft Visual Studio 2019 or 2017. Download Visual Studio from Microsoft.

    • Android NDK r21

    • Android SDK API level 28 (Android 9.0 – Pie). The following libraries and tools are required as part of the SDK installation.

      • Google Play APK Expansion Library

      • Google Play Licensing Library

      • Android SDK Tools

      • Android SDK Platform-Tools

      • Build Tools 26.x.x or later

    Important

    Google requires that new apps submitted to the Google Play Store are built against an SDK version that is no more than one year old. To make sure that you meet this requirement, build against the latest available Android SDK and check for updated versions before any submission to the Google Play Store.

    For instructions on installing the Android SDK and NDK, see the Android Studio SDK Manager or Command-line sdkmanager documentation on the Android developer site. For information on the packages required as part of the Android SDK install, see Set up your environment to develop for Android with Lumberyard.

Video tutorial

To help you get up and running quickly with Android, we have a video tutorial (10:10) that walks through the process of getting Android Studio installed, configuring your Lumberyard project, and running the project on an Android device.