TN2339: 使用 Xcode 命令行构建的常见问题

发布网友 发布时间：2024-12-19 17:04

我来回答

共1个回答

热心网友 时间：2024-12-19 23:10

Apple Developer Documentation Archive 提供了大量的开发者文档，具有极高的参考价值。项目“adat”选取了其中一些经典文章，并进行了翻译，去除了过时内容，确保与最新版本的 Xcode 兼容。本文是该项目的开篇之作，后续文章将逐步深入，探讨企业级构建中使用命令行工具的最佳实践。

在开始阅读之前，请注意以下文章的关联内容：《命令行工具包是什么？》、《macOS 10.9 及之后版本的 Xcode 如何安装命令行工具？》、《如何卸载命令行工具？》、《如何查看当前使用的命令行工具版本？》、《如何修改命令行工具使用的 Xcode 版本？》、《如何使用命令行构建 Xcode 项目？》等。

命令行工具包是一个小型自包含的工具集合，可在 macOS 上通过命令行进行开发。它包括 macOS SDK 和命令行工具，如 Clang，位于 /Library/Developer/CommandLineTools。

在 macOS 10.9 及之后版本中，Xcode 的偏好设置中不再提供命令行工具的直接下载入口。您可以选择以下几种方式安装：通过安装 Xcode、从 Apple 开发者网站下载或使用 Terminal 安装命令行工具。

卸载命令行工具时，您可以执行以下命令：在 Terminal 中运行 `xcode-select -p` 查看当前使用的 Xcode 版本路径，然后删除此路径下的命令行工具。

在 Terminal 中输入 `xcode-select -p` 命令，可以查看命令行工具使用的 Xcode 版本路径。

在 Terminal 中使用 `xcode-select -switch ` 命令，将 `path-to-xcode` 替换为相应版本的 Xcode 路径。

使用 xcodebuild 命令可以编译、查询、分析、测试和归档 Xcode 项目和工作空间。操作项目时需要指定至少一个 target 或 scheme，工作空间则只需指定一个 scheme。通过 `man xcodebuild` 可查阅详细使用手册。

在执行命令前，请确保已切换到项目或工作空间所在的目录，或指定完整路径。例如：列出所有 scheme 的命令为 `xcodebuild -list`。

xcodebuild 支持执行单元测试，使用命令格式：`xcodebuild test -workspace -project -destination "platform=ios,device=iPhone" -only-testing TestClass=TestClass TestMethod=testMethodName`。

使用 `xcodebuild build-for-testing` 可以实现 Build For Testing 功能，使用 `xcodebuild test-without-building` 可以实现 Test Without Building 功能。

使用 `xcodebuild -help` 查看 `exportOptionsPlist` 参数的相关信息，以获取详细配置选项。

使用 `xcodebuild archive` 命令生成归档文件，然后使用 `xcodebuild export-archive` 导出 .ipa 文件，最后通过 `xcodebuild export` 导出 .ipa 文件。

参考文档：developer.apple.com/library...