SysAdmin
c667765488
- Android PWA/WASM launcher with glassmorphism UI - Loads https://admin.dark.side directly on launch - Complete GitLab CI/CD pipeline configuration - Automated builds for Debug, Release, and AAB - Full WASM support with optimized WebView - Material Design 3 theme - Comprehensive documentation Features: - Auto-load target URL on app launch - Glassmorphism components (frosted glass effects) - Full PWA/WASM support - Room database for future extensions - Jetpack Compose UI - CI/CD with artifact storage Built for SilverLABS
168 lines
3.3 KiB
Markdown
168 lines
3.3 KiB
Markdown
# Build Instructions for Dark Side Admin APK
|
|
|
|
## ⚠️ Important: This is a Custom Build
|
|
|
|
This version of SilverDROID loads `https://admin.dark.side` directly on launch.
|
|
|
|
---
|
|
|
|
## Option 1: Build with Android Studio (Recommended)
|
|
|
|
### Steps:
|
|
|
|
1. **Open Project**
|
|
```
|
|
C:\Production\Source\SilverLABS\SilverDROID
|
|
```
|
|
- Launch Android Studio
|
|
- File → Open → Select `SilverDROID` folder
|
|
|
|
2. **Sync Gradle**
|
|
- Wait for automatic Gradle sync (~2-5 minutes)
|
|
- If prompted, click "Sync Now"
|
|
|
|
3. **Build APK**
|
|
- Build → Build Bundle(s) / APK(s) → Build APK(s)
|
|
- Wait for build to complete
|
|
- Click "locate" in notification to find APK
|
|
|
|
4. **APK Location**
|
|
```
|
|
app\build\outputs\apk\debug\app-debug.apk
|
|
```
|
|
|
|
---
|
|
|
|
## Option 2: Build from Command Line (Windows PowerShell)
|
|
|
|
### Prerequisites:
|
|
- Android SDK installed
|
|
- `ANDROID_HOME` environment variable set
|
|
|
|
### Steps:
|
|
|
|
1. **Open PowerShell**
|
|
```powershell
|
|
cd C:\Production\Source\SilverLABS\SilverDROID
|
|
```
|
|
|
|
2. **Download Gradle Wrapper** (first time only)
|
|
```powershell
|
|
# Download Gradle distribution
|
|
Invoke-WebRequest -Uri "https://services.gradle.org/distributions/gradle-8.9-bin.zip" -OutFile "gradle.zip"
|
|
|
|
# Extract
|
|
Expand-Archive -Path "gradle.zip" -DestinationPath "." -Force
|
|
|
|
# Create wrapper
|
|
.\gradle-8.9\bin\gradle.bat wrapper
|
|
|
|
# Cleanup
|
|
Remove-Item gradle.zip
|
|
Remove-Item -Recurse -Force gradle-8.9
|
|
```
|
|
|
|
3. **Build Debug APK**
|
|
```powershell
|
|
.\gradlew.bat assembleDebug
|
|
```
|
|
|
|
4. **Output Location**
|
|
```
|
|
app\build\outputs\apk\debug\app-debug.apk
|
|
```
|
|
|
|
---
|
|
|
|
## Option 3: Use TeamCity CI/CD
|
|
|
|
Upload the project to GitLab and configure TeamCity:
|
|
|
|
**GitLab:** https://gitlab.silverlabs.uk
|
|
**TeamCity:** https://cis1.silverlabs.uk
|
|
|
|
### TeamCity Build Steps:
|
|
```kotlin
|
|
steps {
|
|
gradle {
|
|
tasks = "clean assembleDebug"
|
|
gradleWrapperPath = ""
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Installing the APK
|
|
|
|
### On Physical Device:
|
|
1. Copy `app-debug.apk` to your device
|
|
2. Tap the APK file
|
|
3. Allow "Install from Unknown Sources" if prompted
|
|
4. Tap "Install"
|
|
|
|
### Via ADB:
|
|
```powershell
|
|
adb install app\build\outputs\apk\debug\app-debug.apk
|
|
```
|
|
|
|
---
|
|
|
|
## What This Build Does
|
|
|
|
- ✅ Loads `https://admin.dark.side` immediately on launch
|
|
- ✅ Bypasses the launcher screen
|
|
- ✅ Full WASM/PWA support enabled
|
|
- ✅ Glassmorphism UI for top bar
|
|
- ✅ Back button exits the app
|
|
|
|
---
|
|
|
|
## Customization
|
|
|
|
To change the URL, edit:
|
|
```
|
|
app/src/main/kotlin/uk/silverlabs/silverdroid/MainActivity.kt
|
|
```
|
|
|
|
Line 23:
|
|
```kotlin
|
|
private val targetUrl = "https://admin.dark.side"
|
|
```
|
|
|
|
Change to your desired URL and rebuild.
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### "SDK location not found"
|
|
Set `ANDROID_HOME`:
|
|
```powershell
|
|
[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "C:\Users\YourUser\AppData\Local\Android\Sdk", "User")
|
|
```
|
|
|
|
### "Gradle sync failed"
|
|
1. Check internet connection
|
|
2. Delete `.gradle` folder
|
|
3. Restart Android Studio
|
|
4. Try sync again
|
|
|
|
### "Build failed"
|
|
1. Check JDK version: `java -version` (must be 17+)
|
|
2. Clean project: `.\gradlew.bat clean`
|
|
3. Rebuild: `.\gradlew.bat assembleDebug`
|
|
|
|
---
|
|
|
|
## Build Configuration
|
|
|
|
- **Package Name:** `uk.silverlabs.silverdroid`
|
|
- **App Name:** "Dark Side Admin"
|
|
- **Min SDK:** 26 (Android 8.0)
|
|
- **Target SDK:** 35 (Android 15)
|
|
- **Version:** 1.0.0
|
|
|
|
---
|
|
|
|
Need help? Check the main README.md or contact SilverLABS support. |