App 安裝與管理用 API

現有功能

本文所提及的 JavaScript API，均可於 Firefox、Firefox for Android、Firefox OS 中使用。

API 的函式

與 App 相關的所有函式，均透過 navigator.mozApps 物件進行存取。共可分為 2 類型的函式：

• 安裝函式：用於 App 安裝作業，或是已安裝 App 的管理作業。此類函式適用於 App 商城、自行發佈 App、App 路徑/資料夾。
• 管理函式：與 App 的顯示、發佈、同步化作業相關。主要用於「dashboards」。

Installation API (navigator.mozApps.*)

App 的安裝用 API，均為 window.navigator.mozApps 物件上的函式。

• navigator.mozApps.install()
• navigator.mozApps.installPackage()
• navigator.mozApps.getSelf()
• navigator.mozApps.getInstalled()
• navigator.mozApps.checkInstalled()

Management API (navigator.mozApps.mgmt.*)

App 的管理用 API 需經授權 (Privileged)，可存取受信任的頁面，即所謂的「dashboards」。Management API 所揭露的函式，可讓 dashboards 根據使用的行為來管理並啟動 App。此外，API 亦具備 App 同步函式，可讓 dashboard 顯示使用者的登入狀態，並讓使用者登入或註冊帳戶，以跨裝置同步 App。

• navigator.mozApps.mgmt.getAll()

物件

App 的 API 共使用下列 JavaScript 物件：

• App objects 代表 App 本身。
• DOMRequest 物件將透過多項函式回傳。
• DOMError objects 代表由函式回傳的錯誤。

新舊 API

較早期的 API 已從 2012 年 3 月起作廢，另已由下列新 API 取代。

navigator.mozApps.install()

此函式已更改過簽章。

navigator.mozApps.amInstalled()

由 navigator.mozApps.getSelf() 所取代。

navigator.mozApps.getInstalledBy()

由 navigator.mozApps.getInstalled() 所取代。

navigator.mozApps.mgmt.list()

由 navigator.mozApps.mgmt.getAll() 所取代。

navigator.mozApps.mgmt.watchUpdates(onupdate)
navigator.mozApps.mgmt.clearWatch(watchId)

兩者由 navigator.mozApps.oninstall 與 navigator.mozApps.onuninstall 所取代。

navigator.mozApps.mgmt.uninstall(origin, [onsuccess], [onerror])

由 navigator.mozApps.mgmt.uninstall(app) 所取代。而這裡的 app 物件，是由 getAll()，或其他處理 app 的物件回傳而得。