@leonxin/meetgames

Meet SDK 集成 CLI：从 gp-sdk 拉取渠道配置，自动修改 Android Gradle / Manifest 与 iOS Xcode 工程。

• 远程配置（每游戏不同）：meetsdk-remote-config.json — 由 fetch-config 从 downloadSDKConfig 原样写入 ~/.cache/meet-sdk-tool
• SDK 配置缓存（全游戏通用）：~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-android.json / ~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-ios.json — download-sdk 从 sdk-home 下载 Android / iOS SDK zip；Android 从包内读取 meetsdk-android.json 写入缓存，iOS 记录本次下载解析出的版本、发布日期、包类型和插件组合

要求 Node.js ≥ 18。宿主工程需为纯原生 Android / iOS 项目。

安装

# 全局安装（推荐 CI / 本地反复使用）
npm install -g @leonxin/meetgames

# 或一次性执行
npx @leonxin/meetgames@latest --help

安装后可使用命令 meetgames 与 meetgames-mcp（MCP 服务）。

快速开始

# 1. 检测工程
meetgames doctor --project-root /path/to/android-project

# 2. 拉取远程配置 → ~/.cache/meet-sdk-tool
meetgames fetch-config \
  --project-root /path/to/android-project \
  --app-id 791251136341225472 \
  --app-secret '<APP_SECRET>' \
  --channel-type GOOGLE \
  --env test

# 3. 集成（可先 --dry-run 预览）
meetgames integrate --project-root /path/to/android-project --dry-run --verbose

# 4. 拉取 + 集成一步完成
meetgames setup \
  --project-root /path/to/android-project \
  --app-id 791251136341225472 \
  --app-secret '<APP_SECRET>' \
  --channel-type GOOGLE \
  --env test

环境变量

| 变量 | 说明 | |------|------| | TOPSDK_API_BASE_URL | 覆盖 API 根地址（本地 gp-sdk console 联调） | | TOPSDK_CHANNEL_TYPE | 默认渠道类型 | | TOPSDK_APP_ID | 默认 appId |

默认 API 环境由 --env 控制：prod（默认）/ pre / test。

本地 console 示例：

TOPSDK_API_BASE_URL=http://localhost:8081/ \
meetgames fetch-config \
  --project-root . \
  --app-id <appId> \
  --app-secret <appSecret> \
  --channel-type GOOGLE

子命令

| 命令 | 作用 | |------|------| | doctor | 检测工程类型与路径 | | fetch-config | POST downloadSDKConfig，原样写入 ~/.cache/meet-sdk-tool | | integrate | 按内置 recipe 修改 Gradle / Manifest / iOS 工程；读取 download-sdk 已准备好的 SDK 缓存 | | setup | fetch-config + download-sdk + integrate | | download-sdk | 从 sdk-home 获取 Android / iOS SDK 下载地址；Android 写入 meetsdk-android.json 缓存，iOS 下载 native zip 并解压到 ~/.cache/meet-sdk-tool/sdk/ios |

常用参数：--project-root、--sdk-module、--dry-run、--verbose。

多 App 入口工程建议显式指定目标：

# Android 多 application module
meetgames integrate \
  --project-root /path/to/android-project \
  --app-target :app \
  --sdk-module :unityLibrary

# Android 原生工程把 SDK 配置写入 app module
meetgames integrate \
  --project-root /path/to/android-project \
  --app-target :app \
  --sdk-module :app

# iOS 多 App target
meetgames integrate \
  --project-root /path/to/ios-project \
  --app-target GameRelease

从源码开发

源码为内部私有仓库，请向团队获取访问权限后 clone，或在本地直接开发：

cd meet-sdk-tool
npm install
npm run build
npm test

node dist/entry.js doctor \
  --app-id <APP_ID> \
  --app-secret '<APP_SECRET>' \
  --channel-type GOOGLE \
  --project-root fixtures/android-test-project/android-latest-project \
  --env test

发布到 npm

npm 包名：@leonxin/meetgames（公开 scope）。prepack 会在发布前自动执行 npm run build。

npm login
npm test
npm publish --access public

文档

| 文档 | 说明 | |------|------| | docs/README.md | 文档索引 | | docs/CLI.md | CLI 子命令、参数、生效范围与环境变量 | | docs/PARAMETERS.md | CLI / MCP / 远端接口 / meetsdk-remote-config.json 字段总表 | | docs/INTEGRATION.md | Android / iOS SDK 自动接入说明 | | docs/API.md | downloadSDKConfig 接口和配置字段说明 | | docs/MCP.md | MCP 工具与 Cursor 配置 |

npm 包内容说明

发布包不包含：

• fixtures/expected-patches/（测试用 dry-run patch 期望输出）
• fixtures/ios-sdk/（仓库测试用 iOS SDK fixture；运行时使用 ~/.cache/meet-sdk-tool/sdk/ios）
• tests/（自动化测试源码）

recipes/ 会随包分发；meetsdk-android.json、meetsdk-ios.json 运行时写入 ~/.cache/meet-sdk-tool/configs/sdk-home/。

License

MIT