Xcode Server环境变量参考

Xcode Server定义了许多内置环境变量,您可以在Run Script构建阶段使用这些变量,作为集成、预集成触发器和后集成触发器的一部分。当进行Xcode Server API请求时这些变量提供的信息将非常有用。有关Xcode Server API的信息,参见 Xcode Server API Reference

备注

除了内建的Xcode Server环境变量,您也可以在配置bot时自定义环境变量。






































































































































































表5-1Xcode Server环境变量参考

变量

可用性

描述

XCS

Xcode 7和更高版本

变量值永远为 1。脚本可以检查此值以确定它是否在Xcode Server的上下文中运行。

XCS_BOT_NAME

Xcode 7和更高版本

正在运行的bot的名称。

XCS_BOT_ID

Xcode 7和更高版本

Bot的ID。 可被用在Xcode Server API请求中。

XCS_BOT_TINY_ID

Xcode 7和更高版本

bot ID的短版本。一些Xcode Server API请求会使用这个信息。

XCS_INTEGRATION_ID

Xcode 7和更高版本

集成的ID。 可被用在Xcode Server API请求中。

XCS_INTEGRATION_TINY_ID

Xcode 7和更高版本

集成的ID的短版本。一些Xcode Server API请求会使用这个信息。

XCS_INTEGRATION_NUMBER

Xcode 7和更高版本

集成所运行的次数。

XCS_INTEGRATION_RESULT

Xcode 7和更高版本

表示集成结果的字符串,例如, 成功测试失败构建错误、 和 取消集成。 这些变量用于后集成触发器。

XCS_SOURCE_DIR

Xcode 7和更高版本

Xcode Server包含源码仓库的顶级目录。对于存储库本身的路径, 参考 XCS_PRIMARY_REPO_DIR.

XCS_OUTPUT_DIR

Xcode 7和更高版本

集成期间存储的资源(包括日志和产品)的顶级目录。

XCS_DERIVED_DATA_DIR

Xcode 7和更高版本

派生的数据目录。 Xcode Server建立在非标准位置,因此这个目录是bot特定的。

XCS_XCODEBUILD_LOG

Xcode 7和更高版本

在集成期间运行xcodebuild命令生成的输出文件的路径。

XCS_ARCHIVE

Xcode 7和更高版本

.xarchive 文件路径(如果集成期间执行了归档的话)。

XCS_PRODUCT

Xcode 7和更高版本

.app.ipa、 或 .package 文件路径(如果集成期间从归档中输出了产品的话)。

XCS_ERROR_COUNT

Xcode 7和更高版本

集成期间产生的错误总数

XCS_ERROR_CHANGE

Xcode 7和更高版本

相对于上次集成产生的错误数值的改变。该值可以为负。

XCS_WARNING_COUNT

Xcode 7和更高版本

集成期间产生的警告总数。

XCS_WARNING_CHANGE

Xcode 7和更高版本

相对于上次集成产生的警告数值的改变。该值可以为负。

XCS_ANALYZER_WARNING_COUNT

Xcode 7和更高版本

集成期间产生的静态分析警告总数。

XCS_ANALYZER_WARNING_CHANGE

Xcode 7和更高版本

相对于上次集成产生的静态分析警告数值的改变。该值可以为负。

XCS_TEST_FAILURE_COUNT

Xcode 7和更高版本

集成期间产生的测试失败总数。

XCS_TEST_FAILURE_CHANGE

Xcode 7和更高版本

相对于上次集成产生的测试失败数值的改变。该值可以为负。

XCS_TESTS_COUNT

Xcode 7和更高版本

集成执行的测试总数。

XCS_TESTS_CHANGE

Xcode 7和更高版本

相对于上次集成执行的测试数值的改变。该值可以为负。

XCS_THINNED_PRODUCTS_PLIST

Xcode 8和更高版本

描述对.ipa进行『瘦身』的属性列表文件 (.plist) 及其变体的导出路径。此属性列表文件仅在执行app『瘦身』时存在。

XCS_THINNED_PRODUCTS_PATH

Xcode 8和更高版本

包含在集成期间导出的『瘦身』的 .ipa 文件目录

XCS_PRIMARY_REPO_DIR

Xcode 8和更高版本

正在集成的Xcode项目或工作空间的源代码存储库的路径。 对于包含Xcode Server的源代码存储库的父目录,请参阅XCS_SOURCE_DIR.

XCS_PRIMARY_REPO_BRANCH

Xcode 8和更高版本

主源代码仓库分支,用于签出要集成的项目或工作空间。仅在签出分支时使用。

XCS_PRIMARY_REPO_TAG

Xcode 8和更高版本

主源代码仓库标签,用于签出要集成的项目或工作空间。仅在签出分支时使用。

XCS_PRIMARY_REPO_REVISION

Xcode 8和更高版本

提交的SVN修订版本号或Git哈希值,用于签出主源代码存储库之外的要集成的项目或工作空间。 仅在不签出分支或标记时使用。