47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
# CargoRadar Android
|
|
|
|
This is the first driver-app skeleton. It uses a foreground service, Android's
|
|
native `LocationManager`, and `HttpURLConnection` so the MVP has no runtime
|
|
library dependencies beyond the Android Gradle/Kotlin plugins.
|
|
|
|
## Build
|
|
|
|
Open `apps/android` in Android Studio, sync Gradle, then run the `app` module.
|
|
For command-line debug builds:
|
|
|
|
```powershell
|
|
$env:JAVA_HOME="C:\Program Files\Android\Android Studio\jbr"
|
|
$env:ANDROID_HOME="$env:LOCALAPPDATA\Android\Sdk"
|
|
.\gradlew.bat :app:assembleDebug
|
|
```
|
|
|
|
The debug APK is created at:
|
|
|
|
```text
|
|
apps/android/app/build/outputs/apk/debug/app-debug.apk
|
|
```
|
|
|
|
Current Gradle plugin choices:
|
|
|
|
- Android Gradle Plugin: `9.2.0`
|
|
- Kotlin: built into Android Gradle Plugin 9.x
|
|
- Gradle wrapper: `9.4.1`
|
|
- compile/target SDK: `36`
|
|
|
|
## MVP behavior
|
|
|
|
- The app asks for foreground location and notification permissions.
|
|
- Press `운행 시작` to start a location foreground service.
|
|
- The service uploads location JSON to `/api/v1/locations`.
|
|
- Failed uploads are queued locally and retried after the next successful send.
|
|
- Press `운행 종료` to stop location updates.
|
|
|
|
For emulator testing, keep the default server URL `http://10.0.2.2:8080`.
|
|
For a real phone, use the NAS or PC LAN URL, for example
|
|
`http://192.168.200.129:18081`.
|
|
|
|
The current public reverse-proxy URL is
|
|
`https://cargoradar.comtropy.synology.me`.
|
|
|
|
Production builds should use HTTPS and disable cleartext traffic.
|