企业官网建设流程全解析

如何用 ignite-cli rename 给现有 Ignite 项目改名并切换 bundle identifier？

【免费下载链接】igniteInfinite Red's battle-tested React Native project boilerplate, along with a CLI, component/model generators, and more! 9 years of continuous development and counting.项目地址: https://gitcode.com/GitHub_Trending/ig/ignite

如果你已经用 Ignite 生成过一个项目，现在想把它改成正式的应用名，并顺带换掉 bundle identifier（iOS）/ Android package name，可以在项目目录里直接运行npx ignite-cli rename。它会一次性完成改名、切换 bundle identifier、移动 Android 包路径并批量替换相关文件中的旧名称。注意 Ignite 的帮助输出把这条命令标记为 experimental（实验性），完成后必须用git diff检查改动再提交。

运行前的前提条件

命令要求你站在项目根目录执行。它会检查当前目录下是否存在app.json，找不到就输出警告并直接退出：

You must be in the root of a React Native project to rename it. (We look for an app.json file to verify this.)

当前的应用名从app.json的name字段读取；当前的 bundle identifier 从app.json的android.package（没有则取ios.bundleIdentifier）读取，兼容 v9+ 的 managed/CNG 工程结构（见 src/commands/rename.ts）。如果app.json里读不到名字或 package name，命令同样会警告并退出。

另外两个建议：

• 项目用 git 管理，因为命令给出的验证和回滚手段都基于 git；
• 新应用名如果和旧名相同，命令会提示 "The current name and the new name are the same." 并直接退出，不做任何修改。

执行 rename 命令

命令格式（示例来自 Ignite CLI 的 help 输出，见 src/commands/help.ts）：

npx ignite-cli rename NewName com.mycompany.newname

• 第一个参数是新的应用名；
• 第二个参数是新的 bundle identifier / Android package；
• 别名写法为npx ignite-cli rn（见 docs/cli/Ignite-CLI.md）。

如果不提供参数，命令会交互式提问：What would you like to rename your app to? Currently: <旧名>以及What would you like to rename your package to? Currently: <旧 bundle>。bundle 也可以通过--bundle选项传入（代码中读取parameters.options.bundle）。

执行时加--debug可以输出每一步的详细日志，包括每个被重命名的文件和被 patch 的文件，方便核对处理范围。

命令实际会做三类事（处理范围见 src/tools/react-native.ts）：

1. 重命名 iOS 工程文件/目录：ios/<旧名>.xcodeproj、ios/<旧名>.xcworkspace、xcscheme、<旧名>Tests、Info.plist、.entitlements等；
2. bundle identifier 变化时移动 Android 包目录：把android/app/src/{main,debug,release}/java/<旧包路径>下的代码移动到新包路径（点号按/展开）；
3. 批量替换文本：在app.json、package.json、android/settings.gradle、android/app/build.gradle、AndroidManifest.xml、ios/Podfile、Info.plist、project.pbxproj等一份固定清单里，把旧名（含小写、kebab-case、SCREAMING_SNAKE_CASE 变体）和旧 bundle identifier 替换为新值。清单中不存在的文件会被跳过，不会报错。

验证结果

命令成功后会输出：

Ignite successfully renamed your app from <旧名> to <新名>!

然后按 CLI 给出的 Next 步骤做验证：

git diff

逐条检查改动是否合理。CLI 原文明确提示：Ignite 的 rename 功能并非在所有场景下 100% 完美，提交前务必仔细检查git diff产生的差异。同时它提示你需要重新运行pod install并重新构建应用和缓存，因为命令不会改动那些构建产物目录。

出错时如何回滚

CLI 给出的重置方式是：

git reset --hard && git clean -fd

这条命令会丢弃项目中所有未提交的改动，不只是 rename 产生的修改。CLI 对此有明确警告（"careful: this will remove all other changes you haven't committed!"）。只有在确认没有其他需要保留的未提交内容时才使用它。

限制

• 该命令在 help 输出中标注为 experimental；
• rename 不修改构建产物和 Pods 等目录，iOS 侧必须自行重跑pod install并重新构建；
• 文本替换只覆盖 src/tools/react-native.ts 中列出的固定文件清单，如果项目里有清单之外的文件硬编码了旧名或旧 bundle identifier（例如自定义脚本、CI 配置），需要自行检查git diff之外的遗漏。

【免费下载链接】igniteInfinite Red's battle-tested React Native project boilerplate, along with a CLI, component/model generators, and more! 9 years of continuous development and counting.项目地址: https://gitcode.com/GitHub_Trending/ig/ignite