@leonxin/meetgames 0.1.8 → 0.1.11

package/docs/API.md

@@ -1,47 +1,261 @@
-# meet-sdk-tool 相关 HTTP 接口汇总
+# API 说明
 
-本文档汇总 **meet-sdk-tool** 可能接触或对齐的远程接口，便于联调与字段对照。样例 JSON 放在 [`fixtures/api-samples/`](../fixtures/api-samples/)（**已脱敏**，勿把含 `appSecret` / 私钥的原文提交到仓库）。
+`meet-sdk-tool` 当前有两类远端接口：
 
-## 与本工具 CLI 的关系
+| 接口 | 服务 | 用途 |
+|---|---|---|
+| `GET {baseUrl}/console/openSDK/downloadSDKConfig` | gp-sdk console | 生成并下载宿主工程集成所需的 `meetsdk-remote-config.json` |
+| `GET https://business-api.meetgames.com/sdk/home/version` | sdk-home | 获取下载中心展示的 Android / iOS 最新 SDK 版本和发布日期 |
+| `GET https://business-api.meetgames.com/sdk/home/sdk-download/getDownLoadUrl` | sdk-home | 根据版本、平台、插件和包类型获取 SDK zip 临时下载地址 |
 
-| 接口 | meet-sdk-tool 是否调用 | CLI / 命令 |
-|------|------------------------|------------|
-| [downloadSDKConfig](./api/downloadSDKConfig.md) | **是（当前主路径）** | `fetch-config`、`setup` |
-| [getSDKConfig](./api/getSDKConfig.md) | 否（库内有实现，可映射 JSON） | — |
-| [getChannelConfig（MeetGames 运营后台）](./api/getChannelConfig-meetgames.md) | **否** | — |
+`downloadSDKConfig` 用于宿主工程配置；sdk-home 版本接口用于 Android 接入时解析最新 SDK 版本并写入 `meetsdk-android.json`，也用于 iOS SDK 下载时解析最新版本并写入 `meetsdk-ios.json`；sdk-home 下载接口用于同步工具包内置 iOS SDK 资源到 `bundled/ios-sdk`。
 
-`integrate` / `doctor` **不请求 HTTP**，只读本地 `meetsdk-remote-config.json` 与工程文件。
+## CLI 使用关系
 
-## 环境 Base URL
+| 命令 | 是否请求接口 | 说明 |
+|---|---:|---|
+| `fetch-config` | 是 | 拉取并写入 `meetsdk-remote-config.json` |
+| `setup` | 是 | 第一步执行 `fetch-config`；Android 集成阶段还会读取 sdk-home 最新 Android 版本并写入 `meetsdk-android.json` |
+| `doctor` | 是 | 第一步执行 `fetch-config`；Android 检查阶段还会读取 sdk-home 最新 Android 版本并写入 `meetsdk-android.json` |
+| `integrate` | Android 是 / iOS 否 | Android 读取 sdk-home 最新 Android 版本，写入 `meetsdk-android.json`，再写入 Gradle；iOS 只读取本地 `meetsdk-remote-config.json` 和 bundled SDK |
+| `download-ios-sdk` | 是 | 先读 sdk-home 最新 iOS 版本，再取 SDK zip URL，下载并解压到 `bundled/ios-sdk`，成功后写入 `meetsdk-ios.json` |
 
-| 环境 | gp-sdk `openSDK`（download / getSDKConfig） | 说明 |
-|------|-------------------------------------------|------|
-| `prod` | `https://api-sdk-gameplus.meetsocial.com/` | CLI `--env prod`（默认） |
-| `pre` | `https://pre-api-sdk-gameplus.meetsocial.com/` | CLI `--env pre` |
-| `test` | `https://test-api-sdk-gameplus.meetsocial.com/` | CLI `--env test` |
-| 覆盖 | 环境变量 `TOPSDK_API_BASE_URL` | 如本机 console：`http://localhost:18080/` |
+## downloadSDKConfig
 
-MeetGames **业务网关**（如 `getChannelConfig`）与 gp-sdk 主机不同，见各接口文档。
+### 请求
 
-## 文档索引
+| 项 | 值 |
+|---|---|
+| 方法 | `GET` |
+| 路径 | `{baseUrl}console/openSDK/downloadSDKConfig` |
+| Query | `appId`、`channelType`、`sign`、`timestamp` |
+| 签名 | `sign = base64(md5_binary(appId + appSecret + timestamp))` |
+| timestamp | 毫秒时间戳 |
 
-1. [downloadSDKConfig](./api/downloadSDKConfig.md) — gp-sdk 组装 `meetsdk-remote-config.json` 并下载  
-2. [getSDKConfig](./api/getSDKConfig.md) — gp-sdk 旧接口，需 sign，返回 `channelAuthConfig`  
-3. [getChannelConfig（MeetGames）](./api/getChannelConfig-meetgames.md) — 运营后台渠道配置 VO，含 `authConfigs` / `thirdDataPlatform` / `parameterConfig`  
+示例：
 
-## 本地落盘格式
+```http
+GET http://127.0.0.1:8081/console/openSDK/downloadSDKConfig?appId=791251136341225472&channelType=APPLE&sign=...&timestamp=...
+```
 
-无论通过哪条接口理解字段，**集成流水线只消费**工程根目录的：
+CLI：
 
-[`meetsdk-remote-config.json`](../fixtures/meetsdk-remote-config.mock.json)（结构见 [`src/config/meetSdkRemoteConfig.ts`](../src/config/meetSdkRemoteConfig.ts)、JSON Schema [`schema/meetsdk-remote-config.schema.json`](../schema/meetsdk-remote-config.schema.json)）
+```bash
+TOPSDK_API_BASE_URL=http://127.0.0.1:8081/ \
+node dist/entry.js fetch-config \
+  --app-id 791251136341225472 \
+  --app-secret 'YOUR_APP_SECRET' \
+  --channel-type APPLE \
+  --project-root ./fixtures/ios-test-project/tooltest \
+  --env test \
+  --verbose
+```
 
-固定 Gradle 仓库、SDK 版本、依赖坐标由 [`meetsdk-android.json`](../meetsdk-android.json) 在 `integrate` 时合并。
+### Base URL
 
-## 代码入口
+| 环境 | Base URL |
+|---|---|
+| `prod` | `https://api-sdk-gameplus.meetsocial.com/` |
+| `pre` | `https://pre-api-sdk-gameplus.meetsocial.com/` |
+| `test` | `https://test-api-sdk-gameplus.meetsocial.com/` |
+| 本地覆盖 | `TOPSDK_API_BASE_URL=http://127.0.0.1:8081/` |
 
-| 能力 | 源文件 |
-|------|--------|
-| downloadSDKConfig 客户端 | [`src/remote/topsdkDownloadSdkConfig.ts`](../src/remote/topsdkDownloadSdkConfig.ts) |
-| getSDKConfig 客户端 | [`src/remote/topsdkGetSdkConfig.ts`](../src/remote/topsdkGetSdkConfig.ts) |
-| 响应 → meetsdk 形 | [`src/config/meetSdkRemoteConfig.ts`](../src/config/meetSdkRemoteConfig.ts) |
-| gp-sdk 服务端组装 | `gp-sdk/console/.../SdkConfigDownloadServiceImpl.java` |
+`TOPSDK_API_BASE_URL` 优先级最高。
+
+### 响应
+
+响应 body 是完整 `meetsdk-remote-config.json`，不是 `{ code, data }` 包装。
+
+`fetch-config`、`setup`、`doctor` 会把响应原文写入：
+
+```text
+<project-root>/meetsdk-remote-config.json
+```
+
+### JSON 数据来源
+
+| JSON 路径 | 数据来源 | 说明 |
+|---|---|---|
+| `packageName` | `channel.package_name` | Android package / iOS bundle 相关标识 |
+| `channel` | `channel.channel_type` | 例如 `GOOGLE` / `APPLE` |
+| `devicePlatform` | `channel.device_platform` | `android` / `ios` |
+| `topsdk.appId` | `app.id` | 应用 ID |
+| `topsdk.appSecret` | `app.secret` | 应用密钥 |
+| `sdkModules.login.*` | `channel_auth` | key 使用 authType 小写；字段使用 `DTOChannelAuth` 原字段 |
+| `sdkModules.payment.*` | `channel_payment` | IAP 平台配置 |
+| `sdkModules.analytics.*` | `channel_third_data_platform` | AppsFlyer / Firebase / Adjust 等 |
+
+### 字段规则
+
+`downloadSDKConfig` 只输出数据库原始字段中有 value 的 key。
+
+登录渠道字段来自 `DTOChannelAuth`：
+
+```text
+clientId
+secret
+redirect
+scheme
+name
+```
+
+如果数据库没有 `scheme`，JSON 不输出 `scheme`。  
+如果数据库没有 `name`，JSON 不输出 `name`。  
+服务端不做推导、不写空字符串占位。
+
+示例：
+
+```json
+{
+  "sdkModules": {
+    "login": {
+      "facebook": {
+        "clientId": "883695101201170",
+        "scheme": "fb883695101201170",
+        "secret": "client-token",
+        "name": "top-demo"
+      }
+    }
+  }
+}
+```
+
+### 固定 SDK 配置
+
+`downloadSDKConfig` 不返回 SDK 版本、Maven 仓库、依赖坐标、Firebase Gradle plugin 等固定集成配置。
+
+Maven 仓库、依赖坐标、Firebase Gradle plugin 等由工具内置文件提供：
+
+```text
+meetsdk-android.json
+```
+
+Android SDK 版本也存放在 `meetsdk-android.json`。`integrate` / `doctor` 处理 Android 工程时，会调用 sdk-home `version` 接口读取 `data.result.android.ver` / `date`，写入 `meetsdk-android.json` 的 `topsdk.version` / `topsdk.date`，再合并为 Gradle 的 `topsdk_version`。
+
+iOS SDK 固定配置存放在：
+
+```text
+meetsdk-ios.json
+```
+
+该文件用于记录工具包当前 bundled iOS SDK 对应的版本、发布日期、包类型和插件组合。
+
+## sdk-home 版本与 SDK 下载接口
+
+这两个接口对应 MeetGames 下载页：
+
+```text
+https://business.meetgames.com/sdkDownloadDetail?type=ios
+```
+
+工具侧用途是读取下载中心维护的 SDK 版本与 SDK 包下载地址。它们不返回宿主工程渠道参数，也不替代 `downloadSDKConfig`。
+
+### Base URL
+
+| 环境 | Base URL |
+|---|---|
+| 生产 | `https://business-api.meetgames.com` |
+| 覆盖 | `MEETGAMES_SDK_HOME_API_BASE_URL=https://...` 或 CLI `--sdk-api-base-url` |
+
+### version
+
+用途：获取下载中心当前展示的最新 SDK 版本。
+
+- Android `integrate` / `setup` / `doctor` 会读取 `data.result.android.ver` / `date`，先写入 `meetsdk-android.json`，再用于写入或校验 Gradle 中的 `topsdk_version`。
+- `download-ios-sdk` 未显式传 `--version` 时，会读取 `data.result.ios.ver` / `date` 作为下载版本；下载和解压成功后写入 `meetsdk-ios.json`。
+
+请求：
+
+```http
+GET https://business-api.meetgames.com/sdk/home/version
+```
+
+响应示例：
+
+```json
+{
+  "code": 200,
+  "error": null,
+  "message": null,
+  "data": {
+    "result": {
+      "android": {
+        "date": "2026-05-25",
+        "ver": "1.6.1.3"
+      },
+      "ios": {
+        "date": "2026-06-09",
+        "ver": "1.6.0.5"
+      }
+    },
+    "success": true
+  }
+}
+```
+
+工具只读取：
+
+```text
+data.result.android.ver
+data.result.android.date
+data.result.ios.ver
+data.result.ios.date
+```
+
+### getDownLoadUrl
+
+用途：让 sdk-home 根据页面选项定位或生成 SDK zip，并返回 OSS / COS 临时下载地址。`download-ios-sdk` 用返回的 `data` 下载 zip，保存为：
+
+```text
+<package-root>/bundled/ios-sdk/topSDK-ios--V{version}.zip
+```
+
+随后解压到：
+
+```text
+<package-root>/bundled/ios-sdk
+```
+
+下载和解压成功后，工具会更新：
+
+```text
+<package-root>/meetsdk-ios.json
+```
+
+请求：
+
+| Query | 说明 | 默认值 |
+|---|---|---|
+| `version` | SDK 版本；默认来自 `version` 接口的 `data.result.ios.ver` | 最新 iOS 版本 |
+| `platform` | 平台 | `ios` |
+| `plugins` | 逗号分隔插件列表 | `guest,facebook,google,apple,apple_pay,dataAppsFlyer` |
+| `packageType` | 包类型 / 引擎 | `native` |
+
+示例：
+
+```http
+GET https://business-api.meetgames.com/sdk/home/sdk-download/getDownLoadUrl?version=1.6.0.5&platform=ios&plugins=guest,facebook,google,apple,apple_pay,dataAppsFlyer&packageType=native
+```
+
+响应示例：
+
+```json
+{
+  "code": 200,
+  "error": null,
+  "message": null,
+  "data": "https://gz-publicread-fspan-1302967645.cos.ap-guangzhou.myqcloud.com/sdk-home/xxx.zip?sign=..."
+}
+```
+
+`data` 是短期有效下载 URL。不要把该 URL 固化到配置或文档中；需要下载时重新请求 `getDownLoadUrl`。
+
+## 归档接口
+
+旧接口和对照接口已归档：
+
+| 文档 | 说明 |
+|---|---|
+| [archive/api/downloadSDKConfig.md](./archive/api/downloadSDKConfig.md) | 历史详细接口说明 |
+| [archive/api/getSDKConfig.md](./archive/api/getSDKConfig.md) | 旧 `getSDKConfig` 接口 |
+| [archive/api/getChannelConfig-meetgames.md](./archive/api/getChannelConfig-meetgames.md) | MeetGames 后台接口对照 |

package/docs/CLI.md

@@ -0,0 +1,292 @@
+# meetgames CLI 参数说明
+
+本文档说明 `meetgames` CLI 的子命令、参数和环境变量。实现以 `src/cli.ts` 为准。
+
+## 子命令
+
+| 子命令 | 作用 | 是否写文件 |
+|---|---|---|
+| `fetch-config` | 请求 `downloadSDKConfig`，将响应原文写入 `<project-root>/meetsdk-remote-config.json` | 是 |
+| `download-ios-sdk` | 请求 sdk-home 版本和下载接口，下载 iOS SDK zip 并解压到 `bundled/ios-sdk`，更新 `meetsdk-ios.json` | 是 |
+| `integrate` | 读取本地配置并接入 Android 或 iOS SDK；Android 会请求 sdk-home 最新版本并更新 `meetsdk-android.json` | 默认写；`--dry-run` 时不写宿主工程文件 |
+| `setup` | 先执行 `fetch-config`，再执行 `integrate`；Android 集成阶段会请求 sdk-home 最新版本并更新 `meetsdk-android.json` | 是；集成阶段受 `--dry-run` 影响 |
+| `doctor` | 先执行 `fetch-config`，再检查当前工程 SDK 接入是否正确；Android 检查阶段会请求 sdk-home 最新版本并更新 `meetsdk-android.json` | 是，会刷新 `meetsdk-remote-config.json` |
+
+`doctor`、`setup`、`integrate` 都要求传入 `--project-root`。工具会根据该路径自动识别 Android 或 iOS，并且只执行对应平台逻辑。
+Android `integrate` / `setup` / `doctor` 会调用 sdk-home `version` 接口读取最新 Android SDK 版本，写入 `meetsdk-android.json`，并写入或校验 Gradle 中的 `topsdk_version`。
+`download-ios-sdk` 面向工具包自身的内置 iOS SDK 资源，不需要传 `--project-root`。
+
+## 通用示例
+
+```bash
+node dist/entry.js setup \
+  --app-id <APP_ID> \
+  --app-secret '<APP_SECRET>' \
+  --channel-type GOOGLE \
+  --project-root /path/to/project \
+  --env test \
+  --verbose
+```
+
+iOS 多 App target 工程建议显式指定 target：
+
+```bash
+node dist/entry.js setup \
+  --app-id <APP_ID> \
+  --app-secret '<APP_SECRET>' \
+  --channel-type APPLE \
+  --project-root /path/to/ios-project \
+  --app-target GameRelease \
+  --env test \
+  --verbose
+```
+
+Android 多 application module 工程建议显式指定 app module：
+
+```bash
+node dist/entry.js setup \
+  --app-id <APP_ID> \
+  --app-secret '<APP_SECRET>' \
+  --channel-type GOOGLE \
+  --project-root /path/to/android-project \
+  --app-target :app \
+  --env test \
+  --verbose
+```
+
+```bash
+node dist/entry.js doctor \
+  --app-id <APP_ID> \
+  --app-secret '<APP_SECRET>' \
+  --channel-type GOOGLE \
+  --project-root /path/to/project \
+  --env test \
+  --verbose
+```
+
+刷新工具内置 iOS SDK：
+
+```bash
+node dist/entry.js download-ios-sdk --verbose
+```
+
+指定版本或插件组合：
+
+```bash
+node dist/entry.js download-ios-sdk \
+  --version 1.6.0.5 \
+  --plugins guest,facebook,google,apple,apple_pay,dataAppsFlyer \
+  --package-type native \
+  --verbose
+```
+
+## 参数
+
+| 参数 | `fetch-config` | `integrate` | `setup` | `doctor` | 说明 |
+|---|---:|---:|---:|---:|---|
+| `--project-root <path>` | 可选 | 必填 | 必填 | 必填 | 宿主工程目录；iOS 可传工程目录或 `.xcodeproj` 目录 |
+| `--app-target <target>` | 否 | 可选 | 可选 | 可选 | 统一指定要接入/检查的 App 目标；Android 传 application module（如 `:app` / `app`），iOS 传 App target 名 |
+| `--app-id <id>` | 必填* | 否 | 必填* | 必填* | 应用 ID；也可用 `TOPSDK_APP_ID` |
+| `--app-secret <secret>` | 必填* | 否 | 必填* | 必填* | 用于计算接口签名；也可用 `TOPSDK_APP_SECRET` |
+| `--channel-type <type>` | 必填* | 否 | 必填* | 必填* | 渠道类型，如 `GOOGLE` / `APPLE`；也可用 `TOPSDK_CHANNEL_TYPE` |
+| `--env prod|pre|test` | 是 | 否 | 是 | 是 | 默认 `prod` |
+| `--dry-run` | 忽略 | 是 | 是 | 否 | 只预览集成改动，不写工程文件；`setup` 的 fetch 步骤仍会写配置 |
+| `--patch-file <path>` | 忽略 | 是 | 是 | 否 | 输出 dry-run patch |
+| `--report-file <path>` | 忽略 | 是 | 是 | 否 | 输出 JSON report |
+| `--sdk-api-base-url <url>` | 否 | Android 可选 | Android 可选 | Android 可选 | 覆盖 sdk-home API 根地址；用于 Android 最新版本查询，也用于 `download-ios-sdk` |
+| `--verbose` | 是 | 是 | 是 | 是 | 输出详细日志 |
+
+`*` 表示如果本地已有可解析配置或环境变量提供对应值，可以不在命令行显式传入。`appSecret` 不会从本地 `meetsdk-remote-config.json` 读取。
+
+### download-ios-sdk 专用参数
+
+| 参数 | 说明 |
+|---|---|
+| `--version <version>` | 指定下载的 iOS SDK 版本；不传时先调用 sdk-home `version` 接口读取最新 iOS 版本 |
+| `--plugins <csv>` | 逗号分隔插件列表；默认 `guest,facebook,google,apple,apple_pay,dataAppsFlyer`，与下载页 iOS 默认选择一致 |
+| `--package-type native|unity|cocos` | 包类型 / 引擎；默认 `native` |
+| `--output-dir <path>` | zip 保存和解压目录；默认 `<package-root>/bundled/ios-sdk` |
+
+该命令会把 zip 保存为：
+
+```text
+<package-root>/bundled/ios-sdk/topSDK-ios--V{version}.zip
+```
+
+并把压缩包内容解压到：
+
+```text
+<package-root>/bundled/ios-sdk
+```
+
+## 环境变量
+
+| 环境变量 | 作用 |
+|---|---|
+| `TOPSDK_API_BASE_URL` | 覆盖 API 根地址，例如 `http://127.0.0.1:8081/` |
+| `TOPSDK_APP_ID` | `fetch-config` / `setup` / `doctor` 默认 appId |
+| `TOPSDK_APP_SECRET` | 默认 appSecret |
+| `TOPSDK_CHANNEL_TYPE` | 默认 channelType |
+| `MEETGAMES_SDK_HOME_API_BASE_URL` | sdk-home API 根地址；用于 Android 最新版本查询和 `download-ios-sdk` |
+
+## 环境地址
+
+| `--env` | 默认 Base URL |
+|---|---|
+| `prod` | `https://api-sdk-gameplus.meetsocial.com/` |
+| `pre` | `https://pre-api-sdk-gameplus.meetsocial.com/` |
+| `test` | `https://test-api-sdk-gameplus.meetsocial.com/` |
+
+`TOPSDK_API_BASE_URL` 优先级最高。
+
+## 子命令说明
+
+### fetch-config
+
+```bash
+node dist/entry.js fetch-config \
+  --app-id <APP_ID> \
+  --app-secret '<APP_SECRET>' \
+  --channel-type GOOGLE \
+  --project-root /path/to/project \
+  --env test
+```
+
+调用：
+
+```text
+GET {baseUrl}/console/openSDK/downloadSDKConfig
+```
+
+并将响应 bytes 原样写入：
+
+```text
+<project-root>/meetsdk-remote-config.json
+```
+
+### integrate
+
+```bash
+node dist/entry.js integrate \
+  --project-root /path/to/project \
+  --dry-run \
+  --verbose
+```
+
+读取本地 `meetsdk-remote-config.json` 和内置 recipe：
+
+```text
+recipes/integrate-default.yaml
+```
+
+根据 `--project-root` 识别平台，只执行 Android 或 iOS 的接入步骤。
+
+Android 接入会先调用：
+
+```text
+GET https://business-api.meetgames.com/sdk/home/version
+```
+
+用途：读取 `data.result.android.ver` / `date`，写入 `meetsdk-android.json` 的 `topsdk.version` / `topsdk.date`，并作为 Gradle 中的 `topsdk_version`。`meetsdk-android.json` 同时保留 Maven 仓库、依赖坐标、Firebase Gradle plugin 等固定配置。
+
+当 Android 工程中存在多个 application module 时，如果未传 `--app-target`，命令会报出候选 module 列表；传入后会把 Gradle、Manifest、`google-services.json` 等写到选中的 module 下。
+
+传入 `--app-target` 时会校验目标是否存在：Android 校验目标 application module，iOS 校验目标 App target。
+
+### download-ios-sdk
+
+```bash
+node dist/entry.js download-ios-sdk --verbose
+```
+
+执行顺序：
+
+1. 调用 sdk-home 版本接口：
+
+```text
+GET https://business-api.meetgames.com/sdk/home/version
+```
+
+用途：读取下载中心当前 iOS 最新版本，即 `data.result.ios.ver` / `date`。
+
+2. 调用 sdk-home 下载接口：
+
+```text
+GET https://business-api.meetgames.com/sdk/home/sdk-download/getDownLoadUrl
+```
+
+默认 query：
+
+```text
+version=<version接口返回的iOS版本>
+platform=ios
+plugins=guest,facebook,google,apple,apple_pay,dataAppsFlyer
+packageType=native
+```
+
+用途：获取短期有效的 SDK zip 下载 URL。
+
+3. 下载 zip 并解压到工具包内置资源目录：
+
+```text
+bundled/ios-sdk
+```
+
+后续 `integrate` / `doctor` 的 iOS 流程会从该目录读取 `sdk/` 和 `plugins/`。
+
+下载和解压成功后，命令会更新：
+
+```text
+meetsdk-ios.json
+```
+
+用途：记录当前 bundled iOS SDK 对应的版本、发布日期、包类型和插件组合。
+
+### setup
+
+```bash
+node dist/entry.js setup \
+  --app-id <APP_ID> \
+  --app-secret '<APP_SECRET>' \
+  --channel-type APPLE \
+  --project-root /path/to/ios-project \
+  --env test \
+  --verbose
+```
+
+执行顺序：
+
+1. `fetch-config`
+2. `integrate`
+
+### doctor
+
+```bash
+node dist/entry.js doctor \
+  --app-id <APP_ID> \
+  --app-secret '<APP_SECRET>' \
+  --channel-type APPLE \
+  --project-root /path/to/ios-project \
+  --env test \
+  --verbose
+```
+
+执行顺序：
+
+1. `fetch-config`
+2. 自动识别 Android / iOS
+3. 执行对应平台详细校验
+
+Android doctor 会检查仓库、依赖、`resValue`、`google-services.json` 等。  
+iOS doctor 会检查 SDK 文件、Xcode 引用、`GoogleService-Info.plist`、`Info.plist` 参数、插件参数、URL Scheme 是否写入、Delegate 注入等。
+
+## 退出码
+
+| 退出码 | 含义 |
+|---:|---|
+| `0` | 成功 |
+| `2` | 参数错误 |
+| `3` | 工程识别或工程结构错误 |
+| `4` | 配置或 doctor 校验失败 |
+| `5` | 集成 pipeline 失败 |
+| `6` | 网络请求失败 |