SilverDROID/BUILD.md

Build Instructions for SilverDROID

Quick Start (Windows)

From WSL/Linux:

cd /mnt/c/Production/Source/SilverLABS/SilverDROID

# Build debug APK
./gradlew assembleDebug

# Install on connected device
./gradlew installDebug

From Windows PowerShell:

cd C:\Production\Source\SilverLABS\SilverDROID

# Build debug APK
.\gradlew.bat assembleDebug

# Install on connected device
.\gradlew.bat installDebug

Android Studio Setup

1. Open Project

   • Launch Android Studio
   • File → Open → Navigate to SilverDROID folder
   • Wait for Gradle sync to complete

2. Connect Device or Emulator

   • Physical Device: Enable USB debugging in Developer Options
   • Emulator: Create an AVD with Android 8.0+ (API 26+)

3. Run the App

   • Click the green ▶️ (Run) button
   • Select your device/emulator
   • Wait for build and install

Build Variants

Debug Build (Development)

./gradlew assembleDebug
# Output: app/build/outputs/apk/debug/app-debug.apk

Features:

• WebView debugging enabled
• No code obfuscation
• Faster build times
• Debug logging

Release Build (Production)

./gradlew assembleRelease
# Output: app/build/outputs/apk/release/app-release.apk

Features:

• Code obfuscation (ProGuard)
• Optimized APK size
• Production-ready

Gradle Tasks

# Clean build files
./gradlew clean

# Build both debug and release
./gradlew assemble

# Run unit tests
./gradlew test

# Generate test coverage report
./gradlew jacocoTestReport

# Lint check
./gradlew lint

# List all tasks
./gradlew tasks

Android Bundle (AAB)

For Google Play Store submission:

./gradlew bundleRelease
# Output: app/build/outputs/bundle/release/app-release.aab

Troubleshooting

Gradle Sync Failed

1. Check internet connection
2. Update Android Studio
3. Invalidate caches: File → Invalidate Caches / Restart

Build Failed

1. Clean project: ./gradlew clean
2. Check JDK version (must be JDK 17)
3. Update Android SDK via SDK Manager

Device Not Detected

1. Enable USB debugging on device
2. Install device drivers (Windows)
3. Check adb devices command
4. Try different USB cable/port

Out of Memory

Increase Gradle memory in gradle.properties:

org.gradle.jvmargs=-Xmx4096m

Requirements Checklist

• ✅ Android Studio Ladybug (2024.2.1+)
• ✅ JDK 17 or later
• ✅ Android SDK 35 (via SDK Manager)
• ✅ Build Tools 34.0.0+
• ✅ Kotlin 2.1.0+
• ✅ Gradle 8.7+

First Build

The first build will take longer as Gradle downloads dependencies:

• Jetpack Compose libraries (~150MB)
• Material Design 3 components
• Room database libraries
• Kotlin coroutines
• WebView libraries

Subsequent builds are much faster due to caching.

CI/CD with TeamCity

This project can integrate with your TeamCity instance:

TeamCity URL: https://cis1.silverlabs.uk Access Token: (See ~/.claude/CLAUDE.md)

Build configuration:

project {
    buildType {
        name = "SilverDROID"
        vcs {
            root(GitLabVcs)
        }
        steps {
            gradle {
                tasks = "clean assembleRelease"
                gradleWrapperPath = ""
            }
        }
    }
}

---

Need help? Check the main README.md or open an issue on GitLab.