兼容性說明

字節(jié)跳動小程序目前迭代比較快，各個 app 之間差異也比較大，開發(fā)者需要做好兼容工作，避免因為在低版本上使用了一個不兼容的 api 而出現(xiàn)體驗問題。一般可以通過版本號比較、api 存在判斷、tt.caniuse 三種方式進(jìn)行兼容處理。另外上線發(fā)布的時候也可以選擇支持小程序的最低基礎(chǔ)庫版本。

版本號比較

可以通過tt.getSystemInfo或者tt.getSystemInfoSync得到SDKVersion，SDKVersion是三位版本號，由[大版本].[小版本].[修訂版本]三部分組成，例如：1.11.1。一般會在 api 文檔上標(biāo)注支持該 api 的最低版本，或者在組件文檔上標(biāo)注支持某個屬性的最低版本。

api 存在判斷

一般新增的 api 在低版本基礎(chǔ)庫上是不存在的，貿(mào)然調(diào)用會導(dǎo)致錯誤。建議做如下判斷：

if (tt.navigateToMiniProgram) {
  tt.navigateToMiniProgram();
} else {
  tt.showModal({
    title: "提示",
    content:
      "當(dāng)前客戶端版本過低，無法使用該功能，請升級客戶端或關(guān)閉后重啟更新。"
  });
}

caniuse

如果 api 的返回參數(shù)有更新，可以通過caniuse來判斷：

tt.getImageInfo({
	src: '../images/test.jpg',
    success: (e) {
    	if (tt.caniuse('getImageInfo.path')) {
        	console.log(e.path)
        }
    }
})

基礎(chǔ)庫最低版本限制

可在開發(fā)者后臺，進(jìn)入設(shè)置頁--選擇 JSSDK 最低版本號