🚀 Share My APK #

The Ultimate Flutter APK Build & Upload Automation Tool

Stop the build-and-drag-drop dance! 💃 Your mouse deserves a break.

From code to shareable link in one command ⚡

Automate your Flutter Android APK builds and uploads with the power of magic (and some really good code)

🎯 Why Share My APK? #

😩 Before Share My APK #

• Manual flutter build apk commands
• Drag & drop APKs to upload sites
• Manually manage file names and versions
• Deal with upload failures and size limits
• Remember different tokens for different services
• Copy-paste download links manually

🚀 After Share My APK #

• One command builds and uploads
• Automatic FVM detection and Flutter commands
• Comprehensive build pipeline (clean, pub get, gen-l10n)
• Fully automated - no manual confirmations needed
• Smart file naming with versions
• Robust error handling and retries
• Unified configuration management
• Instant shareable links

✨ What Makes It Special? #

🎉 What's New in v1.0.0? #

🚀 Production Ready - First Stable Release!

✨ Key Improvements #

✅ Production Ready - Upgraded from beta to stable 1.0.0 release after comprehensive testing
✅ Zero Issues - Passed all quality checks with 100+ tests and complete validation
✅ Comprehensive Documentation - Complete API docs, examples, and guides
✅ Enterprise-Grade Quality - Rock-solid reliability for production workflows
✅ Full Pub.dev Compliance - Maximum scoring and best practices

 [32mℹ️ [12:55:55] 🚀 Starting comprehensive APK build (mode: release)... [0m
 [32mℹ️ [12:55:55] Using Flutter command: fvm flutter [0m
 [32mℹ️ [12:55:55] 🧹 [1/4] Cleaning project... [0m
 [32mℹ️ [12:55:58] 📦 [2/4] Getting dependencies... [0m
 [32mℹ️ [12:56:02] 🌍 [3/4] Generating localizations... [0m
 [32mℹ️ [12:56:04] 🔨 [4/4] Building APK (release mode)... [0m
 [36m✨ [12:56:15] Build output: ✓ Built build/app/outputs/flutter-apk/app-release.apk (55.1MB) [0m
 [32mℹ️ [12:56:15] ✅ APK built successfully: ./build/app/outputs/flutter-apk/app-release.apk [0m
 [32mℹ️ [12:56:15] Uploading APK... [0m
 [32mℹ️ [12:56:15] File: ./moonnote_1.0.1+a2_2025_07_09_12_55_55.apk [0m
 [32mℹ️ [12:56:15] Size: 55.10 MB [0m
 [32mℹ️ [12:56:15] Provider: diawi [0m
 [32mℹ️ [12:56:25] Upload successful: https://i.diawi.com/SzSiZc [0m
 [32m╔═════════════════════╗ [0m
 [32m║ APK successfully uploaded to diawi!                                    ║ [0m
 [32m║ Download link: https://i.diawi.com/SzSiZc                              ║ [0m
 [32m╚═════════════════════╝ [0m

🎯 Interactive Mode (NEW!) #

✨ Never Remember Tokens Again!

Share My APK now features interactive provider selection - just run the command and choose your upload method!

$ share_my_apk

# ... APK builds ...

📤 How would you like to distribute your APK?
  → 1. Diawi - Quick team sharing (70MB limit, 30-day expiry)
    2. Gofile - Large files (no size limit, permanent links)
    3. Firebase App Distribution - Enterprise distribution with tester management
    4. Skip upload - Just build the APK

Select option (1-4) [1]: 3

# Interactive Firebase setup wizard appears!
🔑 Firebase Project ID: my-project
📱 Firebase App ID: 1:123:android:abc
...

🎯 Features:

• Smart Detection - Automatically skips prompts if already configured
• Full Firebase Wizard - Collects all Firebase settings interactively
• Save Configuration - Optional config save for future use
• Non-Interactive Mode - Use --no-interactive for CI/CD

Usage #

This section provides a quick overview of how to use share_my_apk. For more detailed examples, refer to the Usage Examples section.

⚡ Quick Start #

1️⃣ Install #

dart pub global activate share_my_apk

2️⃣ Configure #

share_my_apk init

3️⃣ Build & Upload #

share_my_apk

4️⃣ Share #

Get instant download link! 🔗

Installation #

This section details how to install share_my_apk. For more options, refer to the Installation Options section.

🌍 Global Installation #

dart pub global activate share_my_apk

Perfect for CLI usage across all projects

📦 Project Dependency #

dev_dependencies:
  share_my_apk: ^1.0.0

Perfect for team projects and CI/CD pipelines

Examples #

🔧 Basic Usage #

# Initialize configuration (one-time setup)
share_my_apk init

# Build and upload with default settings
share_my_apk

# Use specific provider
share_my_apk --provider gofile
share_my_apk --provider firebase

# Custom naming and environment
share_my_apk --name MyApp_Beta --environment staging

# Debug build
share_my_apk --no-release

# Skip build pipeline steps (for faster builds)
share_my_apk --no-clean --no-pub-get

⚙️ Advanced Configuration #

Create share_my_apk.yaml in your project root:

# Provider settings
provider: diawi

# API tokens
diawi_token: your_diawi_token_here
gofile_token: your_gofile_token_here

# Firebase App Distribution (for enterprise distribution)
firebase_project_id: your-firebase-project
firebase_app_id: 1:123456789:android:abcdef
firebase_service_account_path: /path/to/service-account.json
firebase_release_notes: "New beta release with bug fixes"
firebase_testers: tester1@example.com,tester2@example.com
firebase_groups: internal-team,beta-testers

# Build settings
release: true
path: .

# Build pipeline controls
clean: true          # Run flutter clean
pub-get: true        # Run flutter pub get
gen-l10n: true       # Generate localizations

# File organization
name: MyApp_Production
environment: prod
output-dir: build/releases

🔬 Library Usage #

import 'package:share_my_apk/share_my_apk.dart';

void main() async {
  // Build APK with comprehensive pipeline
  final buildService = FlutterBuildService();
  final apkPath = await buildService.build(
    release: true,
    customName: 'MyApp_Beta',
    environment: 'staging',
    clean: true,           // Run flutter clean
    getPubDeps: true,      // Run flutter pub get
    generateL10n: true,    // Generate localizations
  );

  // Upload to cloud
  final uploader = UploadServiceFactory.create('gofile');
  final downloadLink = await uploader.upload(apkPath);
  
  print('🚀 Download link: $downloadLink');
}

🎯 Command Reference #

💡 Pro Tip: Share My APK automatically switches from Diawi to Gofile for files >70MB!

🔥 Firebase App Distribution Integration #

Enterprise-grade app distribution with professional tester management!

Firebase App Distribution is perfect for:

• 🏢 Enterprise teams with organized release management
• 👥 Beta testing programs with specific user groups
• 🔒 Secure distribution with access controls
• 📊 Release analytics and crash reporting integration
• 🚀 CI/CD pipelines with automated distribution

🚀 Quick Firebase Setup #

1️⃣ Get Your Firebase Configuration

1. Go to Firebase Console
2. Select your project (or create a new one)
3. Add an Android app if you don't have one (Web apps are NOT supported)
4. Go to Project Settings → General
5. Find your Android app and copy:
   • Project ID: your-firebase-project
   • App ID: 1:123456789:android:abcdef (NOT web app ID!)

⚠️ Important: Firebase App Distribution only works with Android apps, not web apps. Make sure you're using an Android app ID in the format 1:123456789:android:abcdef.

2️⃣ Install Firebase CLI (Required)

Firebase App Distribution requires the Firebase CLI to be installed:

# Install Node.js first (if not already installed)
# Download from: https://nodejs.org/

# Install Firebase CLI globally
npm install -g firebase-tools

# Verify installation
firebase --version

3️⃣ Set Up Authentication (Choose one method)

share_my_apk --provider firebase \
  --firebase-project-id your-project \
  --firebase-app-id 1:123456789:android:abcdef \
  --firebase-service-account /path/to/service-account.json

firebase login

share_my_apk --provider firebase \
  --firebase-project-id your-project \
  --firebase-app-id 1:123456789:android:abcdef

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"

share_my_apk --provider firebase \
  --firebase-project-id your-project \
  --firebase-app-id 1:123456789:android:abcdef

4️⃣ Upload Your First APK

# Basic Firebase upload
share_my_apk --provider firebase \
  --firebase-project-id your-project \
  --firebase-app-id 1:123456789:android:abcdef

# With tester distribution
share_my_apk --provider firebase \
  --firebase-project-id your-project \
  --firebase-app-id 1:123456789:android:abcdef \
  --firebase-testers "tester1@company.com,tester2@company.com" \
  --firebase-groups "internal-team,beta-users" \
  --firebase-notes "New beta build with performance improvements"

📋 Firebase Configuration Examples #

Configuration File Setup (Recommended)

Create share_my_apk.yaml:

# Use Firebase as default provider
provider: firebase

# Firebase App Distribution configuration
firebase_project_id: your-firebase-project
firebase_app_id: 1:123456789:android:abcdef
firebase_service_account_path: /path/to/service-account.json
firebase_release_notes: "Weekly beta release - see changelog for details"
firebase_testers: 
  - dev-team@company.com
  - qa-team@company.com
  - beta-users@company.com
firebase_groups:
  - internal-team
  - beta-testers
  - stakeholders

# Standard build settings
release: true
clean: true
name: MyApp_Firebase
environment: firebase-dist

Then simply run:

share_my_apk  # Uses Firebase configuration

Environment Variables (Great for CI/CD)

# Set Firebase credentials
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
export FIREBASE_PROJECT_ID="your-firebase-project"
export FIREBASE_APP_ID="1:123456789:android:abcdef"

# Optional: Set testers and groups
export FIREBASE_TESTERS="team@company.com,beta@company.com"
export FIREBASE_GROUPS="internal,beta-users"

# Build and distribute
share_my_apk --provider firebase

Command Line (Quick one-offs)

# Full command with all options
share_my_apk \
  --provider firebase \
  --firebase-project-id your-project \
  --firebase-app-id 1:123456789:android:abcdef \
  --firebase-service-account ./firebase-key.json \
  --firebase-notes "Hotfix release v1.2.1" \
  --firebase-testers "urgent-testers@company.com" \
  --firebase-groups "priority-users" \
  --name HotfixBuild \
  --environment urgent

🎯 Firebase Provider Benefits #

🛠️ Provider Comparison #

🚀 Fully Automated Workflow #

Share My APK now provides a completely automated experience, perfect for CI/CD pipelines and production workflows.

🧹 [1/4] Cleaning project...
📦 [2/4] Getting dependencies...
🌍 [3/4] Generating localizations...
🔨 [4/4] Building APK (release mode)...
ℹ️ [12:56:05] Uploading APK...
ℹ️ [12:56:05] File: /path/to/your/app.apk
ℹ️ [12:56:05] Size: 55.10 MB
ℹ️ [12:56:05] Provider: diawi

🛡️ Reliability & Quality #

Share My APK is production-ready and thoroughly tested to ensure it works reliably in real-world scenarios.

✅ What We've Tested #

• ✅ Large File Uploads - Successfully tested with 113MB+ APKs
• ✅ Network Resilience - Handles connection issues gracefully
• ✅ Provider Switching - Automatic fallback works seamlessly
• ✅ Build Pipeline - Comprehensive testing with FVM, clean builds, dependencies
• ✅ Edge Cases - Handles special characters, long paths, and more
• ✅ Cross-Platform - Works on Windows, macOS, and Linux
• ✅ CI/CD Ready - Fully automated for production deployments

Ready for your production workflow! 🚀

📁 File Organization Magic #

Share My APK keeps your builds organized with smart naming:

output-directory/
├── environment/                    # Optional environment folder
│   ├── MyApp_1.0.0_2025_07_09_14_30_45.apk
│   ├── MyApp_1.0.1_2025_07_09_15_15_30.apk
│   └── ...
├── staging/
│   ├── MyApp_Beta_1.0.0_2025_07_09_12_00_00.apk
│   └── ...
└── prod/
    ├── MyApp_Production_1.0.0_2025_07_09_16_45_30.apk
    └── ...

Naming Pattern: {name}_{version}_{timestamp}.apk

📚 Need More Info? #

🎉 Ready to Get Started? #

dart pub global activate share_my_apk
share_my_apk init
share_my_apk

That's it! You're now sharing APKs like a pro! 🎯

💬 Need Help? #

• 📖 Read the docs
• 🐛 Report issues
• 💡 Request features
• ⭐ Star on GitHub

Made with ❤️ for the Flutter community

Because sharing should be simple, not a chore ✨