企业官网建设流程全解析

1. 项目概述：Flutter应用重命名的核心需求

当你完成一个Flutter应用的开发后，突然发现应用名称不符合品牌定位需要修改，或者客户要求更换显示名称时，重命名操作就成为了必经之路。与原生Android/iOS开发不同，Flutter作为跨平台框架，其重命名流程涉及多端配置文件的联动修改，稍有不慎就会导致应用图标丢失、启动名称不一致等"水土不服"的症状。

最近接手的一个电商应用改造项目就遇到了这种情况——原应用名为"ShopQuick"，需要更名为"GlobalMart"以匹配新的品牌战略。经过实战踩坑，我总结出一套完整的Flutter应用重命名方案，涵盖Android、iOS双端配置，以及常被忽略的macOS/Windows桌面端处理技巧。

2. 多平台配置修改详解

2.1 Android端配置改造

Android端的应用名称主要存储在以下三个关键位置：

1. AndroidManifest.xml
   路径：android/app/src/main/AndroidManifest.xml
   修改android:label属性值（示例）：

   <application android:name="io.flutter.app.FlutterApplication" android:label="GlobalMart" <!-- 修改此处 --> android:icon="@mipmap/ic_launcher">

2. strings.xml（推荐方案）
   路径：android/app/src/main/res/values/strings.xml
   最佳实践是使用字符串资源引用：

   <resources> <string name="app_name">GlobalMart</string> </resources>

   然后在AndroidManifest.xml中引用：

   android:label="@string/app_name"

3. build.gradle中的应用ID
   路径：android/app/build.gradle
   如需修改包名（非必须）：

   defaultConfig { applicationId "com.example.globalmart" // 修改后需同步改目录结构 minSdkVersion 21 targetSdkVersion 33 }

避坑提示：修改applicationId会导致应用被视为新应用，原有用户的升级路径会中断。非必要情况下建议保留原ID。

2.2 iOS端配置调整

iOS端的重命名涉及更多文件，需要特别注意Xcode的特定配置：

1. Info.plist文件
   路径：ios/Runner/Info.plist
   修改CFBundleDisplayName：

   <key>CFBundleDisplayName</key> <string>GlobalMart</string>

2. Xcode工程配置（可视化修改）
   执行：

   open ios/Runner.xcworkspace

   在Xcode中：

   • 点击Runner项目
   • 选择Runner target
   • 在General → Display Name处修改

3. Scheme名称（可选）
   在Xcode菜单栏： Product → Scheme → Manage Schemes → 双击重命名

4. 文件夹结构同步
   重命名项目目录：

   mv ios/Runner ios/GlobalMart

   然后修改podfile中的路径配置：

   target 'GlobalMart' do # 与原Runner对应 flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__)) end

2.3 桌面端特别处理

对于Windows/macOS桌面应用，需要额外配置：

Windows (flutter_win_plugins):

1. 修改windows/runner/Runner.rc中的APP_NAME
2. 更新windows/CMakeLists.txt中的PROJECT_NAME

macOS:

1. 修改macos/Runner/Info.plist中的CFBundleName
2. 在Xcode中同步修改Product Name（Build Settings搜索）

3. 全自动化重命名方案

对于需要频繁修改名称的开发场景（如多品牌发布），推荐使用以下自动化工具：

3.1 使用rename插件

1. 添加依赖：

   dev_dependencies: rename: ^2.0.0

2. 执行命令（示例）：

   flutter pub run rename --bundleId com.yourcompany.globalmart flutter pub run rename --appname "GlobalMart"

3.2 自定义shell脚本

创建rename_app.sh：

#!/bin/bash NEW_NAME="GlobalMart" NEW_BUNDLE_ID="com.example.globalmart" # Android sed -i '' "s/old_app_name/$NEW_NAME/g" android/app/src/main/AndroidManifest.xml sed -i '' "s/com.example.oldid/$NEW_BUNDLE_ID/g" android/app/build.gradle # iOS plutil -replace CFBundleDisplayName -string "$NEW_NAME" ios/Runner/Info.plist plutil -replace CFBundleIdentifier -string "$NEW_BUNDLE_ID" ios/Runner/Info.plist # Flutter sed -i '' "s/name: .*/name: $NEW_NAME/g" pubspec.yaml

4. 深度避坑指南

4.1 图标资源同步更新

重命名后常见问题：应用图标显示为默认Flutter图标。这是因为图标文件引用未更新：

1. Android：

   • 检查android/app/src/main/res/mipmap-*/ic_launcher.png
   • 更新AndroidManifest.xml中的icon路径

2. iOS：

   • 替换ios/Runner/Assets.xcassets/AppIcon.appiconset内所有图片
   • 确认Contents.json文件配置正确

4.2 多语言环境处理

当应用支持多语言时，需在各语言资源文件中更新应用名：

1. Android的values-xx/strings.xml
2. iOS的xx.lproj/InfoPlist.strings
3. Flutter的arb文件（如果使用intl包）

4.3 第三方服务配置

以下服务需要同步更新应用名称：

1. Firebase项目配置
2. 应用商店后台（Apple Connect/Google Play Console）
3. 社交登录配置（Facebook/Google开发者后台）
4. 深度链接关联域名

5. 版本控制策略

大规模重命名会导致git识别为文件删除/新增。推荐操作流程：

1. 创建新分支：

   git checkout -b feature/rename-app

2. 分步骤提交：

   # 先提交配置修改 git add android/app/build.gradle git commit -m "chore: update app bundleId" # 再提交资源变更 git add ios/Runner/Info.plist git commit -m "chore: update iOS display name"

3. 使用git mv处理目录重命名：

   git mv ios/Runner ios/GlobalMart

经过完整测试后，我在实际项目中验证这套方案可以确保：

• 应用名称在各平台显示一致
• 通知栏、桌面快捷方式等系统集成点正常
• 应用商店更新流程不受影响
• 深度链接和第三方服务持续可用