mcpField
M
meteor-native

meteor-native

github.com/meteor开发10118 次安装5 天前更新
代码仓库

关于 meteor-native

将现有 Meteor 应用转为可复现 Cordova 构建并检查设备或分发行为的 skill。内容涵盖匹配发行版的工具链、原生配置、重建判断及目标验证。

主要功能

  1. 01检查 Meteor 与 Cordova 项目状态
  2. 02按 Meteor 发行版匹配前置条件
  3. 03配置原生插件和设置
  4. 04构建并分发 Android 或 iOS 应用
  5. 05区分网页更新与二进制变更
  6. 06验证目标设备和构建产物

适用场景

  1. 01在 Android 或 iOS 设备上设置或运行应用
  2. 02修改插件、权限或原生偏好设置
  3. 03准备已签名的移动端分发产物

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/meteor/agent-skills --skill meteor-native

安装后在 Claude Code 中输入/meteor-native确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
build-and-distribution.md
configuration-and-plugins.md
eval-cases.md
hot-code-push.md
toolchain-and-development.md

详细介绍

Meteor 原生应用

将现有 Meteor 应用转换为可复现的 Cordova 构建，并验证所需的设备或分发行为。Meteor 管理 Web 资源包、Cordova 项目和平台版本；Android Studio 和 Xcode 提供原生调试、签名和分发工具。

选择工作流

  1. 阅读 .meteor/release、.meteor/platforms、.meteor/cordova-plugins、.meteor/versions、package.json，以及存在时的 mobile-config.js。记录主机操作系统、目标设备/平台、已安装的原生二进制版本，以及任务需要开发运行、Web 更新还是新二进制。
  2. 根据所选 Meteor 版本和解析后的 Cordova 平台匹配前置条件。Meteor 3.5.2 使用 [email protected]、[email protected] 和 [email protected]；较早版本的固定版本各不相同。不要仅仅因为有更新的独立 Cordova 平台可用就选择它。
  3. 选择下方相关的参考文档。将持久更改保存在应用的平台/插件声明、配置和资源中；检查生成的原生输出，确认 Meteor 实际生成的内容。
  4. 更改原生插件、平台版本、权限或原生配置后，重新构建/安装。HCP 可以更新兼容的 Web 代码/资源，但无法提供缺失的原生代码，也无法更改已安装二进制的元数据。
  5. 在目标模拟器/设备上验证，或检查所需构件。记录命令、版本、端点和可观察结果。仅成功构建 Web 应用，并不能验证原生应用或已签名的商店构件。
任务阅读
设置 Android/iOS、添加/移除平台、运行设备、选择 WebView 兼容性工具链和开发
更改应用元数据/资源、原生偏好设置、访问规则、插件、权限或构建覆盖项配置和插件
构建 Android 构件或 iOS 项目、配置签名并准备分发构建和分发
修复移动端更新交付、兼容性拒绝、下载或重新加载行为热代码推送

持久状态和运行时边界

  • 默认情况下，.meteor/local/cordova-build/ 是生成目录。如果设置了 METEOR_LOCAL_DIR，请先确定实际本地目录，再打开或清理其 cordova-build 子目录。不要清除整个本地状态，也不要为了修复 Cordova 缓存而清除本地 Mongo 数据库。
  • mobile-config.js 是构建时配置文件，不是应用模块。App.configurePlugin 用于提供安装变量；它既不会安装插件，也不会运行插件的 JavaScript API。
  • 在客户端代码中调用原生插件 API，并使用 Meteor.isCordova 进行保护；在 Meteor.startup 内或设备就绪后的等效位置调用。Meteor 的 Cordova 启动会等待 deviceready；浏览器/服务器代码仍必须保留适当的回退方案。启动过程不会自动授予操作系统权限。
  • 物理设备上的 localhost 指的是设备本身。开发时通过 --mobile-server 指定可访问的端点，分发时通过 meteor build --server 指定。嵌入式 WebView 的本地内容服务器与 Meteor 后端及 DDP 连接相互独立。

相邻工作流

请求负责人
未知崩溃、数据卡住，或尚未确定是否属于原生行为的故障meteor-debugging，然后带着已确认的原生边界返回
托管后端、配置 Galaxy/Docker、部署服务器更改、保留 HCP 客户端包meteor-deployment
Rspack/SWC/模块图或原生 npm 插件（如 sharp）meteor-modern-build-stack 或 migrate-to-rspack
OAuth 提供商/登录行为meteor-accounts；如需 Cordova 插件或原生配置，请使用此技能
明确使用 React Native/Expo 或 Capacitor 的应用保留所选技术栈；此技能不实现这些集成

验收

使用评估用例检查原生决策、较早版本的行为，以及相邻技能的路由。

评论

支持 Markdown