APIs d'installation et de gestion des Applications

  • Raccourci de la révision : Applications/API_JavaScript_Apps
  • Titre de la révision : APIs d'installation et de gestion des Applications
  • ID de la révision : 361735
  • Créé :
  • Créateur : tregagnon
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

L'API JavaScript Open Web Apps est une interface de programmation pour installer des applications Web et pour gérer sur le client, la collection d'applications Web que l'utilisateur Web a installé. Cette collection est appelée application repository (dépôt d'applications).

Fonctionnalités disponibles

L'API JavaScript décrite ici n'est pas encore dispnible dans la version finale de Firefox (Janvier 2013). Vous pouvez utiliser cette API maintenant en utilisant Firefox Beta pour Windows et Mac, et Firefox Aurora (pre-beta) pour Android.

Mozilla implémente aussi un prototype de "Tableau de gestion" à l'adresse myapps.mozillalabs.com. (pour tester et expérimenter)

Méthodes de l'API

Toutes les méthodes en relation aux applications sont accessibles depuis l'objet navigator.mozApps. Il y a deux types de fonctions disponible dans l'API :

  • Fonctions d'Installation : pour l'installation et la gestion des applications installées. Elles sont intéressantes pour stocker, distribuer des applications.
  • Fonctions de Gestion : pour l'affichage, le lancement et la synchronisation des applications. Principalement utilisés pour les tableaux de bord.

API d'installation (navigator.mozApps.*)

L'API d'installation des applications est accessible par des méthodes sur l'objet window.navigator.mozApps :

API de gestion (navigator.mozApps.mgmt.*)

L'API de gestion des applications a un accès restreint. Il est prévu d'y donner accès à des pages de confiance, appelées "tableaus de bord". L'API de gestion expose des fonctions qui permettent aux tableaux de bord de gérer et de lancer les applications pour l'utilisateur. De plus, l'API expose des fonctions pour la synchronisation des applications, ce qui permet aux tableaux de bord d'afficher l'état connecté de l'utilisateur, et de lui permettre de s'identifier ou de s'inscrire pour synchroniser les applications entre plusieurs appareils.

Objets

Les types d'objet JavaScript qui sont utilisées par les API d'applications :

Vieille API et nouvelle API

Si vous utilisiez l'ancienne API, elle est obsolète depuis mars 2012. L'ancienne API est comparée avec la nouvelle API ci-dessous.

navigator.mozApps.install()
Cette fonction a une signature différente.
navigator.mozApps.amInstalled() {{ obsolete_inline() }}
Remplacée par navigator.mozApps.getSelf().
navigator.mozApps.getInstalledBy() {{ obsolete_inline() }}
Remplacée par navigator.mozApps.getInstalled().
navigator.mozApps.mgmt.list() {{ obsolete_inline() }}
Remplacée par navigator.mozApps.mgmt.getAll().
navigator.mozApps.mgmt.watchUpdates(onupdate) {{ obsolete_inline() }}
navigator.mozApps.mgmt.clearWatch(watchId) {{ obsolete_inline() }}
Les deux ont été remplacées par navigator.mozApps.addEventListener(type, cb) et navigator.mozApps.removeEventListener(type, cb)type peut être soit install, soit uninstall.
navigator.mozApps.mgmt.uninstall(origin, [onsuccess], [onerror]) {{ obsolete_inline() }}
Remplacée par app.uninstall()app est un objet renvoyé par getAll() ou getInstalled().

Source de la révision

<p>L'API JavaScript Open Web Apps est une interface de programmation pour installer des applications Web et pour gérer sur le client, la collection d'applications Web que l'utilisateur Web a installé. Cette collection est appelée <em>application repository </em>(dépôt d'applications).</p>
<h2 id="Feature_availability" name="Feature_availability">Fonctionnalités disponibles</h2>
<p>L'API JavaScript décrite ici n'est pas encore dispnible dans la version finale de Firefox (Janvier 2013). Vous pouvez utiliser cette API maintenant en utilisant <a href="https://www.mozilla.org/en-US/firefox/beta/" title="https://www.mozilla.org/en-US/firefox/beta/">Firefox Beta</a> pour Windows et Mac, et <a href="https://www.mozilla.org/en-US/firefox/aurora/" title="https://www.mozilla.org/en-US/firefox/aurora/">Firefox Aurora</a> (pre-beta) pour Android.</p>
<p>Mozilla implémente aussi un prototype de "Tableau de gestion" à l'adresse <a class="link-https" href="https://myapps.mozillalabs.com/"><code>myapps.mozillalabs.com</code></a>. (pour tester et expérimenter)</p>
<h2 id="M.C3.A9thodes_de_l'API">Méthodes de l'API</h2>
<p>Toutes les méthodes en relation aux applications sont accessibles depuis l'objet <code>navigator.mozApps</code>. Il y a deux types de fonctions disponible dans l'API :</p>
<ul>
  <li><a href="#Installation_API" title="#Installation_API"><strong>Fonctions d'Installation</strong></a> : pour l'installation et la gestion des applications installées. Elles sont intéressantes pour stocker, distribuer des applications.</li>
  <li><a href="#Management_API" title="#Management_API"><strong>Fonctions de Gestion</strong></a> : pour l'affichage, le lancement et la synchronisation des applications. Principalement utilisés pour les tableaux de bord.</li>
</ul>
<h2 id="Installation_API" name="Installation_API">API d'installation (<code>navigator.mozApps.*</code>)</h2>
<p>L'API d'installation des applications est accessible par des méthodes sur l'objet <a href="/fr/docs/DOM/window.navigator.mozApps"><code>window.navigator.mozApps</code></a> :</p>
<ul>
  <li><a href="/fr/docs/DOM/Apps.install"><code>navigator.mozApps.install()</code></a></li>
  <li><a href="/fr/docs/DOM/Apps.installPackage"><code>navigator.mozApps.installPackage()</code></a></li>
  <li><a href="/fr/docs/DOM/Apps.getSelf"><code>navigator.mozApps.getSelf()</code></a></li>
  <li><a href="/fr/docs/DOM/Apps.getInstalled"><code>navigator.mozApps.getInstalled()</code></a></li>
</ul>
<h2 id="Management_API" name="Management_API">API de gestion (<code>navigator.mozApps.mgmt.*</code>)</h2>
<p>L'API de gestion des applications a un accès restreint. Il est prévu d'y donner accès à des pages de confiance, appelées "tableaus de bord". L'API de gestion expose des fonctions qui permettent aux tableaux de bord de gérer et de lancer les applications pour l'utilisateur. De plus, l'API expose des fonctions pour la synchronisation des applications, ce qui permet aux tableaux de bord d'afficher l'état connecté de l'utilisateur, et de lui permettre de s'identifier ou de s'inscrire pour synchroniser les applications entre plusieurs appareils.</p>
<ul>
  <li><a href="/fr/docs/DOM/Apps.mgmt.getAll"><code>navigator.mozApps.mgmt.getAll()</code></a></li>
</ul>
<h2 id="Objects" name="Objects">Objets</h2>
<p>Les types d'objet JavaScript qui sont utilisées par les API d'applications :</p>
<ul>
  <li><a href="/fr/docs/DOM/App">Les objet App</a> représentent des applications.</li>
  <li><a href="/fr/docs/DOM/DOMRequest">Les objets DOMRequest</a> sont renvoyés par de nombreuses méthodes.</li>
  <li><a href="/fr/docs/DOM/DOMError">Les objets DOMError</a> representent les erreurs renvoyées par les méthodes.</li>
</ul>
<h2 id="Old_API_and_the_new_API" name="Old_API_and_the_new_API">Vieille API et nouvelle API</h2>
<p>Si vous utilisiez l'ancienne API, elle est obsolète depuis mars 2012. L'ancienne API est comparée avec la nouvelle API ci-dessous.</p>
<dl>
  <dt>
    <a href="/fr/docs/DOM/Apps.install">navigator.mozApps.install()</a></dt>
  <dd>
    Cette fonction a une signature différente.</dd>
  <dt>
    <a href="/en-US/docs/Apps/Apps_JavaScript_API/navigator.mozApps.amInstalled">navigator.mozApps.amInstalled()</a> {{ obsolete_inline() }}</dt>
  <dd>
    Remplacée par <a href="/en-US/docs/DOM/Apps.getSelf"><code>navigator.mozApps.getSelf()</code></a>.</dd>
  <dt>
    <a href="/en-US/docs/Apps/Apps_JavaScript_API/navigator.mozApps.getInstalledBy">navigator.mozApps.getInstalledBy()</a> {{ obsolete_inline() }}</dt>
  <dd>
    Remplacée par <a href="/en-US/docs/DOM/Apps.getInstalled"><code>navigator.mozApps.getInstalled()</code></a>.</dd>
  <dt>
    <a href="/en-US/docs/Apps/Apps_JavaScript_API/navigator.mozApps.mgmt.list">navigator.mozApps.mgmt.list()</a> {{ obsolete_inline() }}</dt>
  <dd>
    Remplacée par <a href="/en-US/docs/DOM/Apps.mgmt.getAll"><code>navigator.mozApps.mgmt.getAll()</code></a>.</dd>
  <dt>
    <a href="/en-US/docs/Apps/Apps_JavaScript_API/navigator.mozApps.mgmt.watchUpdates">navigator.mozApps.mgmt.watchUpdates(onupdate)</a> {{ obsolete_inline() }}<br />
    <a href="/en-US/docs/Apps/Apps_JavaScript_API/navigator.mozApps.mgmt.clearWatch">navigator.mozApps.mgmt.clearWatch(watchId)</a> {{ obsolete_inline() }}</dt>
  <dd>
    Les deux ont été remplacées par <a href="/en-US/docs/DOM/Apps.mgmt.addEventListener"><code>navigator.mozApps.addEventListener(type, cb)</code></a> et <a href="/en-US/docs/DOM/Apps.mgmt.removeEventListener"><code>navigator.mozApps.removeEventListener(type, cb)</code></a> où <code>type</code> peut être soit <code>install</code>, soit <code>uninstall</code>.</dd>
  <dt>
    <a href="/en-US/docs/Apps/Apps_JavaScript_API/navigator.mozApps.mgmt.uninstall">navigator.mozApps.mgmt.uninstall(origin, [onsuccess], [onerror])</a> {{ obsolete_inline() }}</dt>
  <dd>
    Remplacée par <code>app.uninstall()</code> où <code>app</code> est un objet renvoyé par <a href="/en-US/docs/DOM/Apps.mgmt.getAll"><code>getAll()</code></a> ou <code><a href="/en-US/docs/DOM/Apps.getInstalled">getInstalled()</a></code>.</dd>
</dl>
Revenir à cette révision