Android Build - Quick Reference Card

✅ One-Line Build (After Setup)

cd android_client && ./gradlew build

📋 Pre-Build Checklist

Java installed: java -version (need 11+)
Android SDK installed (via Android Studio)
ANDROID_HOME set: echo $ANDROID_HOME
Gradle wrapper present: ls android_client/gradlew

🚀 Build Commands

Task	Linux/macOS	Windows
Build APK	`./gradlew build`	`gradlew.bat build`
Debug APK only	`./gradlew assembleDebug`	`gradlew.bat assembleDebug`
Install to device	`./gradlew installDebug`	`gradlew.bat installDebug`
Release APK	`./gradlew assembleRelease`	`gradlew.bat assembleRelease`
Clean build	`./gradlew clean build`	`gradlew.bat clean build`

📍 APK Locations After Build

android_client/
  └── app/build/outputs/apk/
      ├── debug/app-debug.apk        (8-10 MB)
      └── release/app-release.apk    (5-6 MB)

🔧 Troubleshooting 2-Minute Fixes

"./gradlew: permission denied"

chmod +x android_client/gradlew
./gradlew build

"gradle: command not found"

cd android_client
./gradlew build  # Uses embedded gradle

"ANDROID_HOME not set"

export ANDROID_HOME=$HOME/Android/Sdk  # Linux/macOS
# or
$env:ANDROID_HOME = "$env:USERPROFILE\AppData\Local\Android\Sdk"  # Windows
./gradlew build

"Java not found"

# Install Java 11+
# Linux: sudo apt-get install openjdk-11-jdk
# macOS: brew install java@11
# Windows: https://adoptopenjdk.net/

java -version  # Verify
./gradlew build

"Build fails - need SDK components"

# Let Android Studio download missing components
# Android Studio → Tools → SDK Manager → Install missing packages
# Then retry build
./gradlew clean build

📊 Build Times

First build: 5-15 minutes (downloads 500+ MB)
Incremental build: 30 seconds - 2 minutes
Clean build: 2-5 minutes

📚 Documentation

For setup: See SETUP_GUIDE.md
For usage: See README.md
For tech details: See ../ANDROID_IMPLEMENTATION.md

✨ Working Gradle Wrapper

✅ Gradle wrapper is now included!

Linux/macOS: ./gradlew ← Use this
Windows: gradlew.bat ← Use this
No separate Gradle installation needed

🎯 Next Steps

Build: cd android_client && ./gradlew build
Install: ./gradlew installDebug (if device connected)
Run: Open SCAR Chat app on device

Last Updated: December 4, 2025 Status: ✅ Gradle wrapper included and working

2.6 KiB Raw Blame History