rename_app 1.6.6
rename_app: ^1.6.6 copied to clipboard
The flutter package which changes app name for all platforms with sound null safety!
Rename App #
The only flutter package which changes app name for all platforms with sound null safety! #
If you want to autmatically change your flutter app name with a single command then you are at the right pacakge. This package gives you too many flexibilities through too many variants of its commands. Read the details below to know in more details
- β Dont forget to star the github repo if you found this package useful π
Developer : Syed Waleed Shah ( LinkedIn Github StackOverflow )
Please Contribute : Github Repository
Honourable Contributors:
- Finn DrΓΌnert ( Github )
- nhan7777 ( Github )
- Harsh Yadav ( Github )
Features π₯ #
β Rename Android Project
β Rename IOS Project
β Rename WEB Project
β Rename Windows Project
β Rename Linux Project
What rename_app does #
rename_app is a command-line helper you run against a Flutter app project. From the project root (the folder where your appβs pubspec.yaml lives), it edits the platform files that expose the launcher / UI display name. For example: Android (AndroidManifest.xml label), iOS (Info.plist and variants when present), Web (manifest.json), Windows runner sources, and Linux application metadata.
It does not automatically change strings inside your Dart code (such as MaterialApp(title: β¦)): that stays up to you. For each platform, if the expected config file is missing or you pass an empty name for that platform, that platform is skipped and a short message may be logged.
Arguments like android="..." only update Android; omitting others leaves those platforms untouched. all="..." and config_name.name apply the same name across Android, iOS, Web, Windows, and Linux in one shot.
macOS renaming is currently not wired in the tool (mac CLI is listed for compatibility).
How To Rename ? π #
1) ADD THE PACKAGE TO YOUR pubspec.yaml
You only need the package to run dart run rename_app:main, so dev_dependency is typical for an app:
dart pub add rename_app --dev
Alternatively, add rename_app under dependencies: if your workflow prefers that.
2) PROVIDE THE APP NAME
Run commands from your Flutter project directory (pubspec.yaml must exist there). Names are arbitrary display strings β use quoting on the CLI when they contain spaces.
You can supply the app name in two complementary ways:
A β From pubspec.yaml (no CLI arguments)
Add a config_name block at the top level of pubspec.yaml (alongside name:, description:, etc.):
config_name:
name: "My App"
-
namemust be a string. Ifconfig_name.nameis present, running with zero arguments:dart run rename_app:mainis equivalent to
dart run rename_app:main all="My App"β same name for Android, iOS, Web, Windows, and Linux. -
pubspec.yamlmust parse as YAML. If the block is missing,nameis missing/wrong type, or reading the file fails, the tool prints the help message and exits (same as older versions withoutconfig_name). -
CLI always wins: as soon as you pass any argument (for example
all="..."orandroid="..."),config_nameis not used for that invocation.
B β From the CLI (explicit arguments)
Same name for all supported platforms:
Same name for all apps
dart run rename_app:main all="My App Name"
Separate name for specified platform(s) and same for all others
dart run rename_app:main android="Android Name" ios="IOS Name" others="Others Name"
Separate name for each platform
dart run rename_app:main android="Android Name" ios="IOS Name" web="Web Name" mac="Mac Name" windows="Windows Name" linux="Linux Name"
More Flexibilities π #
| REQUIREMENT | COMMAND |
|---|---|
| From pubspec | Add config_name.name, then dart run rename_app:main (no arguments) |
| All Same | dart run rename_app:main all="App Name" |
| Only Android | dart run rename_app:main android="Android App" |
| Only IOS | dart run rename_app:main ios="IOS App" |
| Only WEB | dart run rename_app:main web="Web App" |
| ONLY Windows | dart run rename_app:main windows="Windows App" |
| ONLY Linux | dart run rename_app:main linux="Linux App" |
| With Others | dart run rename_app:main android="Android App" ios="IOS App" others="Others App Name" |