@leonxin/meetgames 0.1.18 → 0.1.20

package/src/config/meetSdkDefaultConfig.ts

@@ -1,42 +1,159 @@
 import fs from "node:fs";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { tryParseAsMeetSdkDefaultConfig, type MeetSdkDefaultConfig } from "./meetSdkRemoteConfig.js";
-import { defaultSdkHomeApiBaseUrl, fetchSdkHomeVersions, type SdkHomePlatformVersion } from "../remote/sdkHomeDownload.js";
+import {
+  MEETSDK_ANDROID_CONFIG_FILENAME,
+  resolveAndroidSdkCacheLayout,
+  resolveMeetSdkAndroidConfigCachePath,
+  withCacheLock,
+} from "../cache.js";
+import {
+  buildSdkHomeDownloadUrl,
+  defaultSdkHomeApiBaseUrl,
+  downloadBinaryFile,
+  extractZip,
+  fetchSdkHomeVersions,
+  type SdkHomePlatformVersion,
+} from "../remote/sdkHomeDownload.js";
+import {
+  DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES,
+  tryParseAsMeetSdkDefaultConfig,
+  type MeetSdkDefaultConfig,
+} from "./meetSdkRemoteConfig.js";
 
-/** Built-in Android SDK defaults (repos and per-plugin dependencies). */
-export const MEETSDK_ANDROID_DEFAULTS_FILENAME = "meetsdk-android.json";
-const MEETSDK_CONFIG_DIR = "config";
+const DEFAULT_GROUP_ID = "com.sino.topsdk";
+const DEFAULT_ANDROID_SDK_PACKAGE_TYPE = "native";
 
-const defaultConfigPath = fileURLToPath(
-  new URL(`../../${MEETSDK_CONFIG_DIR}/${MEETSDK_ANDROID_DEFAULTS_FILENAME}`, import.meta.url)
-);
+type JsonRecord = Record<string, unknown>;
 
-export function resolveMeetSdkAndroidConfigPath(packageRoot?: string): string {
-  return packageRoot ? path.join(packageRoot, MEETSDK_CONFIG_DIR, MEETSDK_ANDROID_DEFAULTS_FILENAME) : defaultConfigPath;
+function isRecord(value: unknown): value is JsonRecord {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-export function loadBuiltInMeetSdkDefaultConfig(options: { packageRoot?: string } = {}): MeetSdkDefaultConfig {
-  const configPath = resolveMeetSdkAndroidConfigPath(options.packageRoot);
-  if (!fs.existsSync(configPath)) {
-    throw new Error(
-      `built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} not found at ${configPath}; reinstall @leonxin/meetgames or run from a complete package install`
-    );
+function cloneDefaultConfig(value: MeetSdkDefaultConfig): MeetSdkDefaultConfig {
+  return JSON.parse(JSON.stringify(value)) as MeetSdkDefaultConfig;
+}
+
+function resolveSdkHomeApiBaseUrl(baseUrl?: string): string {
+  return baseUrl || process.env.MEETGAMES_SDK_HOME_API_BASE_URL?.trim() || defaultSdkHomeApiBaseUrl;
+}
+
+function parseJsonResponseEnvelope(body: unknown, label: string): unknown {
+  if (!isRecord(body)) throw new Error(`${label} response is not an object`);
+  const code = body.code;
+  if (code !== undefined && Number(code) !== 200) {
+    const message = typeof body.message === "string" ? body.message : JSON.stringify(body);
+    throw new Error(`${label} API error (code=${String(code)}): ${message}`);
   }
-  const raw = JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown;
-  const parsed = tryParseAsMeetSdkDefaultConfig(raw);
+  return "data" in body ? body.data : body;
+}
+
+async function fetchJson(url: string, signal?: AbortSignal): Promise<unknown> {
+  let res: Response;
+  try {
+    res = await fetch(url, { redirect: "follow", signal, headers: { Accept: "application/json" } });
+  } catch (e) {
+    const cause = e instanceof Error && "cause" in e && e.cause instanceof Error ? e.cause.message : null;
+    const detail = cause && cause !== (e instanceof Error ? e.message : String(e)) ? ` (${cause})` : "";
+    throw new Error(`GET ${url} failed: ${e instanceof Error ? e.message : String(e)}${detail}`);
+  }
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    const detail = text.trim() ? `: ${text.trim().slice(0, 1000)}` : "";
+    throw new Error(`GET ${url} failed: HTTP ${res.status}${detail}`);
+  }
+  const text = await res.text();
+  try {
+    return JSON.parse(text) as unknown;
+  } catch {
+    throw new Error(`GET ${url} did not return valid JSON`);
+  }
+}
+
+export function resolveMeetSdkAndroidConfigPath(cacheRoot?: string): string {
+  return resolveMeetSdkAndroidConfigCachePath(cacheRoot);
+}
+
+function readMeetSdkDefaultConfigFromPath(configPath: string): MeetSdkDefaultConfig {
+  const parsed = tryParseAsMeetSdkDefaultConfig(JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown);
   if (!parsed) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} is not a valid MeetSdk default config`);
+    throw new Error(`${MEETSDK_ANDROID_CONFIG_FILENAME} is not a valid MeetSdk default config: ${configPath}`);
   }
   return parsed;
 }
 
-function cloneDefaultConfig(value: MeetSdkDefaultConfig): MeetSdkDefaultConfig {
-  return JSON.parse(JSON.stringify(value)) as MeetSdkDefaultConfig;
+export function loadBuiltInMeetSdkDefaultConfig(options: { cacheRoot?: string; packageRoot?: string } = {}): MeetSdkDefaultConfig {
+  const cachePath = resolveMeetSdkAndroidConfigPath(options.cacheRoot);
+  if (fs.existsSync(cachePath)) return readMeetSdkDefaultConfigFromPath(cachePath);
+  return compatibilityDefaultConfig();
 }
 
-function resolveSdkHomeApiBaseUrl(baseUrl?: string): string {
-  return baseUrl || process.env.MEETGAMES_SDK_HOME_API_BASE_URL?.trim() || defaultSdkHomeApiBaseUrl;
+function compatibilityDefaultConfig(): MeetSdkDefaultConfig {
+  const raw = {
+    topsdk: {
+      version: "",
+      groupId: DEFAULT_GROUP_ID,
+      repositories: ["https://storage-sdk-gameplus.meetsocial.com/repository/TopSdk/"],
+    },
+    sdkModules: {
+      login: {
+        guest: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.guest] },
+        email: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.email] },
+        apple: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.apple] },
+        facebook: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.facebook] },
+        google: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.google] },
+        twitter: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.twitter] },
+        snapchat: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.snapchat] },
+        line: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.line] },
+        naver: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.naver] },
+        kakao: {
+          repositories: ["https://devrepo.kakao.com/nexus/content/groups/public/"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.kakao],
+        },
+        tiktok: {
+          repositories: ["https://artifact.bytedance.com/repository/AwemeOpenSDK"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.tiktok],
+        },
+        discord: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.discord] },
+      },
+      payment: {
+        googleIap: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.googleIap] },
+        appleIap: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.appleIap] },
+        onestoreIap: {
+          repositories: ["https://repo.onestore.co.kr/repository/onestore-sdk-public/"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.onestoreIap],
+        },
+        huaweiIap: {
+          repositories: ["https://developer.huawei.com/repo/"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.huaweiIap],
+        },
+        xiaomiIap: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.xiaomiIap] },
+      },
+      analytics: {
+        appsflyer: {
+          repositories: ["mavenCentral"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.appsflyer],
+        },
+        facebookdata: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.facebookdata] },
+        firebase: {
+          repositories: ["google"],
+          classpath: "com.google.gms:google-services:4.4.4",
+          applyplugin: "com.google.gms.google-services",
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.firebase],
+        },
+        adjust: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.adjust] },
+      },
+    },
+  };
+  const parsed = tryParseAsMeetSdkDefaultConfig(raw);
+  if (!parsed) throw new Error("embedded compatibility meetsdk-android defaults are invalid");
+  return parsed;
+}
+
+function writeMeetSdkAndroidConfigCache(config: MeetSdkDefaultConfig, cacheRoot?: string): string {
+  const configPath = resolveMeetSdkAndroidConfigPath(cacheRoot);
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+  return configPath;
 }
 
 const latestAndroidVersionCache = new Map<string, Promise<SdkHomePlatformVersion>>();
@@ -51,50 +168,117 @@ async function fetchLatestAndroidSdkVersion(baseUrl?: string): Promise<SdkHomePl
   return cached;
 }
 
-export function syncMeetSdkAndroidVersionToConfig(params: {
-  version: string;
-  date?: string;
-  packageRoot?: string;
-}): string {
-  const version = params.version.trim();
-  if (!version) throw new Error("Android SDK version is empty");
+function androidChannelPlugin(channelType?: string): string {
+  const normalized = (channelType ?? "").trim().toUpperCase();
+  const map: Record<string, string> = {
+    GOOGLE: "google_channel",
+    ONESTORE: "onestore_channel",
+    XIAOMI: "xiaomi_channel",
+    HUAWEI: "huawei_channel",
+  };
+  return map[normalized] ?? "google_channel";
+}
 
-  const configPath = resolveMeetSdkAndroidConfigPath(params.packageRoot);
-  if (!fs.existsSync(configPath)) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} not found at ${configPath}`);
-  }
-  const raw = JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown;
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} is not a JSON object`);
+function findMeetSdkAndroidConfigFile(root: string): string | null {
+  if (!fs.existsSync(root)) return null;
+  const stack = [root];
+  while (stack.length) {
+    const dir = stack.pop()!;
+    for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (ent.name.startsWith("__MACOSX") || ent.name.startsWith("._")) continue;
+      const abs = path.join(dir, ent.name);
+      if (ent.isDirectory()) {
+        stack.push(abs);
+      } else if (ent.isFile() && ent.name === MEETSDK_ANDROID_CONFIG_FILENAME) {
+        return abs;
+      }
+    }
   }
-  const record = raw as Record<string, unknown>;
-  if (typeof record.topsdk !== "object" || record.topsdk === null || Array.isArray(record.topsdk)) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} does not contain topsdk object`);
-  }
-  const topsdk = record.topsdk as Record<string, unknown>;
-  topsdk.version = version;
-  if (params.date?.trim()) topsdk.date = params.date.trim();
-  fs.writeFileSync(configPath, `${JSON.stringify(record, null, 2)}\n`, "utf8");
-  return configPath;
+  return null;
 }
 
+function loadMeetSdkAndroidConfigFromExtracted(root: string, version: string, date?: string): MeetSdkDefaultConfig {
+  const configPath = findMeetSdkAndroidConfigFile(root);
+  if (!configPath) throw new Error(`${MEETSDK_ANDROID_CONFIG_FILENAME} not found under downloaded Android SDK: ${root}`);
+  const config = readMeetSdkDefaultConfigFromPath(configPath);
+  config.topsdk.version = config.topsdk.version || version;
+  config.topsdk.date = config.topsdk.date || date;
+  return config;
+}
+
+async function fetchSdkHomeAndroidConfig(params: {
+  baseUrl?: string;
+  version: string;
+  date?: string;
+  channelType?: string;
+  packageType?: string;
+  cacheRoot?: string;
+  signal?: AbortSignal;
+}): Promise<{ url?: string; config: MeetSdkDefaultConfig }> {
+  const baseUrl = resolveSdkHomeApiBaseUrl(params.baseUrl);
+  const packageType = params.packageType || DEFAULT_ANDROID_SDK_PACKAGE_TYPE;
+  const plugins = [androidChannelPlugin(params.channelType)];
+  const layout = resolveAndroidSdkCacheLayout({
+    version: params.version,
+    packageType,
+    plugins,
+    cacheRoot: params.cacheRoot,
+  });
+  let downloadApiUrl: string | undefined;
+  const downloadAndExtract = async (): Promise<void> => {
+    if (findMeetSdkAndroidConfigFile(layout.extractDir)) return;
+    downloadApiUrl = buildSdkHomeDownloadUrl({
+      baseUrl,
+      version: params.version,
+      platform: "android",
+      packageType,
+      plugins,
+    });
+    const body = parseJsonResponseEnvelope(await fetchJson(downloadApiUrl, params.signal), "sdk-home Android download");
+    if (typeof body !== "string" || !body.trim()) {
+      throw new Error("sdk-home Android getDownLoadUrl response does not contain a download URL in data");
+    }
+    await downloadBinaryFile(body, layout.zipPath, params.signal);
+    fs.rmSync(layout.extractDir, { recursive: true, force: true });
+    await extractZip(layout.zipPath, layout.extractDir);
+  };
+  await withCacheLock(layout.lockDir, downloadAndExtract);
+  return {
+    url: downloadApiUrl,
+    config: loadMeetSdkAndroidConfigFromExtracted(layout.extractDir, params.version, params.date),
+  };
+}
+
+const androidConfigCache = new Map<string, Promise<MeetSdkDefaultConfig>>();
+
 /**
- * Built-in Android SDK defaults with the SDK version resolved at runtime from sdk-home.
- * The version is also persisted to `config/meetsdk-android.json` so the package config
- * reflects the latest SDK version discovered from the download center.
+ * Android SDK defaults resolved from sdk-home and persisted under ~/.cache/meet-sdk-tool.
+ * The package config/ directory is no longer written at runtime.
  */
 export async function loadMeetSdkDefaultConfigWithLatestAndroidVersion(options: {
   sdkHomeApiBaseUrl?: string;
+  cacheRoot?: string;
   packageRoot?: string;
+  channelType?: string;
+  packageType?: string;
 } = {}): Promise<MeetSdkDefaultConfig> {
-  const defaults = cloneDefaultConfig(loadBuiltInMeetSdkDefaultConfig({ packageRoot: options.packageRoot }));
   const latest = await fetchLatestAndroidSdkVersion(options.sdkHomeApiBaseUrl);
-  syncMeetSdkAndroidVersionToConfig({
-    version: latest.ver,
-    date: latest.date,
-    packageRoot: options.packageRoot,
-  });
-  defaults.topsdk.version = latest.ver;
-  defaults.topsdk.date = latest.date;
-  return defaults;
+  const baseUrl = resolveSdkHomeApiBaseUrl(options.sdkHomeApiBaseUrl);
+  const key = `${baseUrl}\n${latest.ver}\n${options.cacheRoot ?? ""}\n${options.channelType ?? ""}\n${options.packageType ?? ""}`;
+  let cached = androidConfigCache.get(key);
+  if (!cached) {
+    cached = fetchSdkHomeAndroidConfig({
+      baseUrl,
+      version: latest.ver,
+      date: latest.date,
+      channelType: options.channelType,
+      packageType: options.packageType,
+      cacheRoot: options.cacheRoot,
+    }).then(({ config }) => {
+      writeMeetSdkAndroidConfigCache(config, options.cacheRoot);
+      return cloneDefaultConfig(config);
+    });
+    androidConfigCache.set(key, cached);
+  }
+  return cloneDefaultConfig(await cached);
 }

package/src/config/meetSdkIosConfig.ts

@@ -1,8 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-
-export const MEETSDK_IOS_CONFIG_FILENAME = "meetsdk-ios.json";
-const MEETSDK_CONFIG_DIR = "config";
+import { MEETSDK_IOS_CONFIG_FILENAME, resolveMeetSdkIosConfigCachePath } from "../cache.js";
 
 export interface MeetSdkIosConfig {
   topsdk: {
@@ -27,8 +25,8 @@ function normalizePlugins(value: unknown): string[] | undefined {
   return plugins.length ? plugins : undefined;
 }
 
-export function resolveMeetSdkIosConfigPath(packageRoot: string): string {
-  return path.join(packageRoot, MEETSDK_CONFIG_DIR, MEETSDK_IOS_CONFIG_FILENAME);
+export function resolveMeetSdkIosConfigPath(cacheRoot?: string): string {
+  return resolveMeetSdkIosConfigCachePath(cacheRoot);
 }
 
 export function tryParseAsMeetSdkIosConfig(raw: unknown): MeetSdkIosConfig | null {
@@ -44,8 +42,8 @@ export function tryParseAsMeetSdkIosConfig(raw: unknown): MeetSdkIosConfig | nul
   };
 }
 
-export function loadMeetSdkIosConfig(packageRoot: string): MeetSdkIosConfig {
-  const configPath = resolveMeetSdkIosConfigPath(packageRoot);
+export function loadMeetSdkIosConfig(cacheRoot?: string): MeetSdkIosConfig {
+  const configPath = resolveMeetSdkIosConfigPath(cacheRoot);
   if (!fs.existsSync(configPath)) {
     return { topsdk: { version: "" } };
   }
@@ -56,15 +54,15 @@ export function loadMeetSdkIosConfig(packageRoot: string): MeetSdkIosConfig {
   return parsed;
 }
 
-export function writeMeetSdkIosConfig(packageRoot: string, config: MeetSdkIosConfig): string {
-  const configPath = resolveMeetSdkIosConfigPath(packageRoot);
+export function writeMeetSdkIosConfig(config: MeetSdkIosConfig, cacheRoot?: string): string {
+  const configPath = resolveMeetSdkIosConfigPath(cacheRoot);
   fs.mkdirSync(path.dirname(configPath), { recursive: true });
   fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
   return configPath;
 }
 
 export function syncMeetSdkIosVersionToConfig(params: {
-  packageRoot: string;
+  cacheRoot?: string;
   version: string;
   date?: string;
   packageType?: string;
@@ -73,17 +71,15 @@ export function syncMeetSdkIosVersionToConfig(params: {
   const version = params.version.trim();
   if (!version) throw new Error("iOS SDK version is empty");
 
-  const current = loadMeetSdkIosConfig(params.packageRoot);
-  const nextDate = params.date === undefined ? current.topsdk.date : params.date.trim() || undefined;
+  const topsdk: MeetSdkIosConfig["topsdk"] = { version };
+  const date = params.date?.trim();
+  const packageType = params.packageType?.trim();
+  const plugins = params.plugins?.map((x) => x.trim()).filter(Boolean);
+  if (date) topsdk.date = date;
+  if (packageType) topsdk.packageType = packageType;
+  if (plugins?.length) topsdk.plugins = plugins;
   const next: MeetSdkIosConfig = {
-    ...current,
-    topsdk: {
-      ...current.topsdk,
-      version,
-      date: nextDate,
-      packageType: params.packageType?.trim() || current.topsdk.packageType,
-      plugins: params.plugins?.map((x) => x.trim()).filter(Boolean) || current.topsdk.plugins,
-    },
+    topsdk,
   };
-  return writeMeetSdkIosConfig(params.packageRoot, next);
+  return writeMeetSdkIosConfig(next, params.cacheRoot);
 }

package/src/contracts/types.ts

@@ -12,6 +12,19 @@ export interface AndroidDetectionError {
 
 export type AndroidDetectResult = AndroidDetection | AndroidDetectionError;
 
+export interface AndroidSdkModule {
+  ok: true;
+  moduleName: string;
+  moduleDir: string;
+}
+
+export interface AndroidSdkModuleError {
+  ok: false;
+  error: string;
+}
+
+export type AndroidSdkModuleResult = AndroidSdkModule | AndroidSdkModuleError;
+
 export interface AndroidDetectOptions {
   /** Unified app target selector; for Android this is the application Gradle module, e.g. `:app` or `launcher`. */
   appTarget?: string;
@@ -57,7 +70,11 @@ export interface WorkspaceContext {
   remoteConfigPath?: string;
   /** Cached iOS SDK root used as the source for integration resources. */
   iosSdkRoot?: string;
+  /** Optional cache root override, primarily used by tests. */
+  cacheRoot?: string;
   android?: AndroidDetectResult;
+  /** Android Gradle module where SDK resValue/dependencies are written. Defaults to `:unityLibrary`. */
+  androidSdkModule?: AndroidSdkModuleResult;
   /** Reserved: populated via placeholder until iOS tooling ships. */
   ios?: IOSDetectResult;
   iosReserved?: IosToolingReserved;
@@ -66,12 +83,16 @@ export interface WorkspaceContext {
 export interface WorkspaceContextOptions {
   /** Unified app target selector: Android application module or iOS application target. */
   appTarget?: string;
+  /** Android Gradle module where SDK resValue/dependencies are written. Defaults to `unityLibrary`. */
+  sdkModuleName?: string;
   /** sdk-home API root; defaults to the production MeetGames business API. */
   sdkHomeApiBaseUrl?: string;
   /** Override the cached remote config path. */
   remoteConfigPath?: string;
   /** Override the iOS SDK source root. */
   iosSdkRoot?: string;
+  /** Override meet-sdk-tool cache root. */
+  cacheRoot?: string;
 }
 
 export interface ManifestStep {

package/src/core/doctor.ts

@@ -84,6 +84,14 @@ function fileContainsRepository(text: string, repo: string): boolean {
 }
 
 function moduleBuildGradlePath(ctx: WorkspaceContext): string | null {
+  if (!ctx.androidSdkModule?.ok) return null;
+  const groovy = path.join(ctx.androidSdkModule.moduleDir, "build.gradle");
+  if (fs.existsSync(groovy)) return groovy;
+  const kts = path.join(ctx.androidSdkModule.moduleDir, "build.gradle.kts");
+  return fs.existsSync(kts) ? kts : null;
+}
+
+function applicationBuildGradlePath(ctx: WorkspaceContext): string | null {
   if (!ctx.android?.ok) return null;
   const groovy = path.join(ctx.android.moduleDir, "build.gradle");
   if (fs.existsSync(groovy)) return groovy;
@@ -193,22 +201,30 @@ async function checkAndroid(ctx: WorkspaceContext, report: DoctorReport, config:
     addCheck(report, "android.detect", false, "android application module not detected");
     return;
   }
+  if (!ctx.androidSdkModule?.ok) {
+    addCheck(report, "android.sdkModule", false, ctx.androidSdkModule?.error ?? "android SDK module not resolved");
+    return;
+  }
   const resolved = applyMeetSdkDefaultConfig(
     config,
     await loadMeetSdkDefaultConfigWithLatestAndroidVersion({
       sdkHomeApiBaseUrl: ctx.sdkHomeApiBaseUrl,
       packageRoot: ctx.packageRoot,
+      cacheRoot: ctx.cacheRoot,
+      channelType: config.channel,
     })
   );
   const moduleGradleAbs = moduleBuildGradlePath(ctx);
+  const applicationGradleAbs = applicationBuildGradlePath(ctx);
   const rootGradleAbs = rootBuildGradlePath(ctx.projectRoot);
   const settingsGradleAbs = settingsGradlePath(ctx.projectRoot);
   const moduleGradle = moduleGradleAbs ? readFileIfExists(moduleGradleAbs) : "";
+  const applicationGradle = applicationGradleAbs ? readFileIfExists(applicationGradleAbs) : "";
   const rootGradle = rootGradleAbs ? readFileIfExists(rootGradleAbs) : "";
   const settingsGradle = settingsGradleAbs ? readFileIfExists(settingsGradleAbs) : "";
 
   addCheck(report, "android.moduleGradle.exists", Boolean(moduleGradleAbs), moduleGradleAbs ?? "module build.gradle not found");
-  addCheck(report, "android.applicationId", moduleGradle.includes(`applicationId "${resolved.packageName}"`) || moduleGradle.includes(`applicationId '${resolved.packageName}'`), resolved.packageName);
+  addCheck(report, "android.applicationId", applicationGradle.includes(`applicationId "${resolved.packageName}"`) || applicationGradle.includes(`applicationId '${resolved.packageName}'`), resolved.packageName);
 
   const repoText = `${settingsGradle}\n${rootGradle}`;
   const missingRepos = collectMeetSdkRemoteRepositories(resolved).filter((repo) => !fileContainsRepository(repoText, repo));

package/src/core/platform.ts

@@ -35,7 +35,7 @@ export function platformContext(ctx: WorkspaceContext, platform: DetectedPlatfor
   if (platform === "android") {
     return { ...ctx, ios: undefined, iosReserved: undefined };
   }
-  return { ...ctx, android: undefined };
+  return { ...ctx, android: undefined, androidSdkModule: undefined };
 }
 
 export function manifestForPlatform(manifest: Manifest, platform: DetectedPlatform): Manifest {

package/src/core/previewPatches.ts

@@ -1,13 +1,13 @@
 import fs from "node:fs";
 import path from "node:path";
 
-/** Default directory for `pipeline.patch` / `cli-preview.patch` (gitignored). */
+/** Default directory for expected dry-run patch artifacts. */
 export function resolveDefaultPreviewPatchDir(packageRoot: string): string {
-  return path.join(packageRoot, "preview-patches");
+  return path.join(packageRoot, "fixtures", "expected-patches");
 }
 
 /**
- * Before writing a new patch under `preview-patches/`, remove all existing files there
+ * Before writing a new patch under `fixtures/expected-patches/`, remove all existing files there
  * so only the latest command output remains.
  */
 export function clearPreviewPatchFilesIfTargetInside(packageRoot: string, patchFileAbs: string): void {

package/src/core/workspace.ts

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import type { WorkspaceContext, WorkspaceContextOptions } from "../contracts/types.js";
-import { detectAndroid } from "../android/detect.js";
+import { detectAndroid, resolveAndroidSdkModule } from "../android/detect.js";
 import { detectIOS } from "../ios/detect.js";
 import { iosToolingReserved } from "../ios/reserved.js";
 
@@ -24,7 +24,9 @@ export function buildWorkspaceContext(
     sdkHomeApiBaseUrl: options.sdkHomeApiBaseUrl,
     remoteConfigPath: options.remoteConfigPath,
     iosSdkRoot: options.iosSdkRoot,
+    cacheRoot: options.cacheRoot,
     android: detectAndroid(root, { appTarget: options.appTarget }),
+    androidSdkModule: resolveAndroidSdkModule(root, options.sdkModuleName),
     ios: detectIOS(root, { appTarget: options.appTarget }),
     iosReserved: iosToolingReserved,
   };

package/src/index.ts

@@ -61,10 +61,8 @@ export {
   loadBuiltInMeetSdkDefaultConfig,
   loadMeetSdkDefaultConfigWithLatestAndroidVersion,
   resolveMeetSdkAndroidConfigPath,
-  syncMeetSdkAndroidVersionToConfig,
 } from "./config/meetSdkDefaultConfig.js";
 export {
-  MEETSDK_IOS_CONFIG_FILENAME,
   loadMeetSdkIosConfig,
   resolveMeetSdkIosConfigPath,
   syncMeetSdkIosVersionToConfig,
@@ -81,9 +79,13 @@ export {
 } from "./config/topsdkFeatureModules.js";
 export { clearPreviewPatchFilesIfTargetInside, resolveDefaultPreviewPatchDir } from "./core/previewPatches.js";
 export {
+  MEETSDK_ANDROID_CONFIG_FILENAME,
+  MEETSDK_IOS_CONFIG_FILENAME,
   MEET_SDK_TOOL_CACHE_ROOT,
   ensureCacheRoot,
   resolveIosSdkCacheLayout,
+  resolveMeetSdkAndroidConfigCachePath,
+  resolveMeetSdkIosConfigCachePath,
   resolveRemoteConfigCachePath,
   writeRemoteConfigCache,
 } from "./cache.js";
@@ -108,7 +110,6 @@ export {
 } from "./remote/topsdkDownloadSdkConfig.js";
 export {
   DEFAULT_IOS_SDK_PACKAGE_TYPE,
-  DEFAULT_IOS_SDK_PLUGINS,
   buildSdkHomeDownloadUrl,
   buildSdkHomeVersionUrl,
   defaultSdkHomeApiBaseUrl,
@@ -118,6 +119,7 @@ export {
   fetchSdkHomeIosDownloadUrl,
   fetchSdkHomeIosVersion,
   fetchSdkHomeVersions,
+  resolveIosSdkDownloadPluginsFromRemoteConfig,
   resolveIosSdkRootFromDirectory,
   resolveIosSdkZipFileName,
   type DownloadIosSdkOptions,