otoddyota 1.0.0

Simple, drop-in Over-The-Air (OTA) code push client for Flutter applications with automatic engine patch detection.

OtoddyOTA (Flutter Package)

A drop-in over-the-air (OTA) code push client for Flutter applications. Allows you to deliver instant Dart bug fixes and UI updates to your users without going through app store review or re-installing APKs.

---

1. Installation

Add otoddyota to your pubspec.yaml:

dependencies:
  flutter:
    sdk: flutter
  otoddyota:
    path: path/to/packages/otoddyota
    # Or from git:
    # git:
    #   url: https://github.com/MohitMakhijani/otoddy_ota_inhouse.git
    #   path: packages/otoddyota

---

2. Usage in Dart

Initialize OtoddyOTA early in your main():

import 'package:flutter/material.dart';
import 'package:otoddyota/otoddyota.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  OtoddyOTA.init(
    serverUrls: [
      'https://codepush.yourdomain.com', // Production server / tunnel
      'http://10.0.2.2:8080',            // Android emulator local testing
      'http://localhost:8080',           // USB device (adb reverse tcp:8080 tcp:8080)
    ],
    appId: 'com.example.myapp',
    releaseVersion: '1.0.0', // Must match installed app release
    onPatchReady: (patchNumber) {
      debugPrint('Patch #$patchNumber is downloaded and ready for next launch!');
    },
  );

  runApp(const MyApp());
}

---

3. Android Setup (One-Time)

A. Add Internet Permission

In android/app/src/main/AndroidManifest.xml:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.INTERNET"/>
    <application
        android:usesCleartextTraffic="true" ...> <!-- Only needed if using plain HTTP in dev -->

B. Enable Hooked Engine in Gradle

In your root android/build.gradle.kts (or build.gradle):

// In build.gradle.kts
val localEngineMaven: String? = System.getenv("LOCAL_ENGINE_MAVEN")
allprojects {
    repositories {
        if (!localEngineMaven.isNullOrBlank()) {
            maven { url = java.io.File(localEngineMaven).toURI() }
        }
        google()
        mavenCentral()
    }
}

---

4. Shipping Your Baseline Build

Build your initial release APK or Play Store App Bundle with LOCAL_ENGINE_MAVEN active:

$env:LOCAL_ENGINE_MAVEN = "C:\path\to\inhouse-codepush\local-engine-maven"
flutter build apk --release
# or: flutter build appbundle --release

---

5. Pushing OTA Patches

When you make Dart changes (bug fixes, UI updates):

powershell -ExecutionPolicy Bypass -File path\to\tooling\push-patch.ps1 -TargetRelease 1.0.0 -Arch arm64

On next launch, your users will download and run the new patch automatically!