Skip to content

ANDROID_BUILD.md

Latest commit

 

History

History
79 lines (57 loc) · 2.45 KB

ANDROID_BUILD.md

File metadata and controls

79 lines (57 loc) · 2.45 KB
Raw

Android Release Build Guide

This is the exact process used to produce the working Android test build.

What worked best

  • Use an arm64 release build: --target aarch64
  • This produced an APK around 49 MB (good for GitHub branch download)
  • Building all targets created an APK around 185 MB, which is too large for GitHub's 100 MB file limit

Prerequisites

  • Bun installed
  • Android SDK installed at $HOME/Library/Android/sdk
  • Android NDK 27.0.12077973 installed
  • JDK 21 installed at /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home
  • Release keystore at packages/android/release.keystore
  • Keystore config at packages/android/src-tauri/gen/android/keystore.properties

Example keystore.properties:

storeFile=../../../../release.keystore
storePassword=your_password
keyAlias=your_alias
keyPassword=your_password

Build steps

Run from repo root:

cd packages/android
export JAVA_HOME="/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home"
export ANDROID_HOME="$HOME/Library/Android/sdk"
export NDK_HOME="$ANDROID_HOME/ndk/27.0.12077973"
export PATH="$JAVA_HOME/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"
bun run tauri android build --apk --target aarch64

Output APK

Build output path:

packages/android/src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk

Optional verification

ls -lh packages/android/src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
shasum -a 256 packages/android/src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk

If Java is not in your shell path, verify signature with:

export JAVA_HOME="/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"
export ANDROID_HOME="$HOME/Library/Android/sdk"
"$ANDROID_HOME/build-tools/35.0.0/apksigner" verify --print-certs packages/android/src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk

Copy APK to repo root (for easy GitHub download)

From repo root:

mv packages/android/src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk app-universal-release.apk

Upload branch with APK

git switch android-build
git add app-universal-release.apk
git commit -m "add android release APK for phone testing"
git push -u origin android-build