微信小程序 · 平台实践
小程序基础库兼容Mini Program Base Library Compatibility
运行时先检查需要的能力;缺少新接口时,给用户一条能完成同一任务的路。
给漏水报修单补一张现场照片
这台模拟手机运行旧基础库。试着打开拍摄器,再把维修单送到物业。
模拟手机 · 旧基础库wx.chooseMedia:不支持
基础库决定这台微信能调用什么
小程序代码一样,宿主提供的 API 却可能不同。模拟器里的相册入口假定旧接口仍可用;真实项目也要检查替代能力。
什么时候用,怎么验收
新加拍摄或选图能力、又要覆盖旧客户端时,先列出必须完成的任务。用户拒绝相机权限和缺少接口是两种原因,应分别处理。
- 在调用前用 wx.canIUse 或相应能力检测判断目标 API 是否存在;别拿手机型号代替判断。
- 分别在最低支持环境与新环境走完附图、提交;若没有可行替代,应保留草稿并明确提示升级。
正反例:报修单附图的能力
正例:旧环境进入相册,附上同一处漏水的照片,报修单送达。
反例:只显示不能用的拍摄键,物业收不到报修单;应换入口或解释下一步。
快速自测
一位用户的基础库支持拍摄,但他拒绝了相机权限。能否直接判定版本太旧?
继续查证
术语的技术定义和行为以这些一手或权威资料为准。