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
163 lines
2.8 KiB
Markdown
163 lines
2.8 KiB
Markdown
# SilverDROID - Quick Reference Card
|
|
|
|
## 🚀 Push to GitLab (First Time)
|
|
|
|
```bash
|
|
# WSL/Linux
|
|
./push-to-gitlab.sh
|
|
|
|
# Windows PowerShell
|
|
.\push-to-gitlab.ps1
|
|
```
|
|
|
|
---
|
|
|
|
## 🏗️ Build Locally
|
|
|
|
```bash
|
|
# Debug APK
|
|
./gradlew assembleDebug
|
|
|
|
# Release APK
|
|
./gradlew assembleRelease
|
|
|
|
# Install on device
|
|
adb install app/build/outputs/apk/debug/app-debug.apk
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 GitLab URLs
|
|
|
|
**Project:** https://gitlab.silverlabs.uk/SilverLABS/silverdroid
|
|
|
|
**Pipelines:** https://gitlab.silverlabs.uk/SilverLABS/silverdroid/-/pipelines
|
|
|
|
**Jobs:** https://gitlab.silverlabs.uk/SilverLABS/silverdroid/-/jobs
|
|
|
|
**Latest Debug APK:**
|
|
```
|
|
https://gitlab.silverlabs.uk/SilverLABS/silverdroid/-/jobs/artifacts/main/raw/app/build/outputs/apk/debug/app-debug.apk?job=build:debug
|
|
```
|
|
|
|
---
|
|
|
|
## 📦 CI/CD Pipeline
|
|
|
|
**Trigger:** Push to any branch
|
|
|
|
**Stages:**
|
|
1. prepare (1 min) - Cache dependencies
|
|
2. test (2 min) - Lint + unit tests
|
|
3. build (3-5 min) - Build APKs
|
|
4. deploy (30 sec) - Store artifacts
|
|
|
|
**Total:** ~5-8 minutes
|
|
|
|
---
|
|
|
|
## 🎯 What the App Does
|
|
|
|
- Loads **https://admin.dark.side** on launch
|
|
- Full **WASM/PWA** support
|
|
- **Glassmorphism** UI theme
|
|
- Back button exits app
|
|
|
|
---
|
|
|
|
## 📱 App Info
|
|
|
|
**Package:** uk.silverlabs.silverdroid
|
|
**Name:** Dark Side Admin
|
|
**Min Android:** 8.0 (API 26)
|
|
**Target:** Android 15 (API 35)
|
|
|
|
---
|
|
|
|
## 🔑 GitLab Access
|
|
|
|
**URL:** https://gitlab.silverlabs.uk
|
|
**Token:** glpat-wqUcD7mg53F1mgM-N-PdiW86MQp1OjEH.01.0w074ox93
|
|
**SSH Port:** 2223
|
|
|
|
---
|
|
|
|
## 📚 Documentation
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| **README.md** | Full project docs |
|
|
| **DARK_SIDE_BUILD.md** | Custom build guide |
|
|
| **GITLAB_CICD_SETUP.md** | CI/CD setup |
|
|
| **CICD_SUMMARY.md** | Pipeline overview |
|
|
| **BUILD.md** | Build instructions |
|
|
| **QUICKSTART.md** | 5-min getting started |
|
|
|
|
---
|
|
|
|
## 🛠️ Key Files
|
|
|
|
```
|
|
MainActivity.kt - Loads admin.dark.side
|
|
WasmWebView.kt - WebView with WASM support
|
|
GlassComponents.kt - Glassmorphism UI
|
|
.gitlab-ci.yml - CI/CD pipeline
|
|
```
|
|
|
|
---
|
|
|
|
## ⚡ Quick Commands
|
|
|
|
```bash
|
|
# Build debug
|
|
./gradlew assembleDebug
|
|
|
|
# Run tests
|
|
./gradlew test
|
|
|
|
# Lint check
|
|
./gradlew lint
|
|
|
|
# Clean build
|
|
./gradlew clean build
|
|
|
|
# Install on device
|
|
./gradlew installDebug
|
|
```
|
|
|
|
---
|
|
|
|
## 🎨 Customize Target URL
|
|
|
|
Edit `MainActivity.kt` line 23:
|
|
```kotlin
|
|
private val targetUrl = "https://your-url-here"
|
|
```
|
|
|
|
---
|
|
|
|
## 🐛 Troubleshooting
|
|
|
|
**Can't build?**
|
|
- Open in Android Studio
|
|
- File → Sync Project with Gradle Files
|
|
|
|
**Pipeline not starting?**
|
|
- Check Runner: Settings → CI/CD → Runners
|
|
- Verify `.gitlab-ci.yml` exists
|
|
|
|
**APK won't install?**
|
|
- Enable "Unknown Sources" on device
|
|
- Settings → Security → Unknown Sources
|
|
|
|
---
|
|
|
|
## 📞 Support
|
|
|
|
**GitLab:** https://gitlab.silverlabs.uk
|
|
**TeamCity:** https://cis1.silverlabs.uk
|
|
**Knowledge:** ~/.claude/Knowledge/
|
|
|
|
---
|
|
|
|
**Next Step:** Run `./push-to-gitlab.sh` to get started! 🚀 |