@leonxin/meetgames 0.1.18 → 0.1.19

package/docs/API.md

@@ -8,16 +8,16 @@
 | `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 临时下载地址 |
 
-`downloadSDKConfig` 用于宿主工程配置，并由工具原样缓存到 `~/.cache/meet-sdk-tool`；sdk-home 版本接口用于 Android 接入时解析最新 SDK 版本并写入 `config/meetsdk-android.json`，也用于 iOS SDK 下载时解析最新版本；sdk-home 下载接口用于同步 iOS SDK 资源到 `~/.cache/meet-sdk-tool/sdk/ios`。
+`downloadSDKConfig` 用于宿主工程配置，并由工具原样缓存到 `~/.cache/meet-sdk-tool`；sdk-home 版本接口用于解析最新 SDK 版本；Android 会再通过 `getDownLoadUrl` 下载 SDK zip，从包内读取并写入 `~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-android.json`；iOS SDK 下载会写入 `~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-ios.json` 并同步 iOS SDK 资源到 `~/.cache/meet-sdk-tool/sdk/ios`。
 
 ## CLI 使用关系
 
 | 命令 | 是否请求接口 | 说明 |
 |---|---:|---|
 | `fetch-config` | 是 | 拉取并写入缓存中的 `meetsdk-remote-config.json` |
-| `setup` | 是 | 第一步执行 `fetch-config`；Android 集成阶段还会读取 sdk-home 最新 Android 版本并写入 `config/meetsdk-android.json` |
-| `doctor` | 是 | 第一步执行 `fetch-config`；Android 检查阶段还会读取 sdk-home 最新 Android 版本并写入 `config/meetsdk-android.json` |
-| `integrate` | Android 是 / iOS 否 | Android 读取 sdk-home 最新 Android 版本，写入 `config/meetsdk-android.json`，再写入 Gradle；iOS 读取缓存 `meetsdk-remote-config.json` 和缓存 SDK |
+| `setup` | 是 | 第一步执行 `fetch-config`；Android 集成阶段还会读取 sdk-home 最新 Android 版本并下载 SDK zip，从包内配置写入缓存 |
+| `doctor` | 是 | 第一步执行 `fetch-config`；Android 检查阶段还会读取 sdk-home 最新 Android 版本并下载 SDK zip，从包内配置写入缓存 |
+| `integrate` | Android 是 / iOS 否 | Android 读取 sdk-home 最新 Android 版本，下载 SDK zip 并读取包内 `meetsdk-android.json` 写入缓存，再写入 Gradle；iOS 读取缓存 `meetsdk-remote-config.json` 和缓存 SDK |
 | `download-ios-sdk` | 是 | 先读 sdk-home 最新 iOS 版本，再取 SDK zip URL，下载并解压到 `~/.cache/meet-sdk-tool/sdk/ios`，成功后写入 metadata |
 
 ## downloadSDKConfig
@@ -103,7 +103,7 @@ name
 如果数据库没有 `name`，JSON 不输出 `name`。  
 服务端不做推导、不写空字符串占位。
 
-示例：
+示例（假设 iOS `meetsdk-remote-config.json` 推导出的插件为 `guest,facebook,google,apple,apple_pay,dataAppsFlyer`）：
 
 ```json
 {
@@ -124,18 +124,18 @@ name
 
 `downloadSDKConfig` 不返回 SDK 版本、Maven 仓库、依赖坐标、Firebase Gradle plugin 等固定集成配置。
 
-Maven 仓库、依赖坐标、Firebase Gradle plugin 等由工具内置文件提供：
+Maven 仓库、依赖坐标、Firebase Gradle plugin 等由 sdk-home Android SDK zip 内的 `meetsdk-android.json` 提供，并由工具缓存为：
 
 ```text
-config/meetsdk-android.json
+~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-android.json
 ```
 
-Android SDK 版本也存放在 `config/meetsdk-android.json`。`integrate` / `doctor` 处理 Android 工程时，会调用 sdk-home `version` 接口读取 `data.result.android.ver` / `date`，写入 `config/meetsdk-android.json` 的 `topsdk.version` / `topsdk.date`，再合并为 Gradle 的 `topsdk_version`。
+`integrate` / `doctor` 处理 Android 工程时，会调用 sdk-home `version` 接口读取 `data.result.android.ver` / `date`，再请求 `getDownLoadUrl` 下载 Android SDK zip，解压后检索包内 `meetsdk-android.json`，写入缓存中的 `topsdk.version` / `topsdk.date` 和固定配置，最后合并为 Gradle 的 `topsdk_version`、仓库和依赖。
 
-iOS SDK 固定配置存放在：
+iOS SDK 下载元数据缓存为：
 
 ```text
-config/meetsdk-ios.json
+~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-ios.json
 ```
 
 该文件用于记录当前缓存 iOS SDK 对应的版本、发布日期、包类型和插件组合。
@@ -161,7 +161,7 @@ https://business.meetgames.com/sdkDownloadDetail?type=ios
 
 用途：获取下载中心当前展示的最新 SDK 版本。
 
-- Android `integrate` / `setup` / `doctor` 会读取 `data.result.android.ver` / `date`，先写入 `config/meetsdk-android.json`，再用于写入或校验 Gradle 中的 `topsdk_version`。
+- Android `integrate` / `setup` / `doctor` 会读取 `data.result.android.ver` / `date`，再下载 Android SDK zip 并读取包内 `meetsdk-android.json`，用于写入或校验 Gradle 中的 `topsdk_version`、仓库和依赖。
 - `download-ios-sdk` 未显式传 `--version` 时，会读取 `data.result.ios.ver` / `date` 作为下载版本；下载和解压成功后写入缓存 metadata。
 
 请求：
@@ -219,7 +219,7 @@ data.result.ios.date
 下载和解压成功后，工具会更新：
 
 ```text
-<package-root>/config/meetsdk-ios.json
+~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-ios.json
 ```
 
 请求：
@@ -228,7 +228,7 @@ data.result.ios.date
 |---|---|---|
 | `version` | SDK 版本；默认来自 `version` 接口的 `data.result.ios.ver` | 最新 iOS 版本 |
 | `platform` | 平台 | `ios` |
-| `plugins` | 逗号分隔插件列表；`setup` 会从 `meetsdk-remote-config.json` 启用模块自动推导，单独执行 `download-ios-sdk` 时使用默认集合 | `guest,facebook,google,apple,apple_pay,dataAppsFlyer` |
+| `plugins` | 逗号分隔插件列表；`setup` 和单独执行 `download-ios-sdk` 都必须从 iOS `meetsdk-remote-config.json` 启用模块推导 | 无默认值 |
 | `packageType` | 包类型 / 引擎 | `native` |
 
 示例：

package/docs/CLI.md

@@ -7,14 +7,14 @@
 | 子命令 | 作用 | 是否写文件 |
 |---|---|---|
 | `fetch-config` | 请求 `downloadSDKConfig`，将响应原文写入 `~/.cache/meet-sdk-tool` | 是 |
-| `download-ios-sdk` | 请求 sdk-home 版本和下载接口，下载 iOS SDK zip 并解压到 `~/.cache/meet-sdk-tool/sdk/ios` | 是 |
-| `integrate` | 读取本地配置并接入 Android 或 iOS SDK；Android 会请求 sdk-home 最新版本并更新 `config/meetsdk-android.json` | 默认写；`--dry-run` 时不写宿主工程文件 |
-| `setup` | 先执行 `fetch-config`；iOS 工程会再执行 `download-ios-sdk`；最后执行 `integrate`；Android 集成阶段会请求 sdk-home 最新版本并更新 `config/meetsdk-android.json` | 是；集成阶段受 `--dry-run` 影响 |
-| `doctor` | 先执行 `fetch-config`，再检查当前工程 SDK 接入是否正确；Android 检查阶段会请求 sdk-home 最新版本并更新 `config/meetsdk-android.json` | 是，会刷新缓存中的 `meetsdk-remote-config.json` |
+| `download-ios-sdk` | 读取 iOS `meetsdk-remote-config.json` 推导插件，再请求 sdk-home 版本和下载接口，下载 iOS SDK zip 并解压到 `~/.cache/meet-sdk-tool/sdk/ios` | 是 |
+| `integrate` | 读取本地配置并接入 Android 或 iOS SDK；Android 会请求 sdk-home 最新版本和 SDK zip，并从包内读取 `meetsdk-android.json` 更新缓存 | 默认写；`--dry-run` 时不写宿主工程文件 |
+| `setup` | 先执行 `fetch-config`；iOS 工程会再执行 `download-ios-sdk`；最后执行 `integrate`；Android 集成阶段会请求 sdk-home 最新版本和 SDK zip 并更新缓存 | 是；集成阶段受 `--dry-run` 影响 |
+| `doctor` | 先执行 `fetch-config`，再检查当前工程 SDK 接入是否正确；Android 检查阶段会请求 sdk-home 最新版本和 SDK zip 并更新缓存 | 是，会刷新缓存中的 `meetsdk-remote-config.json` |
 
 `doctor`、`setup`、`integrate` 都要求传入 `--project-root`。工具会根据该路径自动识别 Android 或 iOS，并且只执行对应平台逻辑。
-Android `integrate` / `setup` / `doctor` 会调用 sdk-home `version` 接口读取最新 Android SDK 版本，写入 `config/meetsdk-android.json`，并写入或校验 Gradle 中的 `topsdk_version`。
-`download-ios-sdk` 面向本机缓存的 iOS SDK 资源，不需要传 `--project-root`。
+Android `integrate` / `setup` / `doctor` 会调用 sdk-home `version` 接口读取最新 Android SDK 版本，再调用 `getDownLoadUrl` 下载 Android SDK zip，解压后检索包内 `meetsdk-android.json` 并写入 `~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-android.json`，用于写入或校验 Gradle 中的 `topsdk_version`。
+`download-ios-sdk` 面向本机缓存的 iOS SDK 资源；单独执行时必须能从 `--env` / `--app-id` / `--channel-type` 对应缓存，或 `--project-root`（默认当前目录）下读取到 iOS `meetsdk-remote-config.json`。
 
 ## 通用示例
 
@@ -67,7 +67,11 @@ node dist/entry.js doctor \
 刷新工具内置 iOS SDK：
 
 ```bash
-node dist/entry.js download-ios-sdk --verbose
+node dist/entry.js download-ios-sdk \
+  --app-id <APP_ID> \
+  --channel-type APPLE \
+  --env test \
+  --verbose
 ```
 
 指定包类型：
@@ -98,6 +102,8 @@ node dist/entry.js download-ios-sdk \
 
 ### download-ios-sdk 专用参数
 
+`download-ios-sdk` 也接受 `--project-root`、`--app-id`、`--channel-type`、`--env`、`--sdk-api-base-url`、`--verbose`，用于定位 iOS `meetsdk-remote-config.json` 和覆盖 sdk-home 地址。
+
 | 参数 | 说明 |
 |---|---|
 | `--package-type native|unity|cocos` | 包类型 / 引擎；默认 `native` |
@@ -182,7 +188,15 @@ Android 接入会先调用：
 GET https://business-api.meetgames.com/sdk/home/version
 ```
 
-用途：读取 `data.result.android.ver` / `date`，写入 `config/meetsdk-android.json` 的 `topsdk.version` / `topsdk.date`，并作为 Gradle 中的 `topsdk_version`。`config/meetsdk-android.json` 同时保留 Maven 仓库、依赖坐标、Firebase Gradle plugin 等固定配置。
+用途：读取 `data.result.android.ver` / `date`，作为后续 Android 固定配置下载的版本，并作为 Gradle 中的 `topsdk_version`。
+
+随后调用：
+
+```text
+GET https://business-api.meetgames.com/sdk/home/sdk-download/getDownLoadUrl?version=<Android版本>&platform=android&packageType=native&plugins=<渠道插件>
+```
+
+用途：获取 Android SDK zip 下载地址；工具下载并解压后在目录内检索 `meetsdk-android.json`，再写入 `~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-android.json`。
 
 当 Android 工程中存在多个 application module 时，如果未传 `--app-target`，命令会报出候选 module 列表；传入后会把 Gradle、Manifest、`google-services.json` 等写到选中的 module 下。
 
@@ -210,17 +224,17 @@ GET https://business-api.meetgames.com/sdk/home/version
 GET https://business-api.meetgames.com/sdk/home/sdk-download/getDownLoadUrl
 ```
 
-单独执行 `download-ios-sdk` 时的默认 query：
+`download-ios-sdk` 会读取 iOS `meetsdk-remote-config.json`，根据已启用的 iOS 模块生成 `plugins` 参数；单独执行和 `setup` 使用同一套规则，不再使用默认插件集合。
+
+query：
 
 ```text
 version=<version接口返回的iOS版本>
 platform=ios
-plugins=guest,facebook,google,apple,apple_pay,dataAppsFlyer
+plugins=<meetsdk-remote-config.json 推导出的插件列表>
 packageType=native
 ```
 
-`setup` 会先读取 `meetsdk-remote-config.json`，并根据配置启用的 iOS 模块自动生成 `plugins` 参数。
-
 用途：获取短期有效的 SDK zip 下载 URL。
 
 3. 下载 zip 并解压到缓存目录：
@@ -234,7 +248,7 @@ packageType=native
 下载和解压成功后，命令会更新：
 
 ```text
-config/meetsdk-ios.json
+~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-ios.json
 ```
 
 用途：记录当前缓存 iOS SDK 对应的版本、发布日期、包类型和插件组合。

package/docs/INTEGRATION.md

@@ -17,12 +17,13 @@
 | 来源 | 类型 | 作用 |
 |---|---|---|
 | `~/.cache/meet-sdk-tool/configs/<env>/<appId>/<channelType>/meetsdk-remote-config.json` | `downloadSDKConfig` 接口拉取后落盘 | 每个游戏/渠道不同的业务参数，例如 `appId`、登录渠道 `clientId/secret/redirect/scheme/name` |
-| `config/meetsdk-android.json` | 工具内置文件 | Android 固定 SDK 集成配置，例如 SDK 版本、Maven 仓库、依赖坐标、Firebase Gradle plugin |
-| `config/meetsdk-ios.json` | 工具内置文件 | iOS 固定 SDK 集成配置，例如当前缓存 SDK 版本、发布日期、包类型、插件组合 |
-| `GET https://business-api.meetgames.com/sdk/home/version` | sdk-home 接口 | Android 接入/检查时读取 `data.result.android.ver` 并写入 `config/meetsdk-android.json`；iOS 下载时读取 `data.result.ios.ver` 并写入 `config/meetsdk-ios.json` |
+| `~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-android.json` | sdk-home `version` + Android SDK zip 包内文件落盘 | Android 固定 SDK 集成配置，例如 SDK 版本、Maven 仓库、依赖坐标、Firebase Gradle plugin |
+| `~/.cache/meet-sdk-tool/configs/sdk-home/meetsdk-ios.json` | sdk-home iOS 下载流程写入 | iOS 当前缓存 SDK 的版本、发布日期、包类型和从 `meetsdk-remote-config.json` 推导出的插件组合 |
+| `GET https://business-api.meetgames.com/sdk/home/version` | sdk-home 接口 | Android 接入/检查时读取 `data.result.android.ver`；iOS 下载时读取 `data.result.ios.ver` |
+| `GET https://business-api.meetgames.com/sdk/home/sdk-download/getDownLoadUrl` | sdk-home 接口 | Android / iOS 按版本、平台、包类型和插件获取 SDK zip 下载地址 |
 
 `meetsdk-remote-config.json` 由 `fetch-config`、`setup`、`doctor` 拉取并原样写入 `~/.cache/meet-sdk-tool`，不会写入游戏工程根目录。  
-`integrate` 读取缓存配置并执行接入；Android 接入会额外请求 sdk-home 版本接口获取最新 SDK 版本，并同步写回 `config/meetsdk-android.json`，不会重新拉取 `meetsdk-remote-config.json`。
+`integrate` 读取缓存配置并执行接入；Android 接入会额外请求 sdk-home 版本和 SDK 下载接口，下载 zip 后从解压目录检索 `meetsdk-android.json` 并同步写回缓存，不会重新拉取 `meetsdk-remote-config.json`。
 
 ## 推荐流程
 
@@ -71,10 +72,10 @@ node dist/entry.js setup \
 
 ## Android 接入内容
 
-Android 接入时会根据 `meetsdk-remote-config.json` 和内置默认配置检查/写入：
+Android 接入时会根据 `meetsdk-remote-config.json` 和 sdk-home 缓存默认配置检查/写入：
 
 - Application module 默认自动检测；如果工程存在多个 application module，需要通过 `--app-target <module>` 指定，例如 `:app` 或 `launcher`。
-- sdk-home `version` 接口中的 `data.result.android.ver` / `date`，用于更新 `config/meetsdk-android.json` 并生成 App Module `build.gradle` 里的 `topsdk_version`。
+- sdk-home `version` 接口中的 `data.result.android.ver` / `date` 与 Android SDK zip 包内 `meetsdk-android.json` 固定配置，用于更新缓存并生成 App Module `build.gradle` 里的 `topsdk_version`。
 - `settings.gradle` 或根 `build.gradle` 中的 Maven 仓库。
 - 根 `build.gradle` 中的 Gradle plugin 声明，例如 Firebase google-services。
 - App Module `build.gradle` 中的 SDK 依赖。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leonxin/meetgames",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "license": "MIT",
   "type": "module",
   "bin": {

package/src/cache.ts

@@ -5,11 +5,17 @@ import path from "node:path";
 import { MEETSDK_REMOTE_CONFIG_FILENAME } from "./config/meetSdkRemoteConfig.js";
 
 export const MEET_SDK_TOOL_CACHE_ROOT = path.join(os.homedir(), ".cache", "meet-sdk-tool");
+export const MEETSDK_ANDROID_CONFIG_FILENAME = "meetsdk-android.json";
+export const MEETSDK_IOS_CONFIG_FILENAME = "meetsdk-ios.json";
 
 function iosSdkZipFileName(version: string): string {
   return `topSDK-ios--V${version}.zip`;
 }
 
+function androidSdkZipFileName(version: string): string {
+  return `topSDK-android-V${version}.zip`;
+}
+
 function safeSegment(value: string): string {
   const cleaned = value.trim().replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^_+|_+$/g, "");
   return cleaned || "unknown";
@@ -52,6 +58,14 @@ export function resolveRemoteConfigCachePath(params: {
   );
 }
 
+export function resolveMeetSdkAndroidConfigCachePath(cacheRoot = MEET_SDK_TOOL_CACHE_ROOT): string {
+  return path.join(cacheRoot, "configs", "sdk-home", MEETSDK_ANDROID_CONFIG_FILENAME);
+}
+
+export function resolveMeetSdkIosConfigCachePath(cacheRoot = MEET_SDK_TOOL_CACHE_ROOT): string {
+  return path.join(cacheRoot, "configs", "sdk-home", MEETSDK_IOS_CONFIG_FILENAME);
+}
+
 export function writeRemoteConfigCache(params: {
   env: string;
   appId: string;
@@ -110,6 +124,29 @@ export function resolveIosSdkCacheLayout(params: {
   };
 }
 
+export function resolveAndroidSdkCacheLayout(params: {
+  version: string;
+  packageType: string;
+  plugins: readonly string[];
+  cacheRoot?: string;
+}): { baseDir: string; zipPath: string; extractDir: string; metadataPath: string; lockDir: string } {
+  const baseDir = path.join(
+    params.cacheRoot ?? MEET_SDK_TOOL_CACHE_ROOT,
+    "sdk",
+    "android",
+    safeSegment(params.packageType),
+    safeSegment(params.version),
+    pluginsHash(params.plugins)
+  );
+  return {
+    baseDir,
+    zipPath: path.join(baseDir, androidSdkZipFileName(params.version)),
+    extractDir: path.join(baseDir, "extracted"),
+    metadataPath: path.join(baseDir, "metadata.json"),
+    lockDir: path.join(baseDir, ".lock"),
+  };
+}
+
 export function writeIosSdkCacheMetadata(params: {
   metadataPath: string;
   version: string;

package/src/cli.ts

@@ -16,7 +16,6 @@ import {
   defaultSdkHomeApiBaseUrl,
   downloadIosSdkToBundled,
   DEFAULT_IOS_SDK_PACKAGE_TYPE,
-  resolveIosSdkDownloadPluginsFromRemoteConfig,
 } from "./remote/sdkHomeDownload.js";
 import type { Manifest } from "./contracts/types.js";
 import {
@@ -74,7 +73,7 @@ meetgames — Android-first integration CLI (TypeScript)
 Usage:
   meetgames integrate [--project-root <path>] [--app-id ID] [--channel-type TYPE] [--env prod|pre|test] [--app-target <target>] [--dry-run] [--verbose] [--patch-file <path>]
   meetgames fetch-config [--app-id ID] [--app-secret SECRET] [--channel-type TYPE] [--env prod|pre|test] [--project-root <path>] [--verbose]
-  meetgames download-ios-sdk [--package-type native|unity|cocos] [--sdk-api-base-url URL] [--verbose]
+  meetgames download-ios-sdk [--project-root <path>] [--app-id ID] [--channel-type TYPE] [--env prod|pre|test] [--package-type native|unity|cocos] [--sdk-api-base-url URL] [--verbose]
   meetgames setup [--app-id ID] [--app-secret SECRET] [--channel-type TYPE] [--env prod|pre|test] [--project-root <path>] [--app-target <target>] [--dry-run] [--verbose] [--patch-file <path>]
   meetgames doctor [--app-id ID] [--app-secret SECRET] [--channel-type TYPE] [--env prod|pre|test] --project-root <path> [--app-target <target>] [--verbose]
 
@@ -87,8 +86,8 @@ Notes:
   - doctor first fetches downloadSDKConfig to the cache, then validates the detected platform integration.
   - integrate uses recipes/integrate-default.yaml, filtered to the detected platform before execution.
   - iOS SDK is read from ${MEET_SDK_TOOL_CACHE_ROOT}/sdk/ios/.
-  - Android integrate/doctor reads the latest SDK version from sdk-home and stores it in config/meetsdk-android.json.
-  - download-ios-sdk calls sdk-home getDownLoadUrl, saves and extracts the iOS SDK under ${MEET_SDK_TOOL_CACHE_ROOT}/sdk/ios/.
+  - Android integrate/doctor reads latest SDK config from sdk-home and stores it under ${MEET_SDK_TOOL_CACHE_ROOT}/configs/sdk-home/.
+  - download-ios-sdk reads an iOS meetsdk-remote-config.json, derives sdk-home plugins from it, then calls sdk-home getDownLoadUrl and extracts the iOS SDK under ${MEET_SDK_TOOL_CACHE_ROOT}/sdk/ios/.
   - fetch-config requires --app-secret (or TOPSDK_APP_SECRET) to sign downloadSDKConfig; appSecret is never read from meetsdk-remote-config.json.
   - When analytics.firebase is enabled, Android downloads google-services.json to the detected/selected app module; iOS downloads GoogleService-Info.plist next to Info.plist.
   - fetch-config writes to ${MEET_SDK_TOOL_CACHE_ROOT}/configs/<env>/<appId>/<channelType>/meetsdk-remote-config.json.
@@ -108,7 +107,7 @@ Options (global where noted):
   --package-type        download-ios-sdk: native（默认）| unity | cocos
   --dry-run             integrate: compute changes and patch preview without writing host project files (default is write to disk)
   --report-file         Write JSON report to path
-  --patch-file          integrate: write unified diff to this path (works with --dry-run). If under <pkg>/preview-patches/, all existing files in that dir are removed first so only the latest patch remains.
+  --patch-file          integrate: write unified diff to this path (works with --dry-run). If under <pkg>/fixtures/expected-patches/, all existing files in that dir are removed first so only the latest patch remains.
   --verbose             Verbose logs and full patch preview
 
 Subcommand notes:
@@ -396,12 +395,20 @@ async function cmdSetup(parsed: Parsed): Promise<void> {
   await cmdIntegrate(parsed);
 }
 
-function readIosDownloadPluginsFromRemoteConfig(configPath: string): string[] | undefined {
-  if (!configPath || !fs.existsSync(configPath)) return undefined;
-  const remote = tryParseAsMeetSdkRemoteConfig(JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown);
-  if (!remote || remote.devicePlatform !== "ios") return undefined;
-  const plugins = resolveIosSdkDownloadPluginsFromRemoteConfig(remote);
-  return plugins.length ? plugins : undefined;
+function resolveIosDownloadRemoteConfigPath(parsed: Parsed, explicitPath?: string): string {
+  const candidates = [
+    explicitPath,
+    cachedRemoteConfigPathFromArgs(parsed),
+    path.join(parsed.projectRoot, MEETSDK_REMOTE_CONFIG_FILENAME),
+  ]
+    .filter((p): p is string => Boolean(p))
+    .filter((p, i, arr) => arr.indexOf(p) === i);
+  const found = candidates.find((p) => fs.existsSync(p));
+  if (found) return found;
+  fail(
+    `download-ios-sdk requires an iOS ${MEETSDK_REMOTE_CONFIG_FILENAME}; checked: ${candidates.join(", ")}`,
+    EXIT.CONFIG_ERROR
+  );
 }
 
 async function cmdDownloadIosSdk(parsed: Parsed, remoteConfigPath?: string): Promise<void> {
@@ -411,15 +418,15 @@ async function cmdDownloadIosSdk(parsed: Parsed, remoteConfigPath?: string): Pro
   if (!["native", "unity", "cocos"].includes(packageType)) {
     fail(`invalid --package-type (use native, unity, or cocos): ${packageType}`, EXIT.INVALID_ARGS);
   }
-  const configuredPlugins = remoteConfigPath ? readIosDownloadPluginsFromRemoteConfig(remoteConfigPath) : undefined;
-  const plugins = configuredPlugins;
+  const configPath = resolveIosDownloadRemoteConfigPath(parsed, remoteConfigPath);
 
+  console.log(`[meetgames] download-ios-sdk: using remote config ${configPath}`);
   console.log("[meetgames] download-ios-sdk: resolving sdk-home iOS SDK…");
   let result;
   try {
     result = await downloadIosSdkToBundled(resolvePackageRoot(), {
       baseUrl,
-      plugins,
+      remoteConfigPath: configPath,
       packageType,
     });
   } catch (e) {