如何借助pub.dev包安全重命名Flutter项目（Linux Fedora 38环境）

操作步骤 #

1. 选用可靠的重命名工具 #

使用rename包自动处理全项目的配置修改，避免手动修改遗漏引发的异常。

2. 安装并执行重命名命令 #

• 在项目根目录运行命令安装开发依赖：

  flutter pub add rename --dev
  

• 执行重命名命令，替换<阿拉伯语名称>为你的目标显示名称：

  flutter pub run rename --appname "<阿拉伯语名称>" --android-app-name "<阿拉伯语名称>" --ios-display-name "<阿拉伯语名称>"
  

  注意：阿拉伯语是RTL（从右到左）语言，需确保项目支持RTL布局：在pubspec.yaml中启用Material Design，在MaterialApp里设置locale: Locale('ar')和supportedLocales: [Locale('ar')]

3. 验证修改有效性 #

• 确认pubspec.yaml的name字段（建议保留英文标识符，符合Dart包命名规范，仅修改显示名称为阿拉伯语）
• 检查Android的AndroidManifest.xml中android:label是否为阿拉伯语名称
• 检查iOS的Info.plist中CFBundleDisplayName是否为阿拉伯语名称
• 运行项目测试启动是否正常，无报错

手动修改遗留问题修复 #

如果之前手动修改已引发问题，执行以下操作：

• 清理缓存并重新获取依赖：

  flutter clean
  flutter pub get
  

• 排查所有Dart文件中的硬编码旧名称，替换为新的阿拉伯语显示名称
• 检查Android项目的strings.xml（含res/values-ar/strings.xml），确保应用名称配置正确

内容的提问来源于stack exchange，提问作者islamux