iOS第8篇 修改项目名称

iOS项目名称修改完整指南

一、修改项目名称（Xcode显示名称）

方法1：通过Xcode重命名

1. 关闭Xcode
2. 在Finder中找到项目文件夹
3. 右键点击.xcodeproj文件选择"重新命名"
4. 输入新名称并按回车
5. 在弹出的对话框中点击"重命名"确认

方法2：使用Xcode内置功能

1. 在Xcode中选中项目导航器中的项目文件（.xcodeproj）
2. 按回车键进入编辑模式
3. 输入新名称后再次按回车
4. Xcode会提示确认重命名，选择"Rename"

二、修改Target名称

1. 在Xcode左侧导航栏选择项目文件
2. 在TARGETS下选择要修改的Target
3. 按回车键进入编辑模式
4. 输入新名称后按回车确认

三、修改Scheme名称

1. 点击Xcode顶部菜单栏的Product > Scheme > Manage Schemes
2. 选择要修改的Scheme
3. 按回车键进入编辑模式
4. 输入新名称后按回车确认
5. 点击"OK"保存更改

四、修改Bundle Identifier

1. 在项目导航器中选择Target
2. 选择"General"标签
3. 找到"Identity"部分的Bundle Identifier
4. 修改为新的标识符（通常保持反向域名格式）

五、修改文件夹结构中的名称（可选）

1. 关闭Xcode
2. 在Finder中重命名项目根文件夹
3. 重命名.xcodeproj文件
4. 打开项目后可能需要重新链接某些文件

六、修改代码中的旧项目引用

1. 全局搜索旧项目名称（Command+Shift+F）
2. 替换所有出现的旧名称为新名称
3. 特别注意以下文件：
   • Podfile（如果使用CocoaPods）
   • Fastfile（如果使用Fastlane）
   • 任何配置文件（如.env文件）

注意事项

1. 版本控制：修改前确保提交所有更改或创建分支
2. 依赖关系：检查Podfile/Carthage/Swift Package Manager中的引用
3. 持续集成：更新CI/CD配置中的项目名称
4. 测试：重命名后全面测试应用功能
5. 多Target项目：确保所有Target都正确更新

常见问题解决

1. 文件丢失引用：

   • 在Xcode中右键丢失的文件选择"Delete"（仅移除引用）
   • 然后通过"Add Files to…"重新添加

2. 编译错误：

   • 清理项目（Product > Clean Build Folder）
   • 删除DerivedData（~/Library/Developer/Xcode/DerivedData）

3. 证书问题：

   • 如果修改了Bundle ID，需要重新配置Provisioning Profile

完成以上步骤后，你的iOS项目名称就成功修改了。建议在修改后进行完整的构建和测试以确保所有功能正常。