Basic Android Example Instruction

This folder instructs you how to build android apps with cargo-apk, a deprecated Android apk building tool.

Setup

rustup target add aarch64-linux-android armv7-linux-androideabi
cargo install cargo-apk

Please refer example README for NDK/SDK related instructions.

Build & Run

When using cargo-apk, it must use NativeActivity, so you need to edit it in Cargo.toml manually like this:

bevy = { version = "0.14", default-features = false, features = ["android-native-activity", ...] }

Then the following fields must be added to Cargo.toml:

[package.metadata.android]
build_targets = ["aarch64-linux-android", "armv7-linux-androideabi"]

[package.metadata.android.sdk]
target_sdk_version = 33

Please refer cargo-apk README for other Android Manifest fields.

For this example, you can replace the Cargo.toml with the one within this folder.

After setup, you can run it on a device for Android development:

cargo apk run -p bevy_mobile_example

Please refer example README for debugging instructions.

Old phones

Bevy by default targets Android API level 33 in its examples which is the <!-- markdown-link-check-disable --> Play Store's minimum API to upload or update apps. <!-- markdown-link-check-enable --> Users of older phones may want to use an older API when testing.

To use a different API, the following fields must be updated in Cargo.toml:

[package.metadata.android.sdk]
target_sdk_version = >>API<<
min_sdk_version = >>API or less<<