App 安裝與管理用 API

翻譯不完整。請協助 翻譯此英文文件

Open Web App 的 JavaScript API 屬於程式設計介面,有利於 Web App 作業,並針對使用者已經安裝的 Web App,可管理用戶端的 Web App 集合 (Collection)。此集合即所謂的 application repository

現有功能

本文所提及的 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 物件上的函式。

Management API (navigator.mozApps.mgmt.*)

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

物件

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

新舊 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.oninstallnavigator.mozApps.onuninstall 所取代。
navigator.mozApps.mgmt.uninstall(origin, [onsuccess], [onerror])
navigator.mozApps.mgmt.uninstall(app) 所取代。而這裡的 app 物件,是由 getAll(),或其他處理 app 的物件回傳而得。

文件標籤與貢獻者

 此頁面的貢獻者: MashKao
 最近更新: MashKao,