@playcraft/devkit 1.0.31-beta.1 → 1.0.31-beta.11

package/core/engines/cocos/cli-build.js

@@ -1,4 +1,118 @@
-"use strict";const fs=require("fs");const path=require("path");const{spawnCocosSync,needsXvfb}=require("./cli.js");const{resolveCreatorOutputDir}=require("./creator-cli.js");const{stripAdsdkCjsImport}=require("./strip-social-share.js");function shouldSkipEngineBuild(buildOptions={}){const cocos=buildOptions.cocos||{};return Boolean(buildOptions.skipEngineBuild||cocos.skipEngineBuild||process.env.PLAYABLE_SKIP_ENGINE_BUILD==="1")}function resolveWebMobileDest(projectRoot,buildOptions={}){const cocos=buildOptions.cocos||{};const fromConfig=resolveCreatorOutputDir(projectRoot,cocos.buildConfig||"build-configs/web-mobile.json");const explicit=cocos.webMobileDir?path.resolve(projectRoot,cocos.webMobileDir):null;if(shouldSkipEngineBuild(buildOptions)){return explicit||fromConfig||path.resolve(projectRoot,"dist/web-mobile")}return fromConfig||explicit||path.resolve(projectRoot,"dist/web-mobile")}function logStrip(result){if(result.skipped&&result.reason==="missing"){console.warn("[cocos] adsdk CJS missing, skip social-share strip");return}if(result.skipped&&result.reason==="already"){console.log("[cocos] social-share import() already stripped");return}if(result.skipped){console.warn("[cocos] social-share import() not found in CJS");return}console.log("[cocos] stripped social-share import() from adsdk CJS")}/**
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnCocosSync, needsXvfb } = require('./cli.js');
+const { resolveCreatorOutputDir } = require('./creator-cli.js');
+const { stripAdsdkCjsImport } = require('./strip-social-share.js');
+const { prepareWritableCocosCli } = require('./writable-cli.js');
+const { cleanCocosProjectCaches, ensureWritableCocosWorkdirs, shouldCleanCocosCache } = require('./clean-cache.js');
+
+function shouldSkipEngineBuild(buildOptions = {}) {
+  const cocos = buildOptions.cocos || {};
+  return Boolean(
+    buildOptions.skipEngineBuild ||
+    cocos.skipEngineBuild ||
+    process.env.PLAYABLE_SKIP_ENGINE_BUILD === '1'
+  );
+}
+
+function resolveWebMobileDest(projectRoot, buildOptions = {}) {
+  const cocos = buildOptions.cocos || {};
+  const fromConfig = resolveCreatorOutputDir(projectRoot, cocos.buildConfig || 'build-configs/web-mobile.json');
+  const explicit = cocos.webMobileDir ? path.resolve(projectRoot, cocos.webMobileDir) : null;
+  if (shouldSkipEngineBuild(buildOptions)) {
+    return explicit || fromConfig || path.resolve(projectRoot, 'dist/web-mobile');
+  }
+  return fromConfig || explicit || path.resolve(projectRoot, 'dist/web-mobile');
+}
+
+function logStrip(result) {
+  if (result.skipped && result.reason === 'missing') {
+    console.warn('[cocos] adsdk CJS missing, skip social-share strip');
+    return;
+  }
+  if (result.skipped && result.reason === 'already') {
+    console.log('[cocos] social-share import() already stripped');
+    return;
+  }
+  if (result.skipped) {
+    console.warn('[cocos] social-share import() not found in CJS');
+    return;
+  }
+  console.log('[cocos] stripped social-share import() from adsdk CJS');
+}
+
+/**
  * 用官方 cocos CLI 打 web-mobile（不再走 Creator 编辑器）。
  * Linux 上自动套 xvfb-run -a（shader 编译需要虚拟显示）。
- */function runCocosEngineBuild(projectRoot,buildOptions={}){logStrip(stripAdsdkCjsImport(projectRoot));const dest=resolveWebMobileDest(projectRoot,buildOptions);if(shouldSkipEngineBuild(buildOptions)){if(!fs.existsSync(dest)){throw new Error(`[cocos] skipEngineBuild but missing ${path.relative(projectRoot,dest)}`)}console.log(`[cocos] skip engine build, using ${path.relative(projectRoot,dest)}`);return dest}const cocos=buildOptions.cocos||{};const configRel=cocos.buildConfig||"build-configs/web-mobile.json";const configPath=path.resolve(projectRoot,configRel);if(!fs.existsSync(configPath)){throw new Error(`[cocos] missing build config: ${configRel}`)}const args=["--no-interactive","build","--project",projectRoot,"--platform","web-mobile","--build-config",configPath];if(needsXvfb()){console.log("[cocos] linux, wrapping xvfb-run -a")}console.log(`[cocos] build web-mobile ← ${configRel}`);const result=spawnCocosSync(args,{cwd:projectRoot,stdio:"inherit",env:process.env});if(result.error){throw result.error}if(result.status!==0){throw new Error(`[cocos] build failed, exit ${result.status}`)}console.log(`[cocos] web-mobile ready at ${path.relative(projectRoot,dest)}`);return dest}module.exports={runCocosEngineBuild,resolveWebMobileDest,shouldSkipEngineBuild};
+ */
+function runCocosEngineBuild(projectRoot, buildOptions = {}) {
+  logStrip(stripAdsdkCjsImport(projectRoot));
+
+  const dest = resolveWebMobileDest(projectRoot, buildOptions);
+  if (shouldSkipEngineBuild(buildOptions)) {
+    if (!fs.existsSync(dest)) {
+      throw new Error(`[cocos] skipEngineBuild but missing ${path.relative(projectRoot, dest)}`);
+    }
+    console.log(`[cocos] skip engine build, using ${path.relative(projectRoot, dest)}`);
+    return dest;
+  }
+
+  if (shouldCleanCocosCache(buildOptions)) {
+    const removed = cleanCocosProjectCaches(projectRoot);
+    console.log(`[cocos] cleaned project caches: ${removed.join(', ') || '(none)'}`);
+  }
+  ensureWritableCocosWorkdirs(projectRoot);
+
+  const cocos = buildOptions.cocos || {};
+  const configRel = cocos.buildConfig || 'build-configs/web-mobile.json';
+  const configPath = path.resolve(projectRoot, configRel);
+  if (!fs.existsSync(configPath)) {
+    throw new Error(`[cocos] missing build config: ${configRel}`);
+  }
+
+  const args = [
+    '--no-interactive',
+    'build',
+    '--project',
+    projectRoot,
+    '--platform',
+    'web-mobile',
+    '--build-config',
+    configPath,
+  ];
+
+  const prepared = prepareWritableCocosCli(projectRoot);
+  const env = { ...process.env, ...prepared.env };
+
+  if (needsXvfb()) {
+    console.log('[cocos] linux, wrapping xvfb-run -a');
+  }
+  console.log(`[cocos] build web-mobile ← ${configRel}`);
+
+  const result = spawnCocosSync(args, {
+    cwd: projectRoot,
+    stdio: 'inherit',
+    env,
+  });
+
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`[cocos] build failed, exit ${result.status}`);
+  }
+
+  console.log(`[cocos] web-mobile ready at ${path.relative(projectRoot, dest)}`);
+  return dest;
+}
+
+module.exports = {
+  runCocosEngineBuild,
+  resolveWebMobileDest,
+  shouldSkipEngineBuild,
+  cleanCocosProjectCaches,
+  ensureWritableCocosWorkdirs,
+  shouldCleanCocosCache,
+};

package/core/engines/cocos/cli.js

@@ -1 +1,38 @@
-"use strict";const{spawn,spawnSync}=require("child_process");function resolveCocosBin(){return process.env.COCOS_CLI||"cocos"}function needsXvfb(){return process.platform==="linux"}function cocosCommand(args){const bin=resolveCocosBin();if(needsXvfb()){return{cmd:"xvfb-run",args:["-a",bin,...args]}}return{cmd:bin,args}}function spawnCocos(args,options){const{cmd,args:fullArgs}=cocosCommand(args);return spawn(cmd,fullArgs,options)}function spawnCocosSync(args,options){const{cmd,args:fullArgs}=cocosCommand(args);return spawnSync(cmd,fullArgs,options)}module.exports={resolveCocosBin,needsXvfb,spawnCocos,spawnCocosSync};
+'use strict';
+
+const { spawn, spawnSync } = require('child_process');
+
+function resolveCocosBin(env = process.env) {
+  return env.COCOS_CLI || 'cocos';
+}
+
+function needsXvfb() {
+  return process.platform === 'linux';
+}
+
+function cocosCommand(args, env = process.env) {
+  const bin = resolveCocosBin(env);
+  if (needsXvfb()) {
+    return { cmd: 'xvfb-run', args: ['-a', bin, ...args] };
+  }
+  return { cmd: bin, args };
+}
+
+function spawnCocos(args, options = {}) {
+  const env = options.env || process.env;
+  const { cmd, args: fullArgs } = cocosCommand(args, env);
+  return spawn(cmd, fullArgs, options);
+}
+
+function spawnCocosSync(args, options = {}) {
+  const env = options.env || process.env;
+  const { cmd, args: fullArgs } = cocosCommand(args, env);
+  return spawnSync(cmd, fullArgs, options);
+}
+
+module.exports = {
+  resolveCocosBin,
+  needsXvfb,
+  spawnCocos,
+  spawnCocosSync,
+};

package/core/engines/cocos/constants.js

@@ -1 +1,21 @@
-"use strict";const ADAPTER_FETCH="adapterFetch";const TO_STRING_EXTNAME=[".txt",".xml",".vsh",".fsh",".atlas",".tmx",".tsx",".json",".ExportJson",".plist",".fnt",".js",".zip"];const TO_SKIP_EXTNAME=[".ico",".html",".css"];const TRANSPARENT_GIF="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7";const FILE_MAX_SIZE=2*1024*1024*0.8;const THEME_ASSET_EXT=/\.(png|webp|jpe?g|gif|svg|mp3|wav|m4a|ogg|mp4)$/i;module.exports={ADAPTER_FETCH,TO_STRING_EXTNAME,TO_SKIP_EXTNAME,TRANSPARENT_GIF,FILE_MAX_SIZE,THEME_ASSET_EXT};
+'use strict';
+
+const ADAPTER_FETCH = 'adapterFetch';
+const TO_STRING_EXTNAME = [
+  '.txt', '.xml', '.vsh', '.fsh', '.atlas', '.tmx', '.tsx', '.json',
+  '.ExportJson', '.plist', '.fnt', '.js', '.zip'
+];
+const TO_SKIP_EXTNAME = ['.ico', '.html', '.css'];
+const TRANSPARENT_GIF =
+  'data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7';
+const FILE_MAX_SIZE = 2 * 1024 * 1024 * 0.8;
+const THEME_ASSET_EXT = /\.(png|webp|jpe?g|gif|svg|mp3|mpeg|wav|m4a|aac|ogg|mp4)$/i;
+
+module.exports = {
+  ADAPTER_FETCH,
+  TO_STRING_EXTNAME,
+  TO_SKIP_EXTNAME,
+  TRANSPARENT_GIF,
+  FILE_MAX_SIZE,
+  THEME_ASSET_EXT,
+};

package/core/engines/cocos/creator-cli.js

@@ -1 +1,108 @@
-"use strict";const fs=require("fs");const path=require("path");const{spawnSync}=require("child_process");function readCreatorVersion(root){try{const pkg=require(path.join(root,"package.json"));return pkg.creator&&pkg.creator.version||"3.8.6"}catch{return"3.8.6"}}function resolveCreator(root,creatorBin){if(creatorBin)return creatorBin;if(process.env.COCOS_CREATOR)return process.env.COCOS_CREATOR;const version=readCreatorVersion(root);const darwin=[`/Applications/Cocos/Creator/${version}/CocosCreator.app/Contents/MacOS/CocosCreator`,`/Applications/CocosCreator/Creator/${version}/CocosCreator.app/Contents/MacOS/CocosCreator`];const win32=[`C:\\ProgramData\\cocos\\editors\\Creator\\${version}\\CocosCreator.exe`,`C:\\Cocos\\Creator\\${version}\\CocosCreator.exe`,`C:\\CocosCreator\\Creator\\${version}\\CocosCreator.exe`];const linux=[`/opt/Cocos/Creator/${version}/CocosCreator`,`${process.env.HOME||""}/Cocos/Creator/${version}/CocosCreator`];const candidates=process.platform==="darwin"?darwin:process.platform==="win32"?win32:linux;return candidates.find(p=>p&&fs.existsSync(p))}function creatorEnv(){const env={...process.env};delete env.ELECTRON_RUN_AS_NODE;return env}function resolveCreatorOutputDir(root,buildConfigRel){const configPath=path.resolve(root,buildConfigRel||"build-configs/web-mobile.json");if(!fs.existsSync(configPath))return null;try{const cfg=JSON.parse(fs.readFileSync(configPath,"utf8"));const outputName=cfg.outputName||"web-mobile";const buildPath=cfg.buildPath||"project://build";if(buildPath.startsWith("project://")){const rel=buildPath.slice("project://".length).replace(/^\/+/,"");return path.resolve(root,rel,outputName)}if(path.isAbsolute(buildPath))return path.join(buildPath,outputName);return path.resolve(root,buildPath,outputName)}catch{return null}}function runCreatorBuild(root,buildOptions){const cocos=buildOptions.cocos||{};if(cocos.skipEngineBuild){console.log("[cocos] skipEngineBuild: using existing web-mobile");return}const configPath=path.resolve(root,cocos.buildConfig||"build-configs/web-mobile.json");if(!fs.existsSync(configPath)){throw new Error(`[cocos] missing Creator build config: ${configPath}`)}const bin=resolveCreator(root,cocos.creatorBin);if(!bin){throw new Error("[cocos] Cocos Creator not found. Set COCOS_CREATOR or cocos.creatorBin.")}if(process.platform==="linux"){console.warn("[cocos] Creator fallback on linux; prefer official cocos CLI (xvfb-run -a).")}const buildArg=`configPath=${configPath.replace(/\\/g,"/")};stage=build`;console.log(`[cocos] ${bin}`);console.log(`[cocos] --build ${buildArg}`);const result=spawnSync(bin,["--project",root,"--nologin","--build",buildArg],{cwd:root,stdio:"inherit",env:creatorEnv()});if(result.error)throw result.error;const code=result.status;if(code===36||code===0){console.log("[cocos] web-mobile ready");return}throw new Error(`[cocos] Creator build failed, exit ${code}`)}module.exports={readCreatorVersion,resolveCreator,resolveCreatorOutputDir,creatorEnv,runCreatorBuild};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+function readCreatorVersion(root) {
+  try {
+    const pkg = require(path.join(root, 'package.json'));
+    return (pkg.creator && pkg.creator.version) || '3.8.6';
+  } catch {
+    return '3.8.6';
+  }
+}
+
+function resolveCreator(root, creatorBin) {
+  if (creatorBin) return creatorBin;
+  if (process.env.COCOS_CREATOR) return process.env.COCOS_CREATOR;
+
+  const version = readCreatorVersion(root);
+  const darwin = [
+    `/Applications/Cocos/Creator/${version}/CocosCreator.app/Contents/MacOS/CocosCreator`,
+    `/Applications/CocosCreator/Creator/${version}/CocosCreator.app/Contents/MacOS/CocosCreator`,
+  ];
+  const win32 = [
+    `C:\\ProgramData\\cocos\\editors\\Creator\\${version}\\CocosCreator.exe`,
+    `C:\\Cocos\\Creator\\${version}\\CocosCreator.exe`,
+    `C:\\CocosCreator\\Creator\\${version}\\CocosCreator.exe`,
+  ];
+  const linux = [
+    `/opt/Cocos/Creator/${version}/CocosCreator`,
+    `${process.env.HOME || ''}/Cocos/Creator/${version}/CocosCreator`,
+  ];
+  const candidates = process.platform === 'darwin' ? darwin : process.platform === 'win32' ? win32 : linux;
+  return candidates.find((p) => p && fs.existsSync(p));
+}
+
+function creatorEnv() {
+  const env = { ...process.env };
+  delete env.ELECTRON_RUN_AS_NODE;
+  return env;
+}
+
+function resolveCreatorOutputDir(root, buildConfigRel) {
+  const configPath = path.resolve(root, buildConfigRel || 'build-configs/web-mobile.json');
+  if (!fs.existsSync(configPath)) return null;
+  try {
+    const cfg = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    const outputName = cfg.outputName || 'web-mobile';
+    const buildPath = cfg.buildPath || 'project://build';
+    if (buildPath.startsWith('project://')) {
+      const rel = buildPath.slice('project://'.length).replace(/^\/+/, '');
+      return path.resolve(root, rel, outputName);
+    }
+    if (path.isAbsolute(buildPath)) return path.join(buildPath, outputName);
+    return path.resolve(root, buildPath, outputName);
+  } catch {
+    return null;
+  }
+}
+
+function runCreatorBuild(root, buildOptions) {
+  const cocos = buildOptions.cocos || {};
+  if (cocos.skipEngineBuild) {
+    console.log('[cocos] skipEngineBuild: using existing web-mobile');
+    return;
+  }
+
+  const configPath = path.resolve(root, cocos.buildConfig || 'build-configs/web-mobile.json');
+  if (!fs.existsSync(configPath)) {
+    throw new Error(`[cocos] missing Creator build config: ${configPath}`);
+  }
+
+  const bin = resolveCreator(root, cocos.creatorBin);
+  if (!bin) {
+    throw new Error('[cocos] Cocos Creator not found. Set COCOS_CREATOR or cocos.creatorBin.');
+  }
+
+  if (process.platform === 'linux') {
+    console.warn('[cocos] Creator fallback on linux; prefer official cocos CLI (xvfb-run -a).');
+  }
+
+  const buildArg = `configPath=${configPath.replace(/\\/g, '/')};stage=build`;
+  console.log(`[cocos] ${bin}`);
+  console.log(`[cocos] --build ${buildArg}`);
+
+  const result = spawnSync(bin, ['--project', root, '--nologin', '--build', buildArg], {
+    cwd: root,
+    stdio: 'inherit',
+    env: creatorEnv(),
+  });
+
+  if (result.error) throw result.error;
+  const code = result.status;
+  if (code === 36 || code === 0) {
+    console.log('[cocos] web-mobile ready');
+    return;
+  }
+  throw new Error(`[cocos] Creator build failed, exit ${code}`);
+}
+
+module.exports = {
+  readCreatorVersion,
+  resolveCreator,
+  resolveCreatorOutputDir,
+  creatorEnv,
+  runCreatorBuild,
+};