✨ 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

Android iOS MacOS Web Linux Windows
✔️ ✔️ ✔️ ✔️ ✔️ ✔️

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 Option Type Default Description
name String/Object null The launcher name or localized names
platforms Object null Use for specific platform to change names

Platforms Option Type Default Description
android Object null Use for specific android platform
ios Object null Use for specific android platform
macos Object null Use for specific android platform
windows Object null Use for specific android platform
web Object null Use for specific android platform
linux Object null Use for specific android platform
Android Option Type Default Description
enable Boolean false Use for enable Android platform
name String/Object null The launcher name or localized names
iOS Option Type Default Description
enable Boolean false Use for enable iOS platform
name String/Object null The launcher name or localized names
MacOS Option Type Default Description
enable Boolean false Use for enable MacOS platform
name String/Object null The launcher name or localized names
Windows Option Type Default Description
enable Boolean false Use for enable Windows platform
name String/Object null The launcher name or localized names
Linux Option Type Default Description
enable Boolean false Use for enable Linux platform
name String/Object null The launcher name or localized names
Web Option Type Default Description
enable Boolean false Use for enable Web platform
name String/Object null The 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