发布到 NuGet

将您的公开 Fern C#/.NET SDK 发布到 NuGet 注册表。按照本页面的步骤操作后，您将在 NuGet 上发布一个版本化的包。

本页面假设您已有：

一个已初始化的 fern 文件夹、一个用于 C#/.NET SDK 的 GitHub 仓库，以及在 generators.yml 中的一个 C#/.NET 生成器组。参见生成 SDK (C#/.NET)。

配置 SDK 包设置

您需要更新 generators.yml 文件来配置包名称、输出位置和客户端名称，以便 NuGet 发布。您的 generators.yml 应该放在您的源代码仓库中（或本地机器上），而不是包含 C#/.NET SDK 代码的仓库中。

配置 `output` 位置

在您的 C#/.NET SDK 的 group 中，将输出位置从 local-file-system（默认值）更改为 nuget，以指示 Fern 应该直接将您的包发布到 npm 注册表：

generators.yml

1 groups: 
2   csharp-sdk:
3 	generators:
4 	  - name: fernapi/fern-csharp-sdk
5 	    version: 2.65.0
6 		output:
7 		  location: nuget

添加唯一的包名称

您的包名称在 NuGet 仓库中必须是唯一的，否则将您的 SDK 发布到 NuGet 将失败。

generators.yml

1 groups: 
2   csharp-sdk:
3 	generators:
4 	  - name: fernapi/fern-csharp-sdk
5 		version: 2.65.0
6 		output:
7 		  location: nuget
8 		  package-name: your-package-name

配置 `client-class-name`

client-class-name 选项控制生成的客户端的名称。这是客户使用的导入您的 SDK 的名称（import { your-client-name } from 'your-package-name';）。

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9         config:
10           client_class_name: YourClientName # 必须是 PascalCase

生成 NuGet API 密钥

登录 NuGet

添加新密钥

点击您的个人资料图片。
选择 API Keys，然后 Create。
为您的密钥命名。
选择 Push > Push new packages and package versions 作为 Select Scopes 类型。
在 Select Packages > Glob Patten 下输入 *。

替换现有的 NuGet 包
如果您要覆盖现有包，可以选择相关包而不是输入 *。
点击 Create。

保存您的新密钥 - 离开页面后将不再显示。

配置 NuGet 发布

添加仓库位置

添加包含您的 C#/.NET SDK 的 GitHub 仓库路径：

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9         config:
10           client_class_name: YourClientName
11         github: 
12           repository: your-org/company-csharp

配置 NuGet 身份验证密钥

将 api-key: ${NUGET_API_KEY} 添加到 generators.yml，告诉 Fern 在发布到 NuGet 注册表时使用 NUGET_API_KEY 环境变量进行身份验证。

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9           api-key: ${NUGET_API_KEY}
10         config:
11           client_class_name: YourClientName
12         github: 
13           repository: your-org/company-csharp

选择您的发布模式

Optionally set the mode to control how Fern handles SDK publishing:

mode: release (default): Fern generates code, commits to the default branch (or the branch you specify), and tags a release automatically
mode: pull-request (recommended): Fern generates code and creates a PR for you to review before release
mode: push: Fern generates code and pushes to a branch you specify for you to review before release

You can also configure other settings, like the reviewers or license. Refer to the full github (generators.yml) reference for more information.

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9           api-key: ${NUGET_API_KEY}
10         config:
11           client_class_name: YourClientName
12         github: 
13           repository: your-org/company-csharp
14 		  mode: push
15 		  branch: your-branch-name # mode: push 时必需

发布您的 SDK

决定如何将您的 SDK 发布到 NuGet。您可以使用 GitHub 工作流进行自动化发布，或通过 CLI 直接发布。

通过 GitHub 工作流发布

通过 GitHub Actions 设置发布工作流，这样您就可以直接从源代码仓库触发新的 SDK 发布。

设置身份验证

在 GitHub 中打开您的源代码仓库。点击 Settings 标签。然后，在 Security 部分下，打开 Secrets and variables > Actions。

您也可以使用 URL https://github.com/<your-repo>/settings/secrets/actions。

为您的 NuGet API 密钥添加密钥

选择 New repository secret。
将您的密钥命名为 NUGET_API_KEY。
添加您在上面生成的相应 API 密钥。
点击 Add secret。

为您的 Fern Token 添加密钥

选择 New repository secret。
将您的密钥命名为 FERN_TOKEN。
添加您的 Fern token。如果您还没有，可以通过运行 fern token 来生成一个。默认情况下，fern_token 是为 fern.config.json 中列出的组织生成的。
点击 Add secret。

设置新的工作流

设置一个可以从 GitHub UI 手动触发的 CI 工作流。在您的仓库中，导航到 Actions。选择 New workflow，然后 Set up workflow yourself。添加类似于这样的工作流：

.github/workflows/publish.yml

1 name: Publish C#/.NET SDK
2 
3 on:
4   workflow_dispatch:
5     inputs:
6       version:
7         description: "您想要发布的 C#/.NET SDK 的版本"
8         required: true
9         type: string
10 
11 jobs:
12   release:
13     runs-on: ubuntu-latest
14     steps:
15       - name: Checkout repo
16         uses: actions/checkout@v4
17 
18       - name: Install Fern CLI
19         run: npm install -g fern-api
20 
21       - name: Release C#/.NET SDK
22         env:
23           FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
24           NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
25         run: |
26           fern generate --group csharp-sdk --version ${{ inputs.version }} --log-level debug

您也可以配置您的工作流为 on: [push] 执行。参见 Vapi 的 npm 发布 GitHub Action 作为示例。

重新生成并发布您的 SDK

导航到 Actions 标签，选择您刚创建的工作流，指定一个版本号，然后点击 Run workflow。这将重新生成您的 SDK。

The rest of the release process depends on your chosen mode:

Release mode (default): If you didn’t specify a mode or set mode: release, no further action is required. Fern automatically tags the new release with your specified version number and initiates the publishing workflow in your SDK repository.
Pull request or push mode: If you set mode: pull-request or mode: push, Fern creates a pull request or pushes to a branch respectively. Review and merge the PR (pull-request) or branch (push), then tag a new release to initiate the publishing workflow in your SDK repository.

工作流完成后，您可以通过登录 NuGet 并导航到 Manage Packages 来查看您的新发布。

通过 CLI 和环境变量发布

设置 npm 环境变量

在本地机器上设置 NUGET_API_KEY 环境变量：

$ export NUGET_API_KEY=your-actual-nuget-api-key

重新生成并发布您的 SDK

重新生成您的 SDK，指定版本：

$ fern generate --group csharp-sdk --version <version>

The rest of the release process depends on your chosen mode:

Release mode (default): If you didn’t specify a mode or set mode: release, no further action is required. Fern automatically tags the new release with your specified version number and initiates the publishing workflow in your SDK repository.
Pull request or push mode: If you set mode: pull-request or mode: push, Fern creates a pull request or pushes to a branch respectively. Review and merge the PR (pull-request) or branch (push), then tag a new release to initiate the publishing workflow in your SDK repository.

工作流完成后，您可以通过登录 NuGet 并导航到 Manage Packages 来查看您的新发布。

将您的公开 Fern C#/.NET SDK 发布到 NuGet 注册表。按照本页面的步骤操作后，您将在 NuGet 上发布一个版本化的包。

本页面假设您已有：

一个已初始化的 fern 文件夹、一个用于 C#/.NET SDK 的 GitHub 仓库，以及在 generators.yml 中的一个 C#/.NET 生成器组。参见生成 SDK (C#/.NET)。

配置 SDK 包设置

配置 `output` 位置

在您的 C#/.NET SDK 的 group 中，将输出位置从 local-file-system（默认值）更改为 nuget，以指示 Fern 应该直接将您的包发布到 npm 注册表：

generators.yml

1 groups: 
2   csharp-sdk:
3 	generators:
4 	  - name: fernapi/fern-csharp-sdk
5 	    version: 2.65.0
6 		output:
7 		  location: nuget

添加唯一的包名称

您的包名称在 NuGet 仓库中必须是唯一的，否则将您的 SDK 发布到 NuGet 将失败。

generators.yml

1 groups: 
2   csharp-sdk:
3 	generators:
4 	  - name: fernapi/fern-csharp-sdk
5 		version: 2.65.0
6 		output:
7 		  location: nuget
8 		  package-name: your-package-name

配置 `client-class-name`

client-class-name 选项控制生成的客户端的名称。这是客户使用的导入您的 SDK 的名称（import { your-client-name } from 'your-package-name';）。

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9         config:
10           client_class_name: YourClientName # 必须是 PascalCase

生成 NuGet API 密钥

登录 NuGet

添加新密钥

点击您的个人资料图片。
选择 API Keys，然后 Create。
为您的密钥命名。
选择 Push > Push new packages and package versions 作为 Select Scopes 类型。
在 Select Packages > Glob Patten 下输入 *。

替换现有的 NuGet 包
如果您要覆盖现有包，可以选择相关包而不是输入 *。
点击 Create。

保存您的新密钥 - 离开页面后将不再显示。

配置 NuGet 发布

添加仓库位置

添加包含您的 C#/.NET SDK 的 GitHub 仓库路径：

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9         config:
10           client_class_name: YourClientName
11         github: 
12           repository: your-org/company-csharp

配置 NuGet 身份验证密钥

将 api-key: ${NUGET_API_KEY} 添加到 generators.yml，告诉 Fern 在发布到 NuGet 注册表时使用 NUGET_API_KEY 环境变量进行身份验证。

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9           api-key: ${NUGET_API_KEY}
10         config:
11           client_class_name: YourClientName
12         github: 
13           repository: your-org/company-csharp

选择您的发布模式

Optionally set the mode to control how Fern handles SDK publishing:

mode: release (default): Fern generates code, commits to the default branch (or the branch you specify), and tags a release automatically
mode: pull-request (recommended): Fern generates code and creates a PR for you to review before release
mode: push: Fern generates code and pushes to a branch you specify for you to review before release

You can also configure other settings, like the reviewers or license. Refer to the full github (generators.yml) reference for more information.

generators.yml

1 groups: 
2   csharp-sdk:
3     generators:
4       - name: fernapi/fern-csharp-sdk
5         version: 2.65.0
6         output:
7           location: nuget
8           package-name: your-package-name
9           api-key: ${NUGET_API_KEY}
10         config:
11           client_class_name: YourClientName
12         github: 
13           repository: your-org/company-csharp
14 		  mode: push
15 		  branch: your-branch-name # mode: push 时必需

发布您的 SDK

决定如何将您的 SDK 发布到 NuGet。您可以使用 GitHub 工作流进行自动化发布，或通过 CLI 直接发布。

通过 GitHub 工作流发布

通过 GitHub Actions 设置发布工作流，这样您就可以直接从源代码仓库触发新的 SDK 发布。

设置身份验证

在 GitHub 中打开您的源代码仓库。点击 Settings 标签。然后，在 Security 部分下，打开 Secrets and variables > Actions。

您也可以使用 URL https://github.com/<your-repo>/settings/secrets/actions。

为您的 NuGet API 密钥添加密钥

选择 New repository secret。
将您的密钥命名为 NUGET_API_KEY。
添加您在上面生成的相应 API 密钥。
点击 Add secret。

为您的 Fern Token 添加密钥

选择 New repository secret。
将您的密钥命名为 FERN_TOKEN。
添加您的 Fern token。如果您还没有，可以通过运行 fern token 来生成一个。默认情况下，fern_token 是为 fern.config.json 中列出的组织生成的。
点击 Add secret。

设置新的工作流

.github/workflows/publish.yml

1 name: Publish C#/.NET SDK
2 
3 on:
4   workflow_dispatch:
5     inputs:
6       version:
7         description: "您想要发布的 C#/.NET SDK 的版本"
8         required: true
9         type: string
10 
11 jobs:
12   release:
13     runs-on: ubuntu-latest
14     steps:
15       - name: Checkout repo
16         uses: actions/checkout@v4
17 
18       - name: Install Fern CLI
19         run: npm install -g fern-api
20 
21       - name: Release C#/.NET SDK
22         env:
23           FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
24           NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
25         run: |
26           fern generate --group csharp-sdk --version ${{ inputs.version }} --log-level debug

您也可以配置您的工作流为 on: [push] 执行。参见 Vapi 的 npm 发布 GitHub Action 作为示例。

重新生成并发布您的 SDK

导航到 Actions 标签，选择您刚创建的工作流，指定一个版本号，然后点击 Run workflow。这将重新生成您的 SDK。

The rest of the release process depends on your chosen mode:

Release mode (default): If you didn’t specify a mode or set mode: release, no further action is required. Fern automatically tags the new release with your specified version number and initiates the publishing workflow in your SDK repository.
Pull request or push mode: If you set mode: pull-request or mode: push, Fern creates a pull request or pushes to a branch respectively. Review and merge the PR (pull-request) or branch (push), then tag a new release to initiate the publishing workflow in your SDK repository.

工作流完成后，您可以通过登录 NuGet 并导航到 Manage Packages 来查看您的新发布。

通过 CLI 和环境变量发布

设置 npm 环境变量

在本地机器上设置 NUGET_API_KEY 环境变量：

$ export NUGET_API_KEY=your-actual-nuget-api-key

重新生成并发布您的 SDK

重新生成您的 SDK，指定版本：

$ fern generate --group csharp-sdk --version <version>

The rest of the release process depends on your chosen mode:

Release mode (default): If you didn’t specify a mode or set mode: release, no further action is required. Fern automatically tags the new release with your specified version number and initiates the publishing workflow in your SDK repository.
Pull request or push mode: If you set mode: pull-request or mode: push, Fern creates a pull request or pushes to a branch respectively. Review and merge the PR (pull-request) or branch (push), then tag a new release to initiate the publishing workflow in your SDK repository.

工作流完成后，您可以通过登录 NuGet 并导航到 Manage Packages 来查看您的新发布。

1	groups:
2	csharp-sdk:
3	generators:
4	- name: fernapi/fern-csharp-sdk
5	version: 2.65.0
6	output:
7	location: nuget

1	name: Publish C#/.NET SDK
2
3	on:
4	workflow_dispatch:
5	inputs:
6	version:
7	description: "您想要发布的 C#/.NET SDK 的版本"
8	required: true
9	type: string
10
11	jobs:
12	release:
13	runs-on: ubuntu-latest
14	steps:
15	- name: Checkout repo
16	uses: actions/checkout@v4
17
18	- name: Install Fern CLI
19	run: npm install -g fern-api
20
21	- name: Release C#/.NET SDK
22	env:
23	FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
24	NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
25	run: \|
26	fern generate --group csharp-sdk --version ${{ inputs.version }} --log-level debug

配置 SDK 包设置

配置 output 位置

添加唯一的包名称

配置 client-class-name

生成 NuGet API 密钥

登录 NuGet

添加新密钥

替换现有的 NuGet 包

配置 NuGet 发布

添加仓库位置

配置 NuGet 身份验证密钥

选择您的发布模式

发布您的 SDK

通过 GitHub 工作流发布

设置身份验证

为您的 NuGet API 密钥添加密钥

为您的 Fern Token 添加密钥

设置新的工作流

重新生成并发布您的 SDK

通过 CLI 和环境变量发布

设置 npm 环境变量

重新生成并发布您的 SDK

配置 SDK 包设置

配置 output 位置

添加唯一的包名称

配置 client-class-name

生成 NuGet API 密钥

登录 NuGet

添加新密钥

替换现有的 NuGet 包

配置 NuGet 发布

添加仓库位置

配置 NuGet 身份验证密钥

选择您的发布模式

发布您的 SDK

通过 GitHub 工作流发布

设置身份验证

为您的 NuGet API 密钥添加密钥

为您的 Fern Token 添加密钥

设置新的工作流

重新生成并发布您的 SDK

通过 CLI 和环境变量发布

设置 npm 环境变量

重新生成并发布您的 SDK

配置 `output` 位置

配置 `client-class-name`

配置 `output` 位置

配置 `client-class-name`