支付宝小程序框架兼容

小程序组件和 API 能力正在逐步完善和丰富，但是老版本支付宝客户端并不支持这些新增能力，因此建议开发者做对应的兼容性处理。

可调用接口 my.canIUse(String) 判断当前小程序的 API、入参或返回值、组件、属性等在当前版本、当前系统是否支持。

新增 API 兼容性处理

对于新增 API，可以参照下面的代码来判断当前基础库是否支持该 API：

if (my.getLocation) {
    my.getLocation();
} else {
    // 如果希望用户在最新版本的客户端上体验您的小程序，可以这样提示
    my.alert({
       title: '提示',
       content: '当前支付宝版本过低，无法使用此功能，请升级最新版本支付宝'
    });
}

API 新增参数兼容性处理

if (my.canIUse('getLocation.object.type')) {
    // ...
} else {
    console.log('当前版本不支持该参数')
}

API 新增返回值兼容性处理

if (my.canIUse('getSystemInfo.return.storage')) {
    // ...
} else {
    console.log('当前版本不支持该返回值')
}

组件新增属性兼容性处理

组件新增属性在旧版本支付宝客户端上无法实现，也不会报错。若要对属性做降级处理可参照以下代码：

Page({
  data: {
    canIUse: my.canIUse('button.open-type.share')
  }
})
<button a:if="{{canIUse}}" open-type="share">分享小程序</button>
<button a:else onTap="shareApp">分享小程序</button>