支付寶小程序框架 兼容

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

可調(diào)用接口 my.canIUse(String) 判斷當(dāng)前小程序的 API、入?yún)⒒蚍祷刂怠⒔M件、屬性等在當(dāng)前版本、當(dāng)前系統(tǒng)是否支持。

新增 API 兼容性處理

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

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

API 新增參數(shù)兼容性處理

if (my.canIUse('getLocation.object.type')) {
    // ...
} else {
    console.log('當(dāng)前版本不支持該參數(shù)')
}

API 新增返回值兼容性處理

if (my.canIUse('getSystemInfo.return.storage')) {
    // ...
} else {
    console.log('當(dāng)前版本不支持該返回值')
}

組件新增屬性兼容性處理

組件新增屬性在舊版本支付寶客戶端上無法實(shí)現(xiàn)，也不會(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>

設(shè)置最低基礎(chǔ)庫版本

為解決低版本基礎(chǔ)庫無法兼容小程序新功能的問題，開發(fā)者可設(shè)置小程序最低基礎(chǔ)庫版本要求。

從 開發(fā)中心 > 小程序應(yīng)用 > 我的小程序，進(jìn)入小程序詳情頁，點(diǎn)擊左側(cè)欄 設(shè)置，在 基礎(chǔ)設(shè)置 欄，可設(shè)置小程序的最低基礎(chǔ)庫版本。若小程序用戶使用的基礎(chǔ)庫版本低于設(shè)置的最低版本要求，則無法正常使用小程序，并將提示用戶更新支付寶版本；設(shè)置版本號(hào)后，小程序需重新發(fā)版才會(huì)生效。

點(diǎn)擊 最低基礎(chǔ)庫版本， 對(duì)應(yīng)的 設(shè)置 按鈕，可看到不同的最低基礎(chǔ)庫版本對(duì)應(yīng)的受影響用戶 UV 占比，即近 30 天內(nèi)訪問小程序的用戶的基礎(chǔ)庫版本小于所選版本的占比。開發(fā)者可據(jù)此設(shè)置小程序的最低基礎(chǔ)庫版本。

選中需設(shè)置為最低基礎(chǔ)庫版本的版本號(hào)，點(diǎn)擊 確定 按鈕，即設(shè)置成功。

此時(shí)，最低基礎(chǔ)庫版本 設(shè)置項(xiàng)對(duì)應(yīng)的 狀態(tài) 變?yōu)?已設(shè)置。

常見問題

Q：小程序 API 如果不兼容該怎么處理？

A：可以使用 my.canIUse(String) 做兼容判斷，如果需要可以使用 my.ap.updateAlipayClient 對(duì)支付寶端進(jìn)行提示升級(jí)。