用途:在通过 Cordova 构建或维护 Meteor 3 Android/iOS 应用时使用,帮助把现有 Meteor 应用变成可复现的原生构建,并验证目标设备或分发行为。Meteor 负责 Web 打包、Cordova 工程与平台版本,Android Studio 和 Xcode 提供原生调试、签名与分发工具。
主要能力:先选择工作流;读取 .meteor/release、.meteor/platforms、.meteor/cordova-plugins、.meteor/versions、package.json 和 mobile-config.js(若存在),记录宿主系统、目标设备/平台、已安装原生二进制版本,以及任务属于开发运行、Web 更新还是新二进制。按所选 Meteor 版本匹配前置条件与已解析的 Cordova 平台:Meteor 3.5.2 使用 cordova-lib@13.0.0、cordova-android@15.1.0、cordova-ios@7.1.1,更早版本锁定的版本不同,不要因为可用就选最新的独立 Cordova 平台。按任务查阅参考:工具链与开发(设置 Android/iOS、增删平台、运行设备、WebView 兼容)、配置与插件(元数据/资源、原生偏好、访问规则、插件、权限、构建覆盖)、构建与分发(构建 Android 产物或 iOS 工程、配置签名、准备分发)、热代码推送(修复移动更新投递、兼容性拒绝、下载或重载行为)。
使用方式:当原生插件、平台版本、权限或原生配置变化时需重建/重装;HCP 可更新兼容的 Web 代码/资源,但无法提供缺失的原生代码或更改已安装二进制的元数据。持久变更应放在应用的平台/插件声明、配置和资源中;检查生成的产出来核实 Meteor 实际生成了什么。在目标模拟器/设备上验证,或检查所需产物,记录命令、版本、端口和可观察结果;仅 Web 构建成功不能验证原生应用或已签名的商店产物。
限制与边界:.meteor/local/cordova-build/ 默认生成;若设置了 METEOR_LOCAL_DIR,先解析实际本地目录再打开或清理其 cordova-build 子目录,不要为修 Cordova 缓存而清空整个本地状态或本地 Mongo 数据库。mobile-config.js 是构建期配置文件而非应用模块;App.configurePlugin 提供安装变量,既不安装插件也不运行其 JavaScript API。原生插件 API 应在受 Meteor.isCordova 保护的客户端代码中、于 Meteor.startup 内或等效的设备就绪后调用;启动不会自动授予 OS 权限。开发时匹配 --mobile-server,分发时用 meteor build --server 指向可达端点;内嵌 WebView 的本地内容服务器与 Meteor 后端和 DDP 连接是分开的。相邻工作流:未隔离的崩溃或卡住数据先走 meteor-debugging;后端托管、部署走 meteor-deployment;Rspack/SWC 等走 meteor-modern-build-stack 或 migrate-to-rspack;OAuth 登录走 meteor-accounts;明确使用 React Native/Expo 或 Capacitor 的项目不适用本技能。