背景
项目起始时间:2017-11-25 前端人数: 3 页面数: 6 一期上线时间:2018-01-16 在我们开发的过程中,小程序的生态也不断变化。例如 最开始不支持其打开的 web 页面调起小程序页面,后来则新增了 JS-SDK 并在高版本的基础库里支持了这样的功能;再例如它的 IDE 不断优化升级,开发体验变好;页面的5级跳转限制,改为了10级;小程序体积限制由 1MB 扩大为了 2MB …… 总体来说,一直在朝着好的方向发展。
web-view 的使用
应当指定一个特定的路径,用于打开任意的在业务域名白名单内的页面。
页面目录
由于 所在页面只会渲染 web 页面,其他任何组件都不显示,所以,在相应的 HTML 里就只包含这样的一个组件即可:
代码语言:javascript复制<web-view src="{{url}}"></web-view>
web-view/index.js 的主要逻辑如下:
代码语言:javascript复制Page({ data: { url: '', }, onLoad() { const sysInfo = wx.getSystemInfoSync(); const version = new Version(sysInfo.SDKVersion); // web-view 组件是 1.6.4 基础库开始支持的 // 但是其 JS-SDK 却是从 1.6.6 才开始支持 // 所以这里要求最低为 1.6.6 if (version.isLowerThan('1.6.6')) { return wx.showModal({ title: '提示', content: '当前微信版本过低,无法在小程序内打开网页,请升级到最新微信版本后重试。', showCancel: false, confirmText: '知道了', success() { wx.navigateBack(); } }); } // 可以拿到 URL 里的查询参数 if (options && options.__host) { let url = decodeURIComponent(options.__host || ''); const query = Object.assign({}, options); delete query.__host; url = '?' util.stringifyQuery(query); this.setData({url}); }})
其他页面在想使用 web-view 时就可以这样,方式1:
代码语言:javascript复制<navigator url="/pages/webview/index?__host=https://your.host.name/path/to/page&query_1=value_1&query_2=value_2"> 通过web-view打开网页</navigator>
或者方式2:
代码语言:javascript复制const url = 'https://your.host.name/path/to/page?query_1=value_1&query_2=value_2';wx.navigateTo({ url: '/pages/webview/index__host=' encodeURIComponent(url)});
数据缓存
可以比较充分地使用小程序的 storage 接口,进行本地缓存。建议缓存的数据包括:
代码语言:javascript复制元数据用户登录后的基础数据,例如 userId,token设备ID
图片资源
由于小程序的样式表里无法使用相对路径引用图片文件,所以很多时候只好使用 base64 进行转码。
常用的类
代码语言:javascript复制用于网络请求的 request.js,支持 Promise 接口版本判断,Version.js时间日期格式化,类似于 moment.js,但是要更为轻量级URL 解析与序列化,url.js
兼容性
iOS 与 Android 平台下,即便相同的小程序,也有许多细节上的差异。在进行兼容性测试时需要按照 H5 的平台兼容性进行测试。
此外,还有微信各版本的兼容性测试。前端要基于 Version.js 判断微信小程序 SDKVersion,以便对低版本进行友好的提示。