C# 脚本
C# Script 运行器允许在 Windows 、 Linux 或 macOS 上执行 C# 脚本。 它使用定制的 TeamCity 工具在各个平台上运行 C# Interactive shell。
使用此运行器,您可以执行各种服务任务,如准备构建环境,创建 OS 用户,或向不同的消息传递器进行报告。
参考 配置构建步骤 以获取常见构建步骤设置的描述。 参考 容器包装器 了解如何在容器内运行这一步骤。
tip
这篇 博客文章 描述了这个运行程序,并包含了两个教程:基础的 "Hello World" 和更高级的 Telegram 机器人集成。 它还展示了在 Kotlin DSL 中的一个 C# 脚本步骤配置示例。
运行器的要求:
.NET 运行时 6.0.0 或更高版本必须安装在构建代理上,或者如果此步骤在 Docker 内部运行,则必须在 Docker 容器中可用。
TeamCity.csi软件包必须作为代理工具进行安装。
tip
在 TeamCity 外部使用 TeamCity.csi
您可以使用我们的自定义工具从命令行运行 C# 任务,类似于使用常规的 C# Interactive 工具。 TeamCity.csi 可以在 Windows 、 Linux 和 macOS 上运行。 请查看其 README 以获取更多详情。
设置 | 描述 |
---|---|
TeamCity C# 脚本工具 | 从通过 管理 | 工具 安装的 TeamCity C# 脚本工具中选择一个版本,或者相对于 构建检出目录 输入此工具的自定义路径。 |
脚本类型 | 选择以下两个选项之一:直接在运行器中输入自定义脚本体,或指定 C# 脚本文件的路径(
|
C# 脚本 | 适用于 Custom Script 类型。 输入一个 C# 脚本的代码。 |
C# 脚本文件 | 适用于 Script File 类型。 输入到脚本文件的路径,相对于 构建检出目录。 |
脚本形参 | 输入脚本的参数。 参数作为 参数引用得到了支持。
|
NuGet 包源 | 如果您在脚本中引用一个包,TeamCity 将会自动从此字段指定的源下载它。 运行器可以自动解析像 默认情况下,TeamCity 会从 NuGet.org 上发布的源还原 NuGet 包。 在此字段中,您可以指定通往其他 NuGet 存储库的路径,TeamCity 将按声明顺序在这些位置搜索包。 如果在指定的存储库中找不到包源,TeamCity 将在 NuGet.org 上进行搜索。 为了能够访问私有仓库,请配置 NuGet feed credentials。 您也可以参考一下 TeamCity 内部源。 |
支持的命令:
命令 | 描述 | 示例 |
---|---|---|
| 添加对 NuGet 包或程序集及其依赖项的引用。 |
|
| 加载指定的脚本文件并执行它。 |
|
| 显示可用命令和按键绑定的帮助。 | |
| 将详细程度设置为 |
支持的参数:
在 脚本参数 字段中提供的 参数 并存储在
实参
数组中(例如,WriteLine(Args[0])
用于写入第一个脚本参数的值);系统参数在Build Configuration Settings | Parameters中指定,并存储在
Props
字典中(例如,WriteLine(Props["version"])
用来写入system.version
参数的值)。
感谢您的反馈!