auto_launcher 0.0.4

A Flutter utility to automatically update the app's name, version, bundle identifiers, and launcher icon for Android and iOS. Ideal for CI/CD pipelines.

✅ Final Reviewed Version With Suggestions Applied

🔧 Changes:

• Update heading What's New in v0.0.3 → What's New in v0.0.4
• Reflect more precise wording for the fixes (optional)

---

✨ Auto Launcher

Automate app name, version, bundle ID, and launcher icon updates across Android and iOS — ideal for CI/CD and manual workflows.

---

📦 What's New in v0.0.4

• 🎯 Fixed: App icon generation now works reliably on Android and iOS
• 🔄 Improved: Dependency compatibility by aligning image and archive versions

---

✅ Platform Support

Android	iOS	Windows	macOS	Web
✅	✅	❌	❌	❌

⚠️ This package supports Android and iOS only.

Windows, macOS, and Web platforms are not supported due to native platform dependencies.

---

🧰 Requirements

• Dart SDK: >=3.6.1 <4.0.0
• Flutter project targeting Android and/or iOS

---

🛠 Features

• 🔧 Update app name via native project files
• 📦 Automatically set version in pubspec.yaml and native files
• 🏷 Modify app bundle ID (package name) for Android and iOS
• 🖼 Swap out launcher icons for platform-specific formats
• 🤖 Suitable for integration into CI/CD pipelines

---

📘 Guide

1. Setup the config file

Define your launcher configuration inside pubspec.yaml:

auto_launcher:
  app_name:
    build: My App
    enable: true
  version:
    build: 1.0.0+1
    enable: true
  bundle_id:
    platforms:
      android:
        build: com.example.android
        enable: true
      ios:
        build: com.example.ios
        enable: true
  app_icon:
    image_path: "assets/icons/app_logo.png"
    platform:
      android: true
      ios: true

2. Run the package

Install dependencies and run the tool:

flutter pub get
dart run auto_launcher

---

🔤 Attributes

Key	Type	Description
app_name	Object	Set a new launcher name
version	Object	Define app version and build number
bundle_id	Object	Update package/bundle ID per platform
app_icon	Object	Replace launcher icons using a source image

app_name

Key	Type	Description
build	String	The new app name
enable	Bool	Whether to apply it

version

Key	Type	Description
build	String	e.g., 1.0.0+1
enable	Bool	Whether to apply it

bundle_id

Platform	Key	Type	Description
android	build	String	Android application ID
android	enable	Bool	Whether to update Android ID
ios	build	String	iOS bundle identifier
ios	enable	Bool	Whether to update iOS ID

app_icon

Key	Type	Description
image_path	String	Path to the icon image
platform	Object	Toggle icon update per platform

---

🧾 Example

auto_launcher:
  app_name:
    build: My App
    enable: true
  version:
    build: 1.0.0+1
    enable: true
  bundle_id:
    platforms:
      android:
        build: com.example.android
        enable: true
      ios:
        build: com.example.ios
        enable: true
  app_icon:
    image_path: "assets/icons/app_logo.png"
    platform:
      android: true
      ios: true

---

📦 GitHub Usage

To use the latest version directly from GitHub:

dependencies:
  auto_launcher:
    git:
      url: https://github.com/StartPackage/auto_launcher.git
      ref: main