添加自定义代码（Ruby） | Fern Documentation

本页面介绍如何向您的 Ruby SDK 添加自定义逻辑、方法和依赖项。

Before getting started, read about how Fern SDKs use custom code and learn about the .fernignore file.

添加自定义逻辑

开始添加自定义代码：

创建新文件并添加自定义逻辑

lib/<gem_name>/helper.rb

1 module YourGem
2   class Helper
3     def self.my_helper
4       puts "Hello World!"
5     end
6   end
7 end

将文件添加到 `.fernignore`

.fernignore

1 # 指定不应被 Fern 修改的文件
2 
3 lib/<gem_name>/helper.rb

使用辅助方法

Now your users can consume the helper function by importing it from the SDK.

1 require "your_gem"
2 
3 YourGem::Helper.my_helper

添加自定义 SDK 方法

Fern also allows you to add custom methods to the SDK itself (e.g. client.my_method() ) by inheriting the Fern generated client and then extending it.

更新 `generators.yml` 配置

将您的 Fern 生成的客户端命名为 BaseClient 之类的名称，以反映该客户端将被扩展。

generators.yml

1 - name: fernapi/fern-ruby-sdk
2   version: 1.11.1
3   config:
4     clientClassName: BaseClient

导入并扩展生成的客户端

首先，导入 Fern 生成的基础客户端并扩展它。然后，添加您想要的任何方法。

lib/<gem_name>/my_client.rb

1 require_relative "client"
2 
3 module YourGem
4   class MyClient < BaseClient
5     def my_helper
6       puts "Hello World!"
7     end
8   end
9 end

更新 `.fernignore`

将 my_client.rb 添加到 .fernignore。

.fernignore

1 + lib/<gem_name>/my_client.rb

使用方法

您的用户需要构造扩展的客户端，而不是生成的客户端。

1 require "your_gem"
2 
3 client = YourGem::MyClient.new

Now your users can consume the helper function by importing it from the SDK.

1 client.my_helper

添加自定义依赖项

专业版和企业版功能

此功能仅适用于专业版和企业版计划。如需开始使用，请联系 support@buildwithfern.com。

要添加自定义代码所需的 gem，请更新您的 generators.yml。