前端開發指南

JSSDK 爲(for)應用(use)提供了(Got it)調用(use)原生(born)的(of)能力，幫助開發者高效使用(use)定位等手機系統的(of)能力，帶給 H5 應用(use)接近原生(born)代碼的(of)體驗。此文檔面向開發者介紹 JSSDK 如何使用(use)及相關注意事項。

 

在(exist) 2021年3月的(of)更新 中，我(I)們(them)優化了(Got it) JSSDK 的(of)引用(use)。在(exist)之前，需要(want)開發者手動在(exist)項目中引用(use)：

 

<!-- 在(exist)html文檔中 -->

 

<script type="text/javascript" src="supconit://hcmobile.js"></script>

 

優化後，開發者無需再手動引用(use)。

 

API 使用(use)

注意

 

JSAPI 的(of)調用(use)需要(want)保證在(exist) doucment 對象 deviceready 事件觸發後調用(use)，否則無效。

 

通常情況下，一(one)個(indivual)HTML頁面隻需要(want)監聽一(one)次該事件即可，也即意味着：如果您的(of)網站采用(use)的(of)是(yes)單頁面(SPA)技術開發的(of)，隻需要(want)監聽該事件一(one)次即可；如果您的(of)網站采用(use)的(of)是(yes)多頁面(MPA)技術開發的(of)，您需要(want)在(exist)需要(want)使用(use)插件功能的(of)頁面，都得先監聽 deviceready 事件的(of)觸發再調用(use)插件的(of)功能。

 

<script>

 

// 監聽’deviceready‘事件

 

document.addEventListener('deviceready', onDeviceReady, false)

 

function onDeviceReady(){

 

console.log('插件功能可以(by)開始調用(use)');

 

}

 

</script>

 

接口約定

所有 JSAPI 接口必須在(exist) doucment 對象 deviceready 事件觸發後調用(use)；

中控易動-vscode插件

中控易動(插件)是(yes)在(exist)vscode工具上(superior)開發的(of)插件。中控易動插件通過 WiFi 在(exist)真實的(of)手機中對編寫的(of)代碼進行調試和(and)功能驗證。詳情查看

 

打開VSCode，搜索"中控易動"，安裝，此插件集成了(Got it)代碼提示和(and)快速在(exist)app端運行h5頁面以(by)及js腳本的(of)功能