20201223 - 小程序文档

[onvno]

小程序分包

在构建小程序分包项目时，构建会输出一个或多个分包。每个使用分包小程序必定含有一个主包。所谓的主包，即放置默认启动页面/TabBar 页面，以及一些所有分包都需用到公共资源/JS 脚本；而分包则是根据开发者的配置进行划分。

在小程序启动时，默认会下载主包并启动主包内页面，当用户进入分包内某个页面时，客户端会把对应分包下载下来，下载完成后再进行展示。

目前小程序分包大小有以下限制：

整个小程序所有分包大小不超过 20M 单个分包/主包大小不能超过 2M

https://developers.weixin.qq.com/miniprogram/dev/framework/subpackages.html

[onvno]

小程序模块化

https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/module.html 小程序目前不支持直接引入 node_modules , 开发者需要使用到 node_modules 时候建议拷贝出相关的代码到小程序的目录中，或者使用小程序支持的 npm 功能。

小程序对npm的支持大致看了下: 1.需要定制：package.json中包含miniprogram，用于指定小程序依赖的路径 2.对未按照规范的npm包，需要微调适应需求

• 只支持纯 js 包，不支持自定义组件。
• 必须有入口文件，即需要保证 package.json 中的 main 字段是指向一个正确的入口，如果 package.json 中没有 main 字段，则以 npm 包根目录下的 index.js 作为入口文件。
• 测试、构建相关的依赖请放入 devDependencies 字段中避免被一起打包到小程序包中，这一点和小程序 npm 包的要求相同。
• 不支持依赖 c++ addon，不支持依赖 nodejs 的内置库： 具体可查看：https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html

[onvno]

小程序提供的API能力

小程序订阅消息，h5红包，群信息是什么意思？

• worker多线程
• 激励广告

[onvno]

微信事件系统

待补充，挺有意思，WXS也支持，看效果在ios性能有提升2-20倍 https://developers.weixin.qq.com/miniprogram/dev/framework/view/wxml/event.html

[onvno]

了解是否可行，如何实现

APP拉起小程序

https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/iOS_Development_example.html 微信提供SDK支持端可拉起小程序

小程序回跳APP

https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html

使用方法

小程序端

需要将 button 组件 open-type 的值设置为 launchApp。如果需要在打开 APP 时向 APP 传递参数，可以设置 app-parameter 为要传递的参数。通过 binderror 可以监听打开 APP 的错误事件。

app 端

APP 需要接入 OpenSDK。 文档请参考 iOS / Android

Android 第三方 app 需要处理 ShowMessageFromWX.req 的微信回调，iOS 则需要将 appId 添加到第三方 app 工程所属的 plist 文件 URL types 字段。 app-parameter 的获取方法，参数解析请参考 Android SDKSample 中 WXEntryActivity 中的 onResp 方法以及 iOS SDKSample 中 WXApiDelegate 中的 onResp 方法。

[onvno]

小程序官方demo

https://github.com/wechat-miniprogram/miniprogram-demo

[onvno]

小程序的运行环境

微信小程序运行在多种平台上：iOS（iPhone/iPad）微信客户端、Android 微信客户端、PC 微信客户端、Mac 微信客户端和用于调试的微信开发者工具。

各平台脚本执行环境以及用于渲染非原生组件的环境是各不相同的：

在 iOS 上，小程序逻辑层的 javascript 代码运行在 JavaScriptCore 中，视图层是由 WKWebView 来渲染的，环境有 iOS 12、iOS 13 等；

• 在 Android 上，小程序逻辑层的 javascript 代码运行在 V8 中，视图层是由自研 XWeb 引擎基于 Mobile Chrome 内核来渲染的；
• 在 开发工具上，小程序逻辑层的 javascript 代码是运行在 NW.js 中，视图层是由 Chromium Webview 来渲染的。
• 在 PC 上，小程序逻辑层 javascript 和视图层 javascript 都是用 Chrome 内核
• 在 Mac 上，小程序逻辑层的 javascript 代码运行在 JavaScriptCore 中，视图层是由 WKWebView 来渲染的，与 iOS 一致

平台差异

尽管各运行环境是十分相似的，但是还是有些许区别：

• JavaScript 语法和 API 支持不一致：语法上开发者可以通过开启 ES6 转 ES5 的功能来规避（详情）；此外，小程序基础库内置了必要的Polyfill，来弥补API的差异（详情)。
• WXSS 渲染表现不一致：尽管可以通过开启样式补全来规避大部分的问题，还是建议开发者需要在 iOS 和 Android 上分别检查小程序的真实表现。

https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/env.html

[onvno]

自定义组件 -behaviors

待补充，功能类似mixin等 https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/behaviors.html

[onvno]

web-view

小程序提供web-view,支持内嵌h5，部分支持JSSDK功能。 文档：https://developers.weixin.qq.com/miniprogram/dev/component/web-view.html

[onvno]

小程序跳转

https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html

• switchTab - 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面
• reLaunch - 关闭所有页面，打开到应用内的某个页面
• redirectTo - 关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面
• navigateTo - 保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 wx.navigateBack 可以返回到原页面。小程序中页面栈最多十层。
• navigateBack - 关闭当前页面，返回上一页面或多级页面。可通过 getCurrentPages 获取当前的页面栈，决定需要返回几层。
• EventChannel - 页面间事件通信通道

保留当前页面是指可以回退？

[onvno]

端外拉起小程序

官方文档提供链接：https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html

调用接口，获取URL scheme，生成地址如下：weixin://dl/business/?ticket= TICKET