支付寶小程序框架 兼容·compatibility

現(xiàn)階段，小程序的組件和API能力正在逐步完善和豐富，但是老版本的支付寶客戶端并不支持這些新增的能力。對(duì)此，我們建議開發(fā)者在使用新增能力的同時(shí)做對(duì)應(yīng)的兼容性處理。

兼容性通過 canIUse 接口判斷：我們提供了 my.canIUse 詳情 接口里實(shí)現(xiàn)兼容性的判斷，以下是具體的兼容辦法：

兼容新增API

對(duì)于新增的 API，可以使用下面的代碼來判斷當(dāng)前基礎(chǔ)庫是否支持該API：

if (my.canIUse('getLocation')) {
    my.getLocation();
} else {
    // 如果希望用戶在最新版本的客戶端上體驗(yàn)?zāi)男〕绦颍梢赃@樣子提示
    my.alert({
            title: '提示',
            content: '當(dāng)前支付寶版本過低，無法使用此功能，請(qǐng)升級(jí)最新版本的支付寶'
        });
}

兼容API新增參數(shù)和返回值

對(duì)于API新增的參數(shù)和返回值

if (my.canIUse('getSystemInfo.return.storage')) {

    
} else {
    console.log('當(dāng)前版本不支持該參數(shù)')
}

兼容組件的新增屬性

對(duì)于組件，新增的屬性在舊版本上不會(huì)被處理，不過也不會(huì)報(bào)錯(cuò)。如果希望對(duì)屬性做降級(jí)處理可以使用如下代碼。

Page({
  data: {
    canIUse: my.canIUse('button.open-type.share')
  }
})

<button a:if="{{canIUse}}" open-type="share">分享小程序</button>
<button a:else onTap="shareApp">分享小程序</button>