SilverDROID/BUILD_INSTRUCTIONS.md

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

   cd C:\Production\Source\SilverLABS\SilverDROID
   

2. Download Gradle Wrapper (first time only)

   # 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

   .\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:

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:

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:

private val targetUrl = "https://admin.dark.side"

Change to your desired URL and rebuild.

---

Troubleshooting

"SDK location not found"

Set ANDROID_HOME:

[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.