
第一步从Mac App Store安装最新版的Xcode,安装过程中会同时安装大部分iOS SDK和模拟器。第二步通过终端执行安装命令安装Command Line Tools(xcode-select --install),以便其他工具能调用。
建议安装Homebrew并通过它安装常用工具(git、node、cocoapods等),以及配置Apple ID并在Xcode -> Preferences -> Accounts中登录,方便下载证书和启用自动签名。
在Xcode菜单选择Preferences -> Components,可以看到可下载的模拟器运行时(如iOS 15.0/14.4等)。勾选并下载需要的版本即可在Window -> Devices and Simulators中使用。
若需旧版SDK,可下载对应旧版Xcode并通过复制Platform或Simulator runtimes到/Applications/Xcode.app/Contents/Developer/Platforms下(谨慎操作并备份),或者使用多个Xcode并通过xcode-select切换。
用USB连接设备后,手机端需要点击“信任此电脑”,并在iOS上开启Developer Mode(iOS16+)。在Xcode的Window -> Devices and Simulators中应能看到设备并选择用于运行和调试。
可在Devices界面勾选“Connect via network”启用无线调试,但初次仍需USB配对。无线调试对网络和电量敏感,排查连接问题时优先尝试有线方式。
若设备不显示,检查Xcode版本是否支持该iOS版本、USB线与端口是否正常、以及是否在设备上接受了信任提示;必要时重启Xcode或重新插拔设备。
在Apple Developer网站创建/登录账号后,进入Certificates, Identifiers & Profiles创建App ID、证书和设备列表。Xcode可通过Automatic Signing自动管理证书和描述文件,适合个人或小团队快速部署。
大型团队或CI通常使用手动签名:在开发者后台生成Provisioning Profile并下载,保证私钥在Keychain中可用;推荐使用fastlane match或证书管理工具统一管理证书与描述文件。
安装cocoapods、brew、ruby环境(如rbenv)、node及相关依赖。Flutter或React Native在iOS平台构建时会调用Xcode命令行工具,确保xcode-select指向正确的Xcode版本。
在CI环境(Jenkins、GitHub Actions等Mac runner)中,需导入证书到默认Keychain并配置描述文件。推荐使用fastlane的match来集中管理证书和描述文件,结合gym/scan实现自动打包和上传。
确保CI机器的Xcode版本与本地一致,设置自动增量构建缓存并使用xcpretty提高日志可读性;对密钥材料敏感时使用安全存储或私有证书仓库,避免明文提交。