Update Checker Bottom Sheet

A simple and customizable Flutter package to check for app updates via GitHub Releases. It provides a beautiful, user-friendly bottom sheet that handles version comparison, OTA downloading, and installation on Android.

📌 Index

Screenshots
Features
Installation
Android Setup
Usage
Customization
GitHub Release Best Practices (Important)
Note on Versioning (Important)
License

📸 Screenshots

Update Available	Downloading	Installing

📱 Supported Platforms

✅ Android
❌ iOS
❌ Web
❌ macOS
❌ Windows
❌ Linux

Currently, this package is designed exclusively for Android.

The underlying OTA (Over-The-Air) engine utilizes Android's FileProvider and Package Installer to handle APK downloads and installation. Support for other platforms (iOS, Windows, etc.) is not planned for the immediate future due to the specific requirements of OTA distribution on those systems.

✨ Features

Android Native Support: Built specifically for Android with 100% compatibility for current build systems.
OTA Updates: Handles the full lifecycle—fetching, downloading, and triggering the Android Package Installer.
GitHub Integration: Automatically parses latest release tags, changelogs, and APK assets.
Architecture Awareness: Intelligently detects device ABI (arm64-v8a, armeabi-v7a, x86_64) and selects the matching APK.
"Up to Date" Notification: Optionally show a success UI if no update is found.

📦 Installation

Add this package to your pubspec.yaml via pub.dev:

dependencies:
  update_checker_bottom_sheet: ^0.0.3

Or install it directly from GitHub:

dependencies:
  update_checker_bottom_sheet:
    git:
      url: https://github.com/jydv402/update_checker_bottom_sheet.git

🛠️ Android Setup

This package is designed for maximum simplicity. The only manual requirement is enabling Core Library Desugaring.

1. Enable Desugaring

The underlying OTA engine requires desugaring to support older Android versions.

android/app/build.gradle (or build.gradle.kts):

android {
    compileOptions {
        isCoreLibraryDesugaringEnabled = true
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
}

dependencies {
    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.4")
}

2. Permissions

The package automatically bundles the necessary permissions:

INTERNET
REQUEST_INSTALL_PACKAGES
READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE

📖 Usage

Simple Check

Automatically checks GitHub and shows the sheet only if an update is found.

import 'package:update_checker_bottom_sheet/update_checker_bottom_sheet.dart';

void _checkForUpdates() async {
  await UpdateCheckerBottomSheet.checkAndUpdate(
    context,
    config: const UpdateCheckerConfig(
      githubRepo: "username/repo", // e.g. "jydv402/memno"
    ),
  );
}

Force "Up to Date" UI

Useful for "Check for Updates" buttons in a Settings menu.

await UpdateCheckerBottomSheet.checkAndUpdate(
  context,
  showIfUpToDate: true, // Shows "You are using the latest version" if no update
  config: const UpdateCheckerConfig(githubRepo: "username/repo"),
);

⚠️ Important: Cleaning Up Old APK Files

The checkAndUpdate function automatically cleans up old APK files from previous downloads to save storage space on the user's device. This ensures a smooth user experience without cluttering the device with temporary files.

👉 View the Sample Implementation

🎨 Customization

We believe in deep customization. You can control every pixel, color, and string used in the bottom sheet.

👉 View the Full Customization Guide

🤖 GitHub Release Best Practices (IMPORTANT)

Important

To ensure the package correctly identifies and downloads your APKs, follow these guidelines when creating a GitHub Release:

ABI Naming: The package looks for ABI names in the asset filenames. If your release has multiple APKs, name them like so:
- app-arm64-v8a-release.apk
- app-armeabi-v7a-release.apk
- app-x86_64-release.apk
Split per ABI: Use flutter build apk --split-per-abi to generate these files automatically.
Fallback Support: If no ABI-specific match is found, the package will fallback to assets named universal.apk or app-release.apk.
Changelog: The text in the GitHub Release "Description" field is automatically pulled and displayed as the "What's New" content.

📝 Note on Versioning (IMPORTANT)