package_rename_plus 是一款高效率工具,專為簡化 Flutter 項目生產環境設定流程而設計。它能快速重命名套件識別碼、應用名稱及相關資源,適用於 Android、iOS、macOS、Windows 與 Linux 等多個平台。透過自動化配置更新,減少手動錯誤並加速部署準備。適合希望在擴展或重新品牌化過程中維持專案結構整潔一致的開發者。
適用情境
重命名Flutter應用以進行重新品牌化
準備應用程式以進行生產部署
自動化套件識別碼變更
跨平台設定更新
優化CI/CD流程
主要特色
飛速執行
多平台支援
自動資源更新
安全的設定處理
命令列整合
適合對象
Flutter 開發者
App重新品牌化團隊
CI/CD 自動化工程師
大型專案維護者
DevOps 工程師
使用建議
使用前需謹慎備份
可能與自定義設定衝突
不適用於一次性變更
僅限套件層級重新命名
取決於正確的專案結構
原始 README
以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。
Package Rename Plus
This a fork repository from official package_rename using different approach to replace the configuration.
Fixed ios issue about replace bundle identifier with or without extension targets.
Removed logger dependency that can be solved using debugPrint only to minimize dependency to others packages/plugins.
A Blazingly Fast way to configure your Bleeding Edge flutter project to be production ready.
Package Rename handles changing 37 fields across 19 files on 6 platforms so you can focus on your awesome project.
You can create configurations by adding package_rename_config key in:
Root pubspec.yaml file
package_rename_config.yaml file at root of your project or a custom folder in the project
Usage
Adding Platform Specific Configurations
package_rename_config:android:app_name:# (String) The display name of the android apppackage_name:# (String) The package name of the android appoverride_old_package:# (Optional) (String) Use this to delete the old folder structure of MainActivity or to use the existing code with the new package namelang:# (Optional) (String) The android development language {kotlin(default) or java}ios:app_name:# (String) The display name of the ios appbundle_name:# (String) The bundle name of the ios appoverride_old_package:# (String) Use this to replace the old bundle identifier with the new bundle identifierpackage_name:# (String) The product bundle identifier of the ios applinux:app_name:# (String) The window title of the linux apppackage_name:# (String) The application id of the linux appexe_name:# (String) The executable name (binary name) of the linux appmacos:app_name:# (String) The product name of the macos apppackage_name:# (String) The product bundle identifier of the macos appcopyright_notice:# (String) The product copyright of the macos appweb:app_name:# (String) The title of the web app and PWAshort_app_name:# (String) The short display name of the PWA (Optional, defaults to app_name if not set)description:# (String) The description of the web app and PWAwindows:app_name:# (String) The window title & software name of the windows apporganization:# (String) The organization name (company name) of the windows appcopyright_notice:# (String) The legal copyright of the windows appexe_name:# (String) The executable name (binary name) of the windows app
dart run package_rename_plus --flavour=flavour_name
or
dart run package_rename_plus -f flavour_name
With custom config file location:
dart run package_rename_plus --flavour=flavour_name --path="path/to/package_rename_config.yaml"
Known Issues
iOS and macOS issues with PRODUCT_BUNDLE_IDENTIFIER:
The PRODUCT_BUNDLE_IDENTIFIER's in ios/Runner.xcodeproj/project.pbxproj and macos/Runner.xcodeproj/project.pbxproj have different values for different targets. Like, in my case:
Hence, to properly change the PRODUCT_BUNDLE_IDENTIFIER without removing the Extension name, make sure all PRODUCT_BUNDLE_IDENTIFIER's except the DEFAULT ones are enclosed in double quotes ("").