前端Web框架SSR前端构建插件系统微前端跨平台【免费下载链接】ice ice.js: The Progressive App Framework Based On React基于 React 的渐进式应用框架项目地址https://gitcode.com/gh_mirrors/ice1/ice点击查看免费下载小程序端能力与 Web 应用大部分对齐但在 API 调用层面有其特殊性不同小程序平台微信、阿里系、字节、百度等暴露的原生 API 命名与行为各不相同。本文基于 ice.js 官方文档 小程序-API 展开系统讲解 ice.js 小程序开发中两类 API 的使用方式——面向多端统一调用的Uni APIUniversal API与面向单端能力的小程序原生 API并结合仓库源码解析uni/env环境判断的底层实现与按环境拆包的原理帮助你在多端开发中写出可复用、体积更优、行为正确的 API 调用代码。Uni API开箱即用的多端统一 API为扩展 ice.js 体系的能力边界ice.js 为开发者提供了一系列Universal API下称 Uni API开发者可以直接调用这些 API 快速开发多端应用。Uni API 的核心价值体现在三个方面覆盖多端环境支持 Web、微信小程序、阿里小程序支付宝、淘宝、钉钉等、字节小程序等多种环境开箱即用、快速接入API 签名统一无需开发者针对每个平台手写分支判断即可完成常见能力如扫码、网络请求、存储、文件等的调用按环境拆包支持按目标环境进行拆包tree-shaking产物只保留当前目标平台实际用到的 API 实现从而获得更极致的代码体积。使用方式可参见 Uni API 官方文档按具体 API 的import路径接入即可其能力边界与 ice.js 的小程序多端目标一一对应是推荐优先使用的 API 层。原生小程序 APIUni API 未覆盖场景的兜底Uni API 虽然覆盖面广但不可能覆盖每一个平台的全部能力。对于Uni API 没有覆盖到的场景你可以直接在 ice.js 小程序中使用小程序原生 API即微信小程序的wxAPI、阿里小程序的myAPI 等。此时如果仍有跨端诉求同一段业务逻辑可能运行在多个小程序平台你可以结合uni/env提供的能力标记进行环境分支处理。官方文档给出了一个非常典型的扫码示例import { isMiniApp, isWeChatMiniProgram } from uni/env; function scan() { if (isWeChatMiniProgram) { wx.scanCode(); } else if (isMiniApp) { my.scan(); } }这段代码的语义非常清晰isWeChatMiniProgram为true时说明当前运行在微信小程序环境调用微信的wx.scanCode()isMiniApp为true时说明当前运行在阿里小程序环境调用阿里的my.scan()。通过这种方式业务代码无需感知构建目标即可在多个小程序平台间平滑迁移仅对平台差异点做最小化的分支处理。深入uni/env构建期静态判断的实现原理uni/env之所以能在运行时给出准确的平台判断、同时又不会引入多余的体积开销关键在于它在 ice.js 中是构建期生成的产物而非一个普通的三方 npm 包。别名映射到构建期生成文件在 ice.js 的默认任务配置 packages/ice/src/plugins/task.ts 中可以看到alias: { // ... universal-env: envReplacement, uni/env: envReplacement, },其中envReplacement指向RUNTIME_TMP_DIR/env.ts即运行时临时目录下由模板生成的env.ts文件const envReplacement path.join(rootDir, RUNTIME_TMP_DIR, env.ts);也就是说项目中import { isWeb } from uni/env或import ... from universal-env时实际解析到的是这个由 ice.js 在构建阶段生成的环境标记模块而不是任何远程运行时库。模板生成的环境标记全集生成该文件的模板位于 packages/ice/templates/core/env.ts.ejs其核心逻辑是根据构建期的import.meta.target与import.meta.renderer静态计算出各平台标记const isServer import.meta.renderer server; const isClient import.meta.renderer client; export const isNode isServer; export const isWeb isClient import.meta.target web; export const isWeex isClient import.meta.target weex; export const isAliMiniApp isClient import.meta.target ali-miniapp; export const isByteDanceMicroApp isClient import.meta.target bytedance-microapp; export const isBaiduSmartProgram isClient import.meta.target baidu-smartprogram; export const isKuaiShouMiniProgram isClient import.meta.target kuaishou-miniprogram; export const isWeChatMiniProgram isClient import.meta.target wechat-miniprogram; export const isQuickApp false; // ice.js 暂不实现 quick app 目标 export const isMiniApp isAliMiniApp; // universal-env 中 isMiniApp 等价于 isAliMiniApp模板中还包含运行时环境的判断isPHA、isThemis、isWindVane、isFRM等并通过export default { ... }兼容默认导出写法。值得注意的关键点所有标记在构建期即可确定import.meta.target在编译时被替换为具体目标平台的字符串因此isWeChatMiniProgram等常量在产物中会被直接替换为字面量true/false配合 tree-shaking 实现按环境拆包既然分支条件是编译期常量那么未被命中的分支如构建微信时my.scan()那一段会在压缩阶段被 DCE死代码消除移除这正是 Uni API “按环境拆包、极致体积”的底层机制isMiniApp语义与 universal-env 保持一致isMiniApp等价于isAliMiniApp仅表示阿里系小程序环境。真实项目中的使用示范在 ice.js 的官方示例项目 examples/basic-project/src/pages/about.tsx 中可以看到同样的用法import { isWeb } from uni/env; // ... divisWeb: {isWeb ? true : false}/div该示例面向 Web 目标构建时isWeb会被静态替换为true如果同一份代码用于小程序目标则会相应变为false无需修改任何业务代码。平台目标与构建命令uni/env中出现的wechat-miniprogram、ali-miniapp、bytedance-microapp、baidu-smartprogram、kuaishou-miniprogram等字符串并非随意命名它们与 ice.js 支持的构建目标一一对应。在 packages/plugin-miniapp/src/constant.ts 中定义了完整的目标常量export const WEB web; export const ALI_MINIAPP ali-miniapp; export const WECHAT_MINIPROGRAM wechat-miniprogram; export const BYTEDANCE_MICROAPP bytedance-microapp; export const BAIDU_SMARTPROGRAM baidu-smartprogram; export const KUAISHOU_MINIPROGRAM kuaishou-miniprogram; export const MINIAPP_TARGETS [ ALI_MINIAPP, WECHAT_MINIPROGRAM, BYTEDANCE_MICROAPP, BAIDU_SMARTPROGRAM, KUAISHOU_MINIPROGRAM, ];而 packages/plugin-miniapp/src/targets/index.ts 负责将目标字符串映射到对应的平台实现微信、阿里、字节、百度各有独立的components.ts、runtime.ts、template.ts等未匹配时默认回退到微信export default function getMiniappTargetConfig(target: string): TargetConfig { switch (target) { case WECHAT_MINIPROGRAM: return wechat; case ALI_MINIAPP: return ali; case BYTEDANCE_MICROAPP: return bytedance; case BAIDU_SMARTPROGRAM: return baidu; default: return wechat; } }对应到实际开发中通过--target参数即可切换构建平台详见小程序快速开始# 微信小程序 npm run start:wechat # ice start --target wechat-miniprogram npm run build:wechat # ice build --target wechat-miniprogram # 阿里系小程序支付宝、淘宝、钉钉等 npm run start:ali # ice start --target ali-miniapp npm run build:ali # ice build --target ali-miniapp平台支持情况整理如下小程序平台platform 参数状态阿里系支付宝、淘宝、钉钉等ali-miniapp支持微信wechat-miniprogram支持字节bytedance-microapp计划支持百度baidu-smartprogram计划支持快手kuaishou-miniprogram计划支持从源码结构看字节与百度的 target 实现已存在于 packages/plugin-miniapp/src/targets/ 目录bytedance/、baidu/均有完整的components.ts、runtime.ts、template.ts快手则仍留有 TODO 标记。使用建议与注意事项综合以上内容在实际的 ice.js 小程序开发中推荐遵循以下 API 选用策略优先使用 Uni API凡 Uni API 已覆盖的能力扫码、请求、存储等一律通过 Uni API 调用享受统一签名 按环境拆包的红利避免手写平台分支Uni API 未覆盖时使用原生 API uni/env分支如文档中的扫码示例所示用isWeChatMiniProgram、isMiniApp等标记做最小化分支兼顾跨端复用与平台特有能力不要混用环境判断与运行时探测uni/env的标记是构建期常量优先于typeof wx undefined之类的运行时探测前者可被 tree-shaking 消除、更利于产物优化注意平台差异即使同一业务语义不同平台的原生 API 命名也可能不同如扫码在微信是wx.scanCode()、在阿里是my.scan()分支处理时务必对照各平台官方 API 文档如阿里小程序前端 API、微信小程序端 API确认签名与返回值。此外需要留意小程序端的数据请求需统一使用各平台提供的 request 相关 APIice.js 的数据模拟 Mock 能力对小程序不适用SSR、SSG、定制 HTML 等依赖 Web 环境的能力在小程序端同样受限详见小程序快速开始中的“不支持能力”清单。相关文档围绕小程序 API 使用还可以继续阅读仓库中的以下文档小程序-API本文的官方出处包含 Uni API 与原生 API 的完整说明小程序-快速开始创建小程序应用、调试与构建、平台参数一览小程序-路由miniappManifest.routes配置与页面注册小程序-原生生命周期事件原生小程序生命周期在 ice.js 中的接入方式小程序-原生工程配置project.config.json等原生配置的写法。如果希望进一步从源码层面理解多端 API 体系可以查看 packages/plugin-miniapp/src/targets/各平台组件与运行时适配、packages/ice/templates/core/env.ts.ejsuni/env生成逻辑以及 packages/ice/src/plugins/task.ts别名映射与构建配置。赞分享前端Web框架SSR前端构建插件系统微前端跨平台【免费下载链接】ice ice.js: The Progressive App Framework Based On React基于 React 的渐进式应用框架项目地址https://gitcode.com/gh_mirrors/ice1/ice点击查看免费下载相关推荐ice.js 小程序开发中使用 HTML 标签的实践指南ice.js 小程序开发中使用 HTML 标签的实践指南 前言 在小程序开发中使用 HTML 标签是 ice.js 提供的一项重要特性它允许开发者使用熟悉的前端Web框架SSR前端构建插件系统微前端跨平台使用 ice.js 开发小程序的完整指南使用 ice.js 开发小程序的完整指南 前言 ice.js 作为一款优秀的前端框架不仅支持 Web 应用开发还提供了完善的小程序开发能力。本文将全面介绍如前端Web框架SSR前端构建插件系统微前端跨平台终极指南Taro小程序原生能力调用——API封装与适配策略全解析终极指南Taro小程序原生能力调用——API封装与适配策略全解析 Taro作为开放式跨端跨框架解决方案支持使用React/Vue/Nerv等框架开发多端应用前端小程序跨平台移动开发上一篇Emscripten与WebAssembly组件微前端路由实现下一篇CocoaLumberjack与XCTest集成测试用例日志捕获技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考