File size: 1,802 Bytes
3da9c98
 
 
 
 
 
dbc2744
 
3da9c98
dbc2744
 
3da9c98
 
 
dbc2744
 
 
3da9c98
 
 
 
dbc2744
 
 
3da9c98
 
 
dbc2744
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# SpaceForge — Android (Capacitor) MVP

## Artifact shipped

| | |
|--|--|
| **Preferred** | **Debug APK** (`.apk`) when Android SDK + JDK are in the SpaceForge Docker image |
| **Fallback** | Capacitor 6 **Android project ZIP** if APK build fails / SDK missing |
| **Mode** | **Hosted Wrapper** (Hybrid runtime — WebView loads live Space URL) |
| **Unsigned** | Debug APK is **unsigned** (sideload / `adb install`); not Play Store release |
| **Converter** | `backend/app/converters/mobile/android.py` + `finalize.py` |

## Compatibility badges (UI)

- ✓ **project** — Capacitor + Gradle scaffold generated
- ✓ **APK included** — when `assembleDebug` succeeds inside SpaceForge
- ⚠ **APK not built** — fallback project zip only
- ✗ **GPU local impossible** — when Space needs GPU; inference stays on Hugging Face

## What the user installs

1. Analyze Space → select **Android (Capacitor)** → Build → **Download**.
2. If filename ends with `.apk`: transfer to a device and sideload (`adb install -r app.apk` or Files → install). Allow unknown sources if prompted.
3. If filename ends with `.zip` (fallback): unzip → `npm install` → `npx cap sync android` → Android Studio / `./scripts/build-android.sh`.

## Labeling rules

- Never call the Hosted Wrapper a “Local offline APK” of the model/GPU runtime.
- Correct: “Debug APK (Hosted Wrapper / WebView)” or “project zip fallback”.
- `binary_included` / `apk_included` are **true only** when a real `.apk` file is returned.

## Docker image

The Space Dockerfile bakes:

- OpenJDK 17, Node 20, Android cmdline-tools
- `platforms;android-34`, `build-tools;34.0.0`
- Optional Gradle warmup via `scripts/docker_warmup_android.sh`

Env: `ANDROID_HOME=/opt/android-sdk`, `SPACEFORGE_ANDROID_BUILD_TIMEOUT=900`.