xtremobile/BUILD_GUIDE.md

🔨 BUILD GUIDE - XtreMobile

Application: XtreMobile IPTV Target Platform: Android (ARM64) Build Type: Release APK Status: Ready to build

---

📋 PREREQUISITES

Required

• Flutter SDK 3.0.0+ (Install)
• Android SDK with API 30+ (usually bundled with Flutter)
• Java JDK 11+ (required by Android SDK)
• Git (for version control)

Optional

• Android Device (for testing)
• Android Emulator

---

🚀 BUILD STEPS

Option 1: Using Build Script (Recommended)

# Make script executable
chmod +x build.sh

# Run build
./build.sh

Option 2: Manual Build

# 1. Clean previous builds
flutter clean

# 2. Get dependencies
flutter pub get

# 3. Generate code (if needed)
flutter pub run build_runner build --delete-conflicting-outputs

# 4. Build release APK
flutter build apk --release \
  --target-platform android-arm64 \
  --split-per-abi

Option 3: Using IDE

Android Studio / VS Code:
1. Open project in IDE
2. Run → Flutter Build → Build APK (Release)

---

📊 BUILD OUTPUT

Successful build produces APK at:

build/app/outputs/flutter-apk/app-release.apk

File size: ~50-80 MB (after optimizations)

---

🔧 SETUP FLUTTER (if not installed)

macOS

# Using Homebrew
brew install flutter

# Or download manually
git clone https://github.com/flutter/flutter.git -b stable

# Add to PATH
export PATH="$PATH:$HOME/flutter/bin"

Linux

# Download Flutter
git clone https://github.com/flutter/flutter.git -b stable ~/flutter

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$PATH:$HOME/flutter/bin"

# Verify
flutter doctor

Windows

# Download from https://flutter.dev/docs/get-started/install/windows
# Or use scoop:
scoop install flutter

# Add to PATH in Environment Variables

Verify Installation

flutter doctor -v

Should show:

✓ Flutter (Channel stable)
✓ Android toolchain
✓ Android SDK
✓ Java version

---

📱 INSTALL ON DEVICE

Connect Device

# List connected devices
adb devices

# Or use Flutter
flutter devices

Install APK

# Method 1: Using adb
adb install -r build/app/outputs/flutter-apk/app-release.apk

# Method 2: Using Flutter
flutter install --release

# Method 3: Drag to device (if file manager available)
open build/app/outputs/flutter-apk/
# Then drag app-release.apk to Android device

---

🧪 VERIFY BUILD

Check APK Size

ls -lh build/app/outputs/flutter-apk/app-release.apk

Verify with aapt (Android Asset Packaging Tool)

aapt dump badging build/app/outputs/flutter-apk/app-release.apk

Test Installation

1. Install APK on device
2. Launch app
3. Verify:
   • No crashes on startup
   • Smooth navigation
   • Video playback works
   • All tabs load correctly

---

🐛 TROUBLESHOOTING

"Flutter not found"

# Add to PATH
export PATH="$PATH:$HOME/flutter/bin"

# Or specify full path
/path/to/flutter/bin/flutter build apk --release

"Android SDK not found"

flutter config --android-sdk /path/to/android-sdk
flutter doctor

"Gradle build failed"

# Clean and retry
flutter clean
flutter pub get
flutter build apk --release

"Java version error"

# Check Java version
java -version

# Should be 11 or higher
# If not, install Java 11 JDK

"Out of memory during build"

# Increase Gradle memory
export _JAVA_OPTIONS="-Xmx4g"
flutter build apk --release

"Dependency resolution failed"

# Clear pub cache
flutter pub cache clean

# Update pubspec
flutter pub upgrade

# Rebuild
flutter pub get
flutter build apk --release

---

📊 BUILD CONFIGURATION

Current Configuration

name: xtremflow
version: 1.5.1+11
minSdk: 30
targetSdk: 34

Optimizations Applied

✅ APK split by ABI (smaller downloads)
✅ Release mode (optimized, no debug symbols)
✅ ARM64 architecture (most common Android devices)
✅ Minified Dart code
✅ Tree-shaking unused code

Expected Results:

• Build size: 50-80 MB
• Installation time: <1 minute
• Startup time: 3-5 seconds (cold)
• Memory: 400-500 MB peak

---

🎯 NEXT STEPS AFTER BUILD

1. Install on Device

   adb install -r build/app/outputs/flutter-apk/app-release.apk
   

2. Test Performance

   • Measure startup time
   • Test tab switching
   • Play sample stream
   • Monitor memory usage

3. Validate Optimizations

   • Cold startup should be 3-5s
   • Tab switching should be instant
   • No crashes
   • Smooth playback

4. Distribute

   • Upload to Play Store
   • Share via Google Drive
   • Use internal testing

---

📦 BUILD VARIANTS

Debug Build (for testing)

flutter build apk --debug
# Much faster build, can debug on device
# Not for release

Release Build (for production)

flutter build apk --release
# Optimized, minified, tree-shaken
# Ready for Play Store

App Bundle (for Play Store)

flutter build appbundle --release
# Smaller downloads per device
# Recommended for Play Store

---

✅ BUILD CHECKLIST

• Flutter SDK installed (3.0.0+)
• Android SDK with API 30+
• Java JDK 11+
• All dependencies resolved (flutter pub get)
• Code compiles without errors
• Tests pass (if applicable)
• APK builds successfully
• APK installs on device
• App launches without crashes
• All optimizations working

---

📞 SUPPORT

If you encounter build issues:

1. Check Flutter Doctor

   flutter doctor -v
   

2. Check Android SDK

   flutter config --show-config
   

3. Check Gradle

   cd android && ./gradlew --version
   

4. Review build output

   flutter build apk --release -v 2>&1 | tail -50
   

---

Last Updated: March 25, 2026 Status: ✅ Ready to Build