@simplysm/sd-cli 14.0.30 → 14.0.33

package/src/capacitor/capacitor-config-writer.ts

@@ -0,0 +1,66 @@
+import { fsx, pathx } from "@simplysm/core-node";
+import type { SdCapacitorConfig } from "../sd-config.types.js";
+
+/**
+ * capacitor.config.ts를 생성한다.
+ */
+export async function writeCapacitorConfig(
+  capPath: string,
+  config: SdCapacitorConfig,
+): Promise<void> {
+  const confPath = pathx.posixResolve(capPath, "capacitor.config.ts");
+
+  const pluginOptions: Record<string, Record<string, unknown>> = {};
+  for (const [pluginName, options] of Object.entries(config.plugins ?? {})) {
+    if (options !== true) {
+      const configKey = toPascalCase(pluginName.split("/").at(-1)!);
+      pluginOptions[configKey] = options;
+    }
+  }
+
+  const pluginsConfigStr =
+    Object.keys(pluginOptions).length > 0
+      ? JSON.stringify(pluginOptions, null, 2).replace(/^/gm, "  ").trim()
+      : "{}";
+
+  const configContent = `import type { CapacitorConfig } from "@capacitor/cli";
+
+const config: CapacitorConfig = {
+  appId: "${config.appId}",
+  appName: "${config.appName}",
+  server: {
+    androidScheme: "http",
+    cleartext: true
+  },
+  android: {},
+  plugins: ${pluginsConfigStr},
+};
+
+export default config;
+`;
+
+  await fsx.write(confPath, configContent);
+}
+
+/**
+ * capacitor.config.ts의 server.url을 업데이트한다.
+ * WebView가 이 URL에서 웹 에셋을 로드하여 Hot Reload가 동작한다.
+ */
+export async function updateServerUrl(capPath: string, url: string): Promise<void> {
+  const configPath = pathx.posixResolve(capPath, "capacitor.config.ts");
+  let content = await fsx.read(configPath);
+
+  if (content.includes("url:")) {
+    content = content.replace(/url:\s*"[^"]*"/, `url: "${url}"`);
+  } else if (content.includes("server:")) {
+    content = content.replace(/server:\s*\{/, `server: {\n    url: "${url}",`);
+  }
+
+  await fsx.write(configPath, content);
+}
+
+function toPascalCase(str: string): string {
+  return str
+    .replace(/[-_](.)/g, (_, c: string) => c.toUpperCase())
+    .replace(/^./, (c) => c.toUpperCase());
+}

package/src/capacitor/capacitor-icon.ts

@@ -0,0 +1,75 @@
+import { cpx, fsx, pathx } from "@simplysm/core-node";
+import { consola, LogLevels } from "consola";
+
+const _logger = consola.withTag("sd:cli:capacitor");
+
+/**
+ * 앱 아이콘 처리 (소스 이미지 → 멀티 해상도 아이콘 + 스플래시)
+ */
+export async function setupIcon(
+  pkgPath: string,
+  capPath: string,
+  iconRelPath: string,
+): Promise<void> {
+  const iconPath = pathx.posixResolve(pkgPath, iconRelPath);
+
+  if (!(await fsx.exists(iconPath))) {
+    _logger.warn(`아이콘 파일을 찾을 수 없습니다: ${iconPath}`);
+    return;
+  }
+
+  try {
+    const sharp = (await import("sharp")).default;
+
+    // 소스 이미지를 리사이즈 (60% of 1024 = ~614px)
+    const canvasSize = 1024;
+    const contentSize = Math.round(canvasSize * 0.6);
+
+    const resizedBuffer = await sharp(iconPath)
+      .resize(contentSize, contentSize, { fit: "inside" })
+      .png()
+      .toBuffer();
+
+    // 1024x1024 투명 캔버스에 합성
+    const assetsDir = pathx.posixResolve(capPath, "assets");
+    await fsx.mkdir(assetsDir);
+    const logoPath = pathx.posixResolve(assetsDir, "logo.png");
+
+    await sharp({
+      create: {
+        width: canvasSize,
+        height: canvasSize,
+        channels: 4 as const,
+        background: { r: 0, g: 0, b: 0, alpha: 0 },
+      },
+    })
+      .composite([{ input: resizedBuffer, gravity: "center" }])
+      .png()
+      .toFile(logoPath);
+
+    // capacitor-assets로 모든 해상도 아이콘/스플래시 생성
+    const isDebug = consola.level >= LogLevels.debug;
+    await cpx.spawn(
+      "pnpm",
+      [
+        "exec",
+        "capacitor-assets",
+        "generate",
+        "--iconBackgroundColor",
+        "transparent",
+        "--splashBackgroundColor",
+        "transparent",
+        "--logoSplashScale",
+        "0.6",
+      ],
+      {
+        cwd: capPath,
+        ...(isDebug ? { stdio: ["ignore", "inherit", "inherit"] } : {}),
+      },
+    );
+  } catch (err) {
+    _logger.warn(
+      `아이콘 생성에 실패했습니다: ${err instanceof Error ? err.message : err}`,
+    );
+  }
+}

package/src/capacitor/capacitor-npm-config.ts

@@ -0,0 +1,192 @@
+import path from "path";
+import { existsSync } from "node:fs";
+import { createRequire } from "module";
+import { consola, LogLevels } from "consola";
+import { cpx, fsx, pathx } from "@simplysm/core-node";
+import type { NpmConfig, SdCapacitorConfig } from "../sd-config.types.js";
+
+const logger = consola.withTag("sd:cli:capacitor:npm-config");
+
+/**
+ * .capacitor/package.json을 구성하고 의존성 변경 여부를 반환한다.
+ */
+export async function setupCapNpmConfig(
+  capPath: string,
+  pkgPath: string,
+  config: SdCapacitorConfig,
+  npmConfig: NpmConfig,
+  platforms: string[],
+  exclude: string[],
+): Promise<boolean> {
+  const projNpmConfigPath = pathx.posixResolve(findWorkspaceRoot(pkgPath), "package.json");
+
+  if (!(await fsx.exists(projNpmConfigPath))) {
+    throw new Error(`루트 package.json을 찾을 수 없습니다: ${projNpmConfigPath}`);
+  }
+
+  const projNpmConfig = await fsx.readJson<NpmConfig>(projNpmConfigPath);
+
+  const capNpmConfPath = pathx.posixResolve(capPath, "package.json");
+  const orgCapNpmConf: NpmConfig = (await fsx.exists(capNpmConfPath))
+    ? await fsx.readJson<NpmConfig>(capNpmConfPath)
+    : { name: "", version: "" };
+
+  const capNpmConf: NpmConfig = { ...orgCapNpmConf };
+  capNpmConf.name = config.appId;
+  capNpmConf.version = npmConfig.version;
+  if (projNpmConfig.volta != null) {
+    capNpmConf.volta = projNpmConfig.volta;
+  }
+
+  // 기본 의존성
+  capNpmConf.dependencies = capNpmConf.dependencies ?? {};
+  capNpmConf.dependencies["@capacitor/core"] = "^7";
+  capNpmConf.dependencies["@capacitor/app"] = "^7";
+  for (const platform of platforms) {
+    capNpmConf.dependencies[`@capacitor/${platform}`] = "^7";
+  }
+
+  capNpmConf.devDependencies = capNpmConf.devDependencies ?? {};
+  capNpmConf.devDependencies["@capacitor/cli"] = "^7";
+  capNpmConf.devDependencies["@capacitor/assets"] = "^3";
+
+  // 플러그인 패키지 설정
+  const mainDeps = {
+    ...npmConfig.dependencies,
+    ...npmConfig.devDependencies,
+    ...npmConfig.peerDependencies,
+  };
+
+  const usePlugins = Object.keys(config.plugins ?? {});
+
+  const prevPlugins = Object.keys(capNpmConf.dependencies).filter(
+    (item) =>
+      !["@capacitor/core", "@capacitor/android", "@capacitor/ios", "@capacitor/app"].includes(
+        item,
+      ),
+  );
+
+  // 사용하지 않는 플러그인 제거
+  for (const prevPlugin of prevPlugins) {
+    if (!usePlugins.includes(prevPlugin)) {
+      delete capNpmConf.dependencies[prevPlugin];
+      logger.debug(`플러그인 제거: ${prevPlugin}`);
+    }
+  }
+
+  // 새 플러그인 추가
+  const pkgRequire = createRequire(pathx.posixResolve(pkgPath, "package.json"));
+  for (const plugin of usePlugins) {
+    const version = mainDeps[plugin] ?? "*";
+    if (typeof version === "string" && version.startsWith("workspace:")) {
+      const pluginPkgJsonPath = pkgRequire.resolve(`${plugin}/package.json`);
+      const pluginDir = path.dirname(pluginPkgJsonPath);
+      const relativePath = path.relative(capPath, pluginDir).replace(/\\/g, "/");
+      capNpmConf.dependencies[plugin] = `link:${relativePath}`;
+      logger.debug(`workspace 플러그인 (link): ${plugin} → ${relativePath}`);
+    } else if (!(plugin in capNpmConf.dependencies)) {
+      capNpmConf.dependencies[plugin] = version;
+      logger.debug(`플러그인 추가: ${plugin}@${version}`);
+    }
+  }
+
+  // exclude 패키지 추가
+  for (const excludePkg of exclude) {
+    if (!(excludePkg in capNpmConf.dependencies)) {
+      const version = mainDeps[excludePkg] ?? "*";
+      capNpmConf.dependencies[excludePkg] = version;
+      logger.debug(`exclude 패키지 추가: ${excludePkg}@${version}`);
+    }
+  }
+
+  // 저장
+  await fsx.mkdir(capPath);
+  await fsx.writeJson(capNpmConfPath, capNpmConf, { space: 2 });
+
+  // 의존성 변경 여부 확인
+  return (
+    orgCapNpmConf.volta !== capNpmConf.volta ||
+    JSON.stringify(orgCapNpmConf.dependencies) !== JSON.stringify(capNpmConf.dependencies) ||
+    JSON.stringify(orgCapNpmConf.devDependencies) !== JSON.stringify(capNpmConf.devDependencies)
+  );
+}
+
+/**
+ * Capacitor 프로젝트 NPM 초기화 (pnpm install, cap init, www placeholder).
+ * 의존성 변경 시 true를 반환한다.
+ */
+export async function initCapNpmProject(
+  capPath: string,
+  pkgPath: string,
+  config: SdCapacitorConfig,
+  npmConfig: NpmConfig,
+  platforms: string[],
+  exclude: string[],
+): Promise<boolean> {
+  logger.debug("package.json 설정 시작");
+  const depChanged = await setupCapNpmConfig(capPath, pkgPath, config, npmConfig, platforms, exclude);
+  const nodeModulesExists = await fsx.exists(pathx.posixResolve(capPath, "node_modules"));
+  logger.debug(`depChanged: ${depChanged}, nodeModulesExists: ${nodeModulesExists}`);
+
+  if (!depChanged && nodeModulesExists) {
+    logger.debug("의존성 변경 없음");
+    return false;
+  }
+
+  // pnpm-workspace.yaml 생성 (상위 workspace 탐색 차단)
+  const workspaceYamlPath = pathx.posixResolve(capPath, "pnpm-workspace.yaml");
+  if (!(await fsx.exists(workspaceYamlPath))) {
+    await fsx.write(workspaceYamlPath, "");
+  }
+
+  // pnpm install + 빌드 스크립트 승인
+  const isDebug = consola.level >= LogLevels.debug;
+  logger.debug("pnpm install 시작");
+  await cpx.spawn("pnpm", ["install"], {
+    cwd: capPath,
+    ...(isDebug ? { stdio: ["ignore", "inherit", "inherit"] } : {}),
+  });
+  await cpx.spawn("pnpm", ["approve-builds", "--all"], {
+    cwd: capPath,
+    ...(isDebug ? { stdio: ["ignore", "inherit", "inherit"] } : {}),
+  });
+  logger.debug("pnpm install 완료");
+
+  // 멱등성: capacitor.config.ts가 없을 때만 cap init 실행
+  const configPath = pathx.posixResolve(capPath, "capacitor.config.ts");
+  if (!(await fsx.exists(configPath))) {
+    logger.debug("cap init 시작");
+    await cpx.spawn("pnpm", ["exec", "cap", "init", config.appId, config.appId], {
+      cwd: capPath,
+      ...(isDebug ? { stdio: ["ignore", "inherit", "inherit"] } : {}),
+    });
+    logger.debug("cap init 완료");
+  }
+
+  // www/index.html placeholder (cap sync/copy에 필요, 이미 존재하면 유지)
+  const wwwPath = pathx.posixResolve(capPath, "www");
+  await fsx.mkdir(wwwPath);
+  const wwwIndexPath = pathx.posixResolve(wwwPath, "index.html");
+  if (!(await fsx.exists(wwwIndexPath))) {
+    await fsx.write(
+      wwwIndexPath,
+      "<!DOCTYPE html><html><head></head><body></body></html>",
+    );
+  }
+
+  return true;
+}
+
+function findWorkspaceRoot(pkgPath: string): string {
+  let dir = pkgPath;
+  while (true) {
+    const parent = path.dirname(dir);
+    if (parent === dir) {
+      throw new Error(`워크스페이스 루트를 찾을 수 없습니다: ${pkgPath}`);
+    }
+    if (existsSync(pathx.posixResolve(parent, "pnpm-workspace.yaml"))) {
+      return parent;
+    }
+    dir = parent;
+  }
+}