142 lines
2.6 KiB
Markdown
142 lines
2.6 KiB
Markdown
|
# Setup Build Environment
|
||
|
|
|
||
|
|
The Android app is ready to build! You just need to install Java first.
|
||
|
|
|
||
|
|
## Install Java 17
|
||
|
|
|
||
|
|
### Option 1: Via Windows (Recommended for WSL)
|
||
|
|
|
||
|
|
Download and install Java 17 JDK for Windows, then WSL can use it:
|
||
|
|
|
||
|
|
1. **Download Oracle JDK 17:**
|
||
|
|
- https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
|
||
|
|
- Or OpenJDK: https://adoptium.net/temurin/releases/?version=17
|
||
|
|
|
||
|
|
2. **Install on Windows**
|
||
|
|
|
||
|
|
3. **Add to WSL PATH:**
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Add to ~/.bashrc
|
||
|
|
echo 'export JAVA_HOME="/mnt/c/Program Files/Java/jdk-17"' >> ~/.bashrc
|
||
|
|
echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.bashrc
|
||
|
|
source ~/.bashrc
|
||
|
|
|
||
|
|
# Verify
|
||
|
|
java -version
|
||
|
|
```
|
||
|
|
|
||
|
|
### Option 2: SDKMAN (Linux-native)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Install SDKMAN
|
||
|
|
curl -s "https://get.sdkman.io" | bash
|
||
|
|
source "$HOME/.sdkman/bin/sdkman-init.sh"
|
||
|
|
|
||
|
|
# Install Java 17
|
||
|
|
sdk install java 17.0.9-tem
|
||
|
|
|
||
|
|
# Verify
|
||
|
|
java -version
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Build the App
|
||
|
|
|
||
|
|
Once Java is installed:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd ~/.openclaw/workspace/alfred-mobile
|
||
|
|
|
||
|
|
# First build (downloads Android SDK, takes 5-10 min)
|
||
|
|
./gradlew assembleDebug
|
||
|
|
|
||
|
|
# Output
|
||
|
|
app/build/outputs/apk/debug/app-debug.apk
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Install on Tablet
|
||
|
|
|
||
|
|
### Method 1: ADB (USB)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Enable USB debugging on tablet:
|
||
|
|
# Settings → About → Tap "Build number" 7 times
|
||
|
|
# Settings → Developer options → USB debugging → ON
|
||
|
|
|
||
|
|
# Connect tablet via USB
|
||
|
|
adb devices
|
||
|
|
|
||
|
|
# If device not found:
|
||
|
|
# - Allow USB debugging on tablet
|
||
|
|
# - Try different USB cable/port
|
||
|
|
|
||
|
|
# Install
|
||
|
|
adb install app/build/outputs/apk/debug/app-debug.apk
|
||
|
|
|
||
|
|
# Or reinstall if already installed
|
||
|
|
adb install -r app/build/outputs/apk/debug/app-debug.apk
|
||
|
|
```
|
||
|
|
|
||
|
|
### Method 2: Direct Install
|
||
|
|
|
||
|
|
1. Copy APK to tablet:
|
||
|
|
```bash
|
||
|
|
# Via ADB
|
||
|
|
adb push app/build/outputs/apk/debug/app-debug.apk /sdcard/Download/
|
||
|
|
|
||
|
|
# Or use file sharing, email, etc.
|
||
|
|
```
|
||
|
|
|
||
|
|
2. On tablet:
|
||
|
|
- Open Files app → Downloads
|
||
|
|
- Tap `app-debug.apk`
|
||
|
|
- Allow "Install from unknown sources" if prompted
|
||
|
|
- Tap "Install"
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Test OAuth Flow
|
||
|
|
|
||
|
|
See `BUILD_STATUS.md` for testing instructions.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
|
||
|
|
### "No Java runtime present"
|
||
|
|
|
||
|
|
Java not installed or not in PATH. Follow instructions above.
|
||
|
|
|
||
|
|
### "SDK location not found"
|
||
|
|
|
||
|
|
Gradle will auto-download Android SDK on first build. Just wait.
|
||
|
|
|
||
|
|
### "Build failed"
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Clean and rebuild
|
||
|
|
./gradlew clean assembleDebug
|
||
|
|
|
||
|
|
# Check logs
|
||
|
|
./gradlew assembleDebug --stacktrace
|
||
|
|
```
|
||
|
|
|
||
|
|
### "Could not HEAD 'https://dl.google.com/...'"
|
||
|
|
|
||
|
|
Network issue. Check internet connection and retry.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
Once Java is installed, run:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd ~/.openclaw/workspace/alfred-mobile
|
||
|
|
./gradlew assembleDebug
|
||
|
|
```
|
||
|
|
|
||
|
|
Then install on your tablet and test! 🚀
|