Python Aim App - Flutter VPN & Proxy Manager

Prerequisites (PC Setup)

1. Install Flutter SDK (v3.2+)

   • Download from: https://docs.flutter.dev/get-started/install
   • Or use: git clone https://github.com/flutter/flutter.git -b stable

2. Install Android Studio (or just Android SDK command line tools)

   • Download Android Studio: https://developer.android.com/studio

3. Set up Android SDK

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

4. Accept licenses

   flutter doctor --android-licenses

Step 1: Get the Project Files

Option A: Via ADB (if connected to PC via USB)

On your Android device (Termux):

cd $HOME
tar -czf python_aim_app.tar.gz python_aim_app/

Then on your PC:

adb pull /sdcard/python_aim_app.tar.gz ~/Desktop/
cd ~/Desktop/
tar -xzf python_aim_app.tar.gz

Option B: Via HTTP Server (no USB)

On your Android device (Termux):

cd $HOME
tar -czf python_aim_app.tar.gz python_aim_app/
python3 -m http.server 8080

Then on PC browser, go to: http://<phone-ip>:8080/python_aim_app.tar.gz

Option C: Via Cloud Storage

Upload to Google Drive / Dropbox from your phone's file manager, then download on PC.

Step 2: Project Setup on PC

# Navigate to project
cd python_aim_app/

# Check Flutter setup
flutter doctor

# Get dependencies
flutter pub get

# Generate code (if needed)
# dart run build_runner build

Step 3: Firebase Setup (Required)

1. Go to https://console.firebase.google.com/
2. Create a new project (or use existing)
3. Add Android app with package name: com.pythonaim.app
4. Download google-services.json
5. Place it in: android/app/google-services.json

Step 4: Build the APK

# Debug APK (for testing)
flutter build apk --debug

# Release APK (for distribution)
flutter build apk --release

# Split APKs per architecture (smaller file size)
flutter build apk --split-per-abi

# App Bundle (recommended for Play Store)
flutter build appbundle

Step 5: Install & Test

# Install on connected device
flutter install

# Or manually copy the APK:
# build/app/outputs/flutter-apk/app-release.apk

Build Output Locations

Build Type	Output Path
Debug APK	build/app/outputs/flutter-apk/app-debug.apk
Release APK	build/app/outputs/flutter-apk/app-release.apk
ARM64 APK	build/app/outputs/flutter-apk/app-arm64-v8a-release.apk
App Bundle	build/app/outputs/bundle/release/app-release.aab

Troubleshooting

Issue: "Missing google-services.json" → Create Firebase project and add the config file

Issue: "SDK location not found" → Create android/local.properties with:

sdk.dir=/path/to/android-sdk
flutter.sdk=/path/to/flutter

Issue: "Gradle build failed" → Update Gradle: cd android && ./gradlew wrapper --gradle-version 8.3

Issue: Too many permissions warning → This is normal for Python Aim - the app needs extensive permissions for full functionality

Quick Build Script

Save this as build.sh and run:

#!/bin/bash
flutter pub get
flutter build apk --split-per-abi --release
echo "Build complete! APKs in build/app/outputs/flutter-apk/"

---

Need help? Run flutter doctor -v to diagnose any setup issues.