Mpx 跨端输出 RN 开发与适配指南

背景介绍

Mpx 是一个以微信小程序语法为基础、进行了类 Vue 语法拓展支持的跨端开发框架，支持将同一套代码输出到小程序（微信、支付宝、百度等）、Web 和 React Native 平台。Mpx2RN 在编译时和运行时对模板、脚本、样式与 JSON 配置四大维度的开发能力进行了全面抹平，但与小程序、Web 平台仍存在一定能力差异。

适用场景

本 SKILL 是 Mpx2RN 开发适配的统一指南，覆盖模板、脚本、样式、JSON 配置四大维度。涉及 Mpx2RN 的任务均应在动笔前阅读本 SKILL 的通用约束与适配原则，包括但不限于：

• 技术方案设计：评估需求在 RN 平台的可行性、跨端兼容方案选型、是否需要文件级条件编译或混合开发等;
• 旧项目跨端适配改造：对已基于小程序规范编写、未适配 RN 的存量组件进行兼容性补齐（参见下文任务一）;
• 页面 / 组件开发迭代：从零编写或迭代符合 RN 跨端兼容规范的 .mpx 页面与组件（参见下文任务二）;
• 编译和运行时报错排查：定位 RN 平台特有的编译错误（如样式空选择器、保留关键字、缩进敏感预处理器报错等）与运行时差异;
• Code Review：以本 SKILL 的通用约束与适配原则为标准对照检查跨端兼容性。

不适用场景

以下场景与 Mpx2RN 无关，不应调用本 SKILL：