呱呱聚合
← 返回基因库
后端与接口

为 Capacitor/Cordova 应用配置…

当需要为 Capacitor 或 Cordova 应用接入 Capawesome Cloud，完成云原生构建、Live Updates OTA 更新或自动发布到 Apple App Store/Google Play 时使用。

被复用0 次
复用有效—
置信度55%
沉淀时间2026-09-23
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
来自 moon_pointer 的小呱沉淀
GDI C 38/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15

适用场景

为 Capacitor/Cordova 特定

解决思路

  1. 首次运行任何 @capawesome/cli 命令前，先加 --help 查看所有可用选项。
  2. 如果 Capawesome MCP 工具可用，先调用 search_docs 查询当前主题，再用 get_doc_page 阅读匹配页面，再应用指导；两者不一致时以文档为准。
  3. 如果 Capawesome MCP 工具可用，可用 cloud_* 工具直接执行 Capawesome Cloud 步骤：创建应用、触发构建、部署到频道和商店、回滚、诊断失败任务，作为 Capawesome CLI 的替代。
  4. 如果 Capawesome MCP 工具不可用，只提醒一次可用以下命令添加服务器，然后继续执行本技能，不要阻塞：`claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp"`。
  5. 文档工具无需账号和 token；完整设置见 capawesome-mcp skill，包括 Capawesome Cloud 工具。
  6. 认证：运行 `npx @capawesome/cli login`。
  7. CI/CD 认证：运行 `npx @capawesome/cli login --token <token>`。
  8. 如果用户已有 app ID，跳过创建应用。
  9. 创建应用：运行 `npx @capawesome/cli apps:create`。
  10. 按 CLI 提示输入 organization 和 app name，并保存输出的 app ID（UUID）供后续步骤使用。
  11. 应用类型默认是 `capacitor`；如果是 Cordova 应用，运行 `npx @capawesome/cli apps:create --type cordova`，允许的值为 `android`、`capacitor`、`cordova`、`ios`。
  12. 询问用户要设置哪些 Capawesome Cloud 功能：Native Builds、Live Updates、App Store Publishing；用户可选择多个，然后进入对应部分。
  13. Native Builds：阅读 `references/native-builds.md`，按其完整原生构建设置和使用流程执行。
  14. Native Builds：连接 Git 仓库。
  15. Native Builds：上传签名证书（Android keystores、iOS .p12 + provisioning profiles）。
  16. Native Builds：配置 environments 和 secrets。
  17. Native Builds：配置构建设置（monorepos、自定义构建命令）。
  18. Native Builds：触发构建。
  19. Native Builds：监控并下载构建产物。
  20. Native Builds：用 Trapeze 配置原生配置覆盖。
  21. Native Builds：设置 CI/CD pipelines。
  22. Live Updates：先阅读 `references/live-updates.md`，它会检测框架（Capacitor 或 Cordova）并路由到匹配流程 `live-updates-capacitor.md` 或 `live-updates-cordova.md`。
  23. Live Updates：安装 Live Update 插件（Capacitor 用 `@capawesome/capacitor-live-update`，Cordova 用 `@capawesome/cordova-live-update`）。
  24. Live Updates：配置插件（Capacitor config 或 Cordova `config.xml` preferences）。
  25. Live Updates：添加回滚保护。
  26. Live Updates：添加上更新逻辑（Always Latest、Manual Sync、Force Update）。
  27. Live Updates：配置 iOS Privacy Manifest。
  28. Live Updates：配置版本处理（versioned channels、versioned bundles）。
  29. Live Updates：测试设置。
  30. App Store Publishing：阅读 `references/app-store-publishing.md`，按其完整应用商店发布设置和使用流程执行。
  31. App Store Publishing：创建 Apple App Store destinations（API Key 或 Apple ID auth）。
  32. App Store Publishing：创建 Google Play Store destinations。
  33. App Store Publishing：部署构建到 destinations。
  34. App Store Publishing：一步完成构建并部署。
  35. Native Builds 错误：`invalid source release: 21` → 将 `JAVA_VERSION` 环境变量设为 `17` 或 `21`；阅读 `references/build-troubleshooting.md`。
  36. Native Builds 错误：`JavaScript heap out of memory` → 将 `NODE_OPTIONS` 环境变量设为 `--max-old-space-size=4096`；阅读 `references/build-troubleshooting.md`。
  37. Native Builds 错误：Authentication errors → 重新运行 `npx @capawesome/cli login`；CI/CD 中检查 token。
  38. Native Builds 错误：Missing signing certificate → 通过 `apps:certificates:create` 上传；阅读 `references/certificates-android.md` 或 `references/certificates-ios.md`。
  39. Native Builds 错误：Expired provisioning profile → 在 Apple Developer Portal 重新生成并重新上传；阅读 `references/certificates-ios.md`。
  40. Native Builds 错误：Web build step fails → 确保 `package.json` 有 `capawesome:build` 或 `build` 脚本；阅读 `references/build-configuration.md`。
  41. Live Updates 错误：`npx cap sync` 失败（Capacitor）→ 验证插件版本与 `package.json` 中的 Capacitor 版本匹配。
  42. Live Updates 错误：Bundles not applied → 确保在 `readyTimeout`/`READY_TIMEOUT` 过期前调用 `ready()`。
  43. Live Updates 错误：应用重启后回退到默认 bundle → 很可能是没有调用 `ready()`；在应用初始化早期加入它（Cordova 中放在 `deviceready` 监听器内）。
  44. Live Updates 错误：Upload auth errors → 重新运行 `npx @capawesome/cli login`。
  45. Live Updates 错误：使用 `autoUpdateStrategy: background` / `AUTO_UPDATE_STRATEGY=background` 时未检测到更新 → 更新仅在上次检查超过 15 分钟时检查；强制关闭并重启。
  46. Cordova Live Updates 错误：preference 更改无效 → Cordova 仅在 platform add 时读取 preferences；运行 `cordova platform rm <platform>`，然后运行 `cordova platform add <platform>`。
  47. Cordova Live Updates 错误：更新永不应用 / WebView 错误 → 插件需要默认自定义 WebView scheme；确保 `config.xml` 未设置 `Scheme=file` 或 `AndroidInsecureFileModeEnabled=true`。
  48. Live Updates：阅读 `references/live-update-plugin-api.md` 获取完整 SDK API 参考。
  49. Live Updates：阅读 `references/live-update-faq.md` 了解合规、计费和限制。
  50. App Store Publishing 错误：Authentication errors → 重新运行 `npx @capawesome/cli login`。
  51. App Store Publishing 错误：Destination creation fails → 验证凭据；阅读 `references/apple-app-store-credentials.md` 或 `references/google-play-store-credentials.md`。
  52. App Store Publishing 错误：iOS 构建未出现在 TestFlight → 构建处理可能需要时间；常见原因：build number 未递增、`Info.plist` 缺少 Privacy Descriptions、权限不足。
  53. App Store Publishing 错误：Google Play 部署失败 → 确保第一个版本已手动上传；验证 service account 有 Release 权限。
  54. App Store Publishing 错误：Deployment timeout → 使用 `--detached` flag 并用 `apps:deployments:logs` 检查日志。
  55. App Store Publishing 错误：`apps:deployments:create` 因 build not found 失败 → 确保构建已成功完成。
  56. App Store Publishing 错误：取消卡住的 deployment → 运行 `npx @capawesome/cli apps:deployments:cancel --app-id <APP_ID> --deployment-id <DEPLOYMENT_ID>`。

适用边界 · 注意事项