easy_app_changer 1.0.0

A Flutter package to easily change app name and icon with one command.

🧩 easy_app_changer

A Flutter package that helps developers change the app name and icon easily with simple commands.
No more manually editing AndroidManifest.xml or Info.plist — just one command and you're done!

---

🚀 Features

• ✅ Change app display name for both Android and iOS
• ✅ Change app launcher icon automatically (coming soon)
• ✅ Change package/bundle ID (coming soon)
• ⚙️ CLI-based usage — easy to use in any Flutter project

---

📦 Installation

Add the package to your pubspec.yaml:

flutter:
    sdk: flutter
dependencies:
  easy_app_changer: ^1.0.0

Then run:
flutter pub get

🚀 Usage

You can run the commands directly from your Flutter project root. 📝 Change App Name ("My Awesome App" = YouName App)

dart run easy_app_changer set-name "My Awesome App"

This will automatically:

• Update the Android app name in android/app/src/main/AndroidManifest.xml

• Update the iOS app name in ios/Runner/Info.plist

Example Result:

<!-- AndroidManifest.xml -->
<application
    android:name="${applicationName}"
    android:label="My Awesome App"
    android:icon="@mipmap/ic_launcher">
</application>

🖼️ Change App Icon (coming soon)

dart run easy_app_changer set-icon assets/app_icon.png

This will automatically generate and update app icons for:

• Android (mipmap directories)
• iOS (AppIcon assets)

📦 Change Package Name (coming soon)

dart run easy_app_changer set-package com.example.myapp

This will update:

• applicationId in android/app/build.gradle
• bundle identifier in iOS project settings

💡 Example (optional usage in code)

If you want to call it programmatically from Dart code (for example in example/main.dart):

import 'package:easy_app_changer/easy_app_changer.dart';

void main() {
  EasyAppChanger.setAppName("My Flutter App");
  EasyAppChanger.setAppIcon("assets/icon.png");
  EasyAppChanger.setPackage("com.example.myapp");
}

❓ Do I need to import it in my app?

❌ No, you don’t need to import it into your Flutter app files unless you specifically want to call it via Dart code (like in the example above).

Normally, you just run the CLI command in your terminal:

dart run easy_app_changer set-name "MyApp"
dart run easy_app_changer set-icon assets/app_icon.png

That’s it! It directly edits configuration files like AndroidManifest.xml and Info.plist — so your app’s name and icon are updated automatically without touching your Flutter source code.

⚙️ Notes

• Run commands from your Flutter project root
• After any change, rebuild your app:

flutter clean
flutter run

💻 CLI Commands Summary

• Command Description

dart run easy_app_changer set-name "New Name"	

Change app display name

dart run easy_app_changer set-icon assets/icon.png

Change launcher icon (coming soon)

dart run easy_app_changer set-package com.example.myapp

Change package/bundle ID (coming soon)

---

🧩 easy_app_changer 🇹🇭✨

แพ็กเกจ Flutter ที่ให้สามารถ เปลี่ยนชื่อแอปและรูปไอคอน ได้ง่าย
โดยไม่ต้องเข้าไปแก้ไฟล์ AndroidManifest.xml หรือ Info.plist ให้ยุ่งยาก เพียงคำสั่งเดียวก็สามารถเปลี่ยนชื่อแอปได้ทันที! 🎯 แต่ต้องใส่ใน Terminal นะพี่ๆ

🚀 ฟีเจอร์หลัก

• ✅ เปลี่ยน ชื่อแอป (App Name) ได้ทั้ง Android และ iOS
• ✅ เปลี่ยน ไอคอนแอป (App Icon) อัตโนมัติ (อยู่ในระหว่างพัฒนา)
• ✅ เปลี่ยน Package / Bundle ID (อยู่ในระหว่างพัฒนา)
• ⚙️ ใช้งานผ่าน Command Line (CLI) ใช้งานง่ายในทุกโปรเจกต์ Flutter

---

📦 การติดตั้ง (Installation)

เพิ่มแพ็กเกจนี้ลงในไฟล์ pubspec.yaml ของคุณ:

flutter:
    sdk: flutter
dependencies:
  easy_app_changer: ^1.0.0

Then run:
flutter pub get

🚀 การใช้งาน (Usage)

สามารถรันคำสั่งเหล่านี้ได้จาก โฟลเดอร์หลักของโปรเจกต์ Flutter ของคุณโดยตรง 📝 เปลี่ยนชื่อแอป

dart run easy_app_changer set-name "เอาชื่ออะไรก็ใส่ในนี้นะครับ"

คำสั่งนี้จะทำการแก้ไขให้อัตโนมัติ:

• ในฝั่ง Android: แก้ไขค่า android:label ภายในไฟล์ android/app/src/main/AndroidManifest.xml

• ในฝั่ง iOS: แก้ไขหรือเพิ่มค่า ในไฟล์ ios/Runner/Info.plist

🔍 ตัวอย่างผลลัพธ์:

<!-- AndroidManifest.xml -->
<application
    android:name="${applicationName}"
    android:label="เอาชื่ออะไรก็ใส่ในนี้นะครับ"
    android:icon="@mipmap/ic_launcher">
</application>

🖼️ เปลี่ยนรูปไอคอนแอป (Coming Soon)

dart run easy_app_changer set-icon assets/app_icon.png

ระบบจะสามารถอัปเดตรูปไอคอนให้อัตโนมัติในอนาคต แต่ตอนนี้ยังนะ:

• Android (mipmap directories)
• iOS (AppIcon assets)

📦 เปลี่ยน Package Name (Coming Soon)

dart run easy_app_changer set-package com.example.myapp

คำสั่งนี้จะทำการแก้ไข:

• ค่า applicationId ใน android/app/build.gradle
• ค่า bundle identifier ใน iOS project settings

💡 ตัวอย่าง (การใช้งานผ่านโค้ด)

ถ้่าอยากลองใช้ผ่านหน้าโค้ดเพื่ออะไรไม่รู้นะเผื่ออยากลอง (เช่นในไฟล์ example/main.dart):

import 'package:easy_app_changer/easy_app_changer.dart';
void main() {
  EasyAppChanger.setAppName("My Flutter App");
  EasyAppChanger.setAppIcon("assets/icon.png");
  EasyAppChanger.setPackage("com.example.myapp");
}

❓ จำเป็นต้อง import เข้าไฟล์อื่น ๆ ไหม?

❌ ไม่จำเป็นต้อง import เข้าไฟล์ในแอป เว้นแต่คุณต้องการเรียกใช้งานผ่านโค้ด Dart เอง (เช่นตัวอย่างข้างต้น) โดยทั่วไปแล้ว ให้คุณเพียงแค่รันคำสั่งใน Terminal เช่นนี้:

dart run easy_app_changer set-name "MyApp"
dart run easy_app_changer set-icon assets/app_icon.png

เพียงเท่านี้ระบบจะทำการแก้ไขไฟล์ตั้งค่าของ Android และ iOS ให้อัตโนมัติ โดยไม่ต้องแก้ไขโค้ดในโปรเจกต์ Flutter ✅

⚙️ หมายเหตุสำคัญ

• ให้รันคำสั่งจาก โฟลเดอร์หลักของโปรเจกต์ Flutter เท่านั้น
• หลังจากเปลี่ยนชื่อหรือไอคอนแล้ว แนะนำให้รันคำสั่ง:

flutter clean
flutter run

• การเปลี่ยนแปลงทั้งหมดนี้จะมีผลเฉพาะใน ไฟล์ภายในโปรเจกต์ของคุณ หากต้องการให้ชื่อหรือไอคอนใน Play Store / App Store เปลี่ยนด้วย ต้องทำการ build และอัปโหลดเวอร์ชันใหม่ขึ้น Store อีกครั้ง

💻 สรุปคำสั่ง CLI ที่รองรับ

คำสั่ง คำอธิบาย

dart run easy_app_changer set-name "New Name"	

เปลี่ยนชื่อแอป

dart run easy_app_changer set-icon assets/app_icon.png

เปลี่ยนรูปไอคอน (อยู่ระหว่างพัฒนา)

dart run easy_app_changer set-package com.example.myapp

เปลี่ยน Package / Bundle ID (อยู่ระหว่างพัฒนา)