uni-app小程序SDK

简介

官网：https://nativesupport.dcloud.net.cn/

uni小程序SDK，是为原生App打造的可运行基于uni-app开发的小程序前端项目的框架，从而帮助原生App快速获取小程序的能力，效果如下：

基本概念

uni-app

uni-app 是一个使用 Vue.js 开发所有前端应用的框架，开发者编写一套代码，可发布到 H5、以及各种小程序（微信/支付宝/百度/头条/QQ/钉钉/淘宝）、快应用等多个平台，并且在 HBuilderX 中可直接打包生成 Android、iOS App。

uni小程序SDK

uni小程序SDK是原生SDK，提供 Android 版本 和 iOS 版本，需要在原生工程中集成，然后即可运行用uni-app框架开发的小程序前端项目，一套代码两端运行

名词解释

• 宿主：想要构建小程序的原生App，集成uni小程序SDK的宿主
• 小程序：运行在宿主中的前端代码编写的小程序项目，使用uni-app框架开发
• wgt：小程序应用资源包，即使用uni-app框架开发的项目，导出的小程序应用资源包
• HBuilderX：开发uni-app的 IDE 工具

注意

• uni小程序SDK 仅支持使用uni-app开发的小程序，不支持纯wxml微信小程序运行。但uni-app支持使用wxml格式的小程序组件
• uni小程序SDK 仅支持uni-app的v3编译器。使用老版的开发者，需首先保障应用可以运行在 v3 编译模式下

特色

uni-app在 app 端是双渲染引擎，可以像微信那样使用webview渲染，也可以使用改造版的weex进行原生渲染。其中webview渲染在 Android 上也同时支持系统webview渲染和x5渲染。

• 性能 uni小程序sdk的性能，与uni-app的app端v3编译器相同，性能超过市面其他小程序引擎。在启动速度、页面加载速度、逻辑层与视图层通信优化等方面均优有更优秀的表现
• 功能 uni小程序sdk的功能，与uni-app的app端功能相同，所有原生能力均可调用。不同于小程序的限制和有限API，uni小程序sdk的功能更加强大
• 插件生态 uni-app插件市场有大量丰富的插件

应用场景

• 宿主App构建自己的应用生态，可以面向广泛开发者，也可以定向部分开发者
• 原生App利用小程序模式对模块解耦，让不同模块的开发团队各自独立发版，灵活更新
• 原生App中部分功能使用uni-app实现，降低开发成本、提升发布效率

集成流程

• 宿主开发者下载uni小程序sdk，根据文档集成到宿主App中
• 小程序开发者使用HBuilderX创建uni-app项目并开发功能，开发阶段可以直接在HBuilderX内置基座进行测试，开发完毕后在发行菜单导出wgt包
• 宿主开发者将wgt集成到宿主App中，可离线集成直接打包进去，也可以在线下载wgt
• 通过 uni小程序sdk 的api将wgt资源部署到运行路径，然后即可跳转到该资源对应的小程序应用中
• uni小程序支持wgt升级，可以在小程序中直接调用api在线更新wgt资源，即热更新 参考文档

注意

• 目前 uni小程序sdk 仅支持在原生App中集成使用，暂不支持HBuilderX打包生成的App中集成
• 目前 uni小程序sdk 仅支持同时运行一个小程序实例，启动下一个小程序需关闭上一个小程序
• uni小程序sdk 无法使用插件市场中付费的原生插件

FAQ

Q：uni小程序sdk 与 App离线sdk 的差别是什么？
A：解决两种不同的需求场景，前者的使用场景是你已经有原生App，在此基础上扩展宿主App的小程序能力，或者用小程序替换原生App的部分功能模块，仅支持uni-app并使用v3编译器；后者的使用场景是你没有原生App，用DCloud的工具来开发App，又不想使用云打包，则可以使用App离线sdk打包发布为原生App，App离线sdk支持5+ App、uni-app，不支持wap2app。虽然App离线sdk也可以集成到已有原生App中，但自从uni小程序sdk推出后，将不再推荐这种用法。

Q：想了解 uni小程序sdk 都有哪些js api，和微信小程序相比如何？
A：uni小程序sdk的js api比微信小程序更多，不同于微信小程序的“小”的限制，uni小程序sdk的功能更接近于正常的app，没有包体积限制，并且提供了更丰富的api，以支持完整app的开发。文档和演示demo见：https://uniapp.dcloud.io/

Q: uni小程序不需要集成分享、支付等第三方的功能。集成到我的Android项目中APK的体积会增加多少？
A: 如果排除视频、地图、分享、支付、登录、直播pusher等sdk，只集成基础模块。占用APK体积大小如下：