names_launcher 0.0.2

SDKdartflutter
Platformandroidioswindowslinuxmacosweb

A command-line tool that simplifies the task of updating your Flutter app's launcher name. Full flexibility allows you to only update the launcher name for specific platforms as needed.

✨ Names Launcher ✨

A command-line tool that simplifies the task of updating your Flutter app's launcher name. Full flexibility allows you to only update the launcher name for specific platforms as needed.

Platform Support

AndroidiOSMacOSWebLinuxWindows
✔️✔️✔️✔️✔️✔️

Guide

1. Setup the config file

Add your Names Launcher configuration to your pubspec.yaml or create a new config file called names_launcher.yaml.

Add config to pubspec.yaml or create a separate names_launcher.yaml

names_launcher:
  name: "Your App Name"
  platforms:
    android:
      enable: true
    ios:
      enable: true

Or set localized app names as below

names_launcher:
  name:
    default: "Your App Name"
    zh: "中文名"
  platforms:
    android:
      enable: true
    ios:
      enable: true

2. Run the package

After setting up the configuration, all that is left to do is run the package:

flutter pub get
dart run names_launcher:change

If you name your configuration file something other than names_launcher.yaml or pubspec.yaml you will need to specify the name of the file when running the package.

flutter pub get
dart run names_launcher:change --path <your config file name here>

NOTE: If you are not using the existing pubspec.yaml your config file must still be located in the same directory as it.

If you encounter any issues please report them here.

In the above configuration, the package is setup to change the existing launcher names in both the Android and iOS project.


Attributes

Shown below is the full list of attributes which you can specify within your Names Launcher configuration.

Names Launcher OptionTypeDefaultDescription
nameString/ObjectnullThe launcher name or localized names
platformsObjectnullUse for specific platform to change names

Platforms OptionTypeDefaultDescription
androidObjectnullUse for specific android platform
iosObjectnullUse for specific android platform
macosObjectnullUse for specific android platform
windowsObjectnullUse for specific android platform
webObjectnullUse for specific android platform
linuxObjectnullUse for specific android platform
Android OptionTypeDefaultDescription
enableBooleanfalseUse for enable Android platform
nameString/ObjectnullThe launcher name or localized names
iOS OptionTypeDefaultDescription
enableBooleanfalseUse for enable iOS platform
nameString/ObjectnullThe launcher name or localized names
MacOS OptionTypeDefaultDescription
enableBooleanfalseUse for enable MacOS platform
nameString/ObjectnullThe launcher name or localized names
Windows OptionTypeDefaultDescription
enableBooleanfalseUse for enable Windows platform
nameString/ObjectnullThe launcher name or localized names
Linux OptionTypeDefaultDescription
enableBooleanfalseUse for enable Linux platform
nameString/ObjectnullThe launcher name or localized names
Web OptionTypeDefaultDescription
enableBooleanfalseUse for enable Web platform
nameString/ObjectnullThe launcher name or localized names

Example

names_launcher:
  name:
    default: "Your App Default Name"
    zh: "应用中文名"
  platforms:
    android:
      enable: true
    ios:
      enable: true
    web:
      enable: true
    macos:
      enable: false
    windows:
      enable: false
    linux:
      enable: false