SilverDROID - Dark Side Admin with CI/CD pipeline
- 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
This commit is contained in:
168
BUILD_INSTRUCTIONS.md
Normal file
168
BUILD_INSTRUCTIONS.md
Normal file
@@ -0,0 +1,168 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user