返回知识库

微信小程序 · 平台实践

小程序基础库兼容Mini Program Base Library Compatibility

运行时先检查需要的能力;缺少新接口时,给用户一条能完成同一任务的路。

给漏水报修单补一张现场照片

这台模拟手机运行旧基础库。试着打开拍摄器,再把维修单送到物业。

模拟手机 · 旧基础库wx.chooseMedia:不支持
物业报修 #217

厨房水管漏水

现场照片 · 0 张附图后才能提交

基础库决定这台微信能调用什么

小程序代码一样,宿主提供的 API 却可能不同。模拟器里的相册入口假定旧接口仍可用;真实项目也要检查替代能力。

什么时候用,怎么验收

新加拍摄或选图能力、又要覆盖旧客户端时,先列出必须完成的任务。用户拒绝相机权限和缺少接口是两种原因,应分别处理。

  1. 在调用前用 wx.canIUse 或相应能力检测判断目标 API 是否存在;别拿手机型号代替判断。
  2. 分别在最低支持环境与新环境走完附图、提交;若没有可行替代,应保留草稿并明确提示升级。

正反例:报修单附图的能力

正例:旧环境进入相册,附上同一处漏水的照片,报修单送达。

反例:只显示不能用的拍摄键,物业收不到报修单;应换入口或解释下一步。

快速自测

一位用户的基础库支持拍摄,但他拒绝了相机权限。能否直接判定版本太旧?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学