# 引力Skill快速接入SDK

> 来源：https://help.gravity-engine.com/docs/client-sdk/ai-skill
> 说明如何下载并安装 Gravity Engine 集成 Skill，让编码智能体结合本地项目与官方文档完成 SDK 接入。







## 1. 准备工作 [#1-准备工作]

* 准备好本地项目（iOS / Android / Flutter / Unity 等）
* **下载配套文件**：
  * Skill 压缩包：[integration-gravity-engine-1.0.1.zip](https://resource.helplook.net/docker_production/p4xbdk/article/1XGyl60w/attachments/integration-gravity-engine-1.0.1.zip "integration-gravity-engine-1.0.1.zip")

## 2. 引入 Skill [#2-引入-skill]

在支持的 AI 工具（如 Claude Code、Cursor 等）中加载该 Skill 解压后的文件夹。

## 3. 使用指令 [#3-使用指令]

在项目目录下向 AI 发送以下任一指令：

| 指令                 | 效果                          |
| ------------------ | --------------------------- |
| 接入引力引擎SDK          | 自动识别引擎，引入国内版 SDK，默认国内节点     |
| 接入引力引擎海外SDK        | 同上，但引入海外版 SDK，配置海外域名        |
| 使用pod方式接入引力引擎国内SDK | 强制用 CocoaPods 安装国内版 iOS SDK |

AI 会自动修改项目文件、添加依赖、生成初始化代码。

<img src="__img0" />

## 4. 执行完成后 [#4-执行完成后]

### 4.1 结果示例 [#41-结果示例]

<img src="__img1" />

1. AI 仅自动引入 SDK，自动添加 `setupAndStart` 和 `initialize` 方法，其他如 `track`、`setUser` 等调用需开发者自行补充。
2. AI 添加 `setupAndStart` 时，`your_access_token` 和 `appid` 均为固定占位符，需开发者替换为真实值。
3. 部分小游戏平台（微信、快手、抖音、B站）AI 会自动通过 `getOpenId` 方法获取 openid 并设为 clientId，开发者需在引力后台配置对应的 token，具体参考配置文档：[引力：SDK快捷获取openid合集](https://gravityengine.feishu.cn/wiki/Za4VwRXToic3JskBKHwcsWm8nLe)
4. 不支持 `getOpenId` 的小游戏平台，需开发者自行获取对应 ID 并设置为 clientId。
5. `setupAndStart` 由 AI 自动识别并添加，但开发者需确认初始化时机，确保在用户同意隐私后再调用。
6. 部分引擎可能还需要其他配置，请根据 AI 执行后的输出提示进行补充。

请仔细阅读 AI 输出的提示信息。AI 会告知哪些步骤已自动完成，以及哪些事项需要你手动处理（例如填写 `Token`、配置隐私权限等）。不同 AI 工具的提示内容可能不同，以实际输出为准。