auto_launcher 0.0.2

A Flutter utility to automatically update the app's name, version, bundle identifiers, and app's icon across Android and iOS platforms.

✨ Auto Launcher

A command-line utility to automate updates to your Flutter app's name, version, bundle identifiers, and launcher icon. Designed for use in manual setups or CI/CD pipelines, this tool removes the repetitive overhead of configuring these values across Android and iOS projects.

---

🚀 Getting Started

Add auto_launcher as a dependency in your Flutter project’s pubspec.yaml:

dependencies:
  auto_launcher: ^0.0.1


Install dependencies:

```bash
flutter pub get

---

✅ 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.

---

🛠 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