兼容

小程序的功能不断的增加，但是旧版本的微信客户端并不支持新功能，所以在使用这些新能力的时候需要做兼容。

文档会在组件，API等页面描述中带上各个功能所支持的版本号。

可以通过 wx.getSystemInfo 或者 wx.getSystemInfoSync 获取到小程序的基础库版本号。

也可以通过 wx.canIUse 详情 来判断是否可以在该基础库版本下直接使用对应的API或者组件

兼容方式 - 版本比较

微信客户端和小程序基础库的版本号风格为 Major.Minor.Patch（主版本号.次版本号.修订号）。开发者可以根据版本号去做兼容，以下为参考代码：

  1. function compareVersion(v1, v2) {
  2.   v1 = v1.split('.')
  3.   v2 = v2.split('.')
  4.   var len = Math.max(v1.length, v2.length)
  6.   while (v1.length < len) {
  7.     v1.push('0')
  8.   }
  9.   while (v2.length < len) {
  10.     v2.push('0')
  11.   }
  13.   for (var i = 0; i < len; i++) {
  14.     var num1 = parseInt(v1[i])
  15.     var num2 = parseInt(v2[i])
  17.     if (num1 > num2) {
  18.       return 1
  19.     } else if (num1 < num2) {
  20.       return -1
  21.     }
  22.   }
  24.   return 0
  25. }
  27. compareVersion('1.11.0', '1.9.9')
  28. // 1

兼容方式 - 接口

对于新增的 API，可以用以下代码来判断是否支持用户的手机。

  1. if (wx.openBluetoothAdapter) {
  2.   wx.openBluetoothAdapter()
  3. } else {
  4.   // 如果希望用户在最新版本的客户端上体验您的小程序，可以这样子提示
  5.   wx.showModal({
  6.     title: '提示',
  7.     content: '当前微信版本过低，无法使用该功能，请升级到最新微信版本后重试。'
  8.   })
  9. }

兼容方式 - 参数

对于 API 的参数或者返回值有新增的参数，可以判断用以下代码判断。

  1. wx.showModal({
  2.   success: function(res) {
  3.     if (wx.canIUse('showModal.cancel')) {
  4.       console.log(res.cancel)
  5.     }
  6.   }
  7. })

兼容方式 - 组件

对于组件，新增的组件或属性在旧版本上不会被处理，不过也不会报错。如果特殊场景需要对旧版本做一些降级处理，可以这样子做。

  1. Page({
  2.   data: {
  3.     canIUse: wx.canIUse('cover-view')
  4.   }
  5. })
  1. <video controls="{{!canIUse}}">
  2.   <cover-view wx:if="{{canIUse}}">play</cover-view>
  3. </video>

原文:

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