Exécuter votre application Apache Cordova sur l'émulateur Apache Ripple

Article
06/10/2015

Cet article fait référence à Visual Studio Tools pour Apache Cordova, qui correspond à la version préliminaire du logiciel. Les fonctionnalités décrites sont dans l'aperçu et sont sujettes à modification. Vous pouvez télécharger l'aperçu à partir du Centre de téléchargement Microsoft.

L'émulateur Apache Ripple s'exécute comme une application web dans un navigateur (Google Chrome). Dans Cordova, il peut être utilisé pour simuler votre application sur un certain nombre d'appareils et de plateformes, et il fournit un support de base pour les principaux plug-ins Cordova, comme Geolocation et Device Orientation.

L'émulateur Ripple fournit une première étape rapide et facile dans la création et la validation de votre application pour Android et iOS, car les deux plateformes utilisent un navigateur avec une base de code similaire. L'émulateur Ripple est particulièrement utile pour la validation de la disposition et du code des feuilles de style CSS. Pour une plus grande fidélité de l'émulation spécifique à une plateforme, utilisez les émulateurs Android ou iOS, ou bien un appareil réel.

Avertissement

Ripple ne fournit pas une émulation complète des fonctionnalités des API Cordova ou des appareils natifs. Il n'émule par non plus des versions spécifiques du navigateur utilisé par votre application sur une plateforme d'un appareil particulier.

Voici quelques considérations à garder à l'esprit quand vous testez la disposition à l'aide de Ripple.

Si vous ciblez Android 4.4 ou version ultérieure (navigateur basé sur Chromium), la prise en charge des normes CSS et des autres technologies web actuelles est meilleure. Consultez caniuse.com pour obtenir des informations spécifiques sur les fonctionnalités prises en charge.
Si vous ciblez des versions iOS ou Android antérieures à 4.4, le navigateur est basé sur WebKit. (L'émulateur Ripple, qui utilise la version installée de Chrome, a un comportement plus proche d'Android 4.4.) Le comportement de certains navigateurs WebKit est différent. Par exemple, les navigateurs WebKit ne fournissent pas une prise en charge cohérente pour les unités vw et vh.

Exécuter votre application sur l'émulateur Apache Ripple

La procédure suivante vous montre comment exécuter votre application sur l'émulateur et comment attacher le débogueur.

Pour exécuter votre application sur l'émulateur Ripple

Sélectionnez Android ou iOS dans la liste Plateformes Solution.

Notes

Si vous ne voyez pas cette liste, sélectionnez Plateformes Solution dans la liste Boutons Ajouter/Supprimer pour l'afficher.
Dans la liste des appareils cibles, choisissez un des émulateurs Ripple.
Appuyez sur F5 pour démarrer le débogage ou sur Maj+F5 pour démarrer votre application sans débogage.

Conseil

Si vous obtenez une erreur indiquant que vous devez installer une nouvelle version du Kit de développement logiciel (SDK) Android, utilisez le Gestionnaire de SDK Android pour l'installer.Dans Windows, le fichier Manager.exe du SDK est installé à l'emplacement suivant : %localappdata%\Android\android-sdk (par exemple, C:\Users\utilisateur\AppData\Local\Android\android-sdk).

Changer le proxy pour l'émulateur

Ripple évite les limitations interdomaines dans le navigateur à l'aide d'un proxy. Deux proxys sont disponibles : un proxy distant et un proxy local. Le proxy distant est hébergé dans le cloud.

Note de sécurité
Si votre application transfère des données sensibles (par exemple des jetons d'authentification Active Directory), nous vous recommandons fortement d'utiliser le proxy local au lieu du proxy distant.

Pour changer le proxy

Dans Chrome, pendant que votre application est en cours d'exécution, cliquez sur le bouton fléché sur la droite, puis choisissez la section Paramètres.
Sélectionnez le bouton Proxy interdomaine, puis sélectionnez un proxy.

Changer l'appareil pendant l'exécution de l'application

Vous pouvez changer l'appareil cible à la volée pendant que votre application s'exécute dans Chrome. Vous pouvez ainsi éviter de redémarrer l'application dans Visual Studio.

Pour changer l'appareil

Pendant que votre application s'exécute dans Chrome, cliquez sur le bouton fléché sur la gauche, puis choisissez la section Appareils.
Cliquez sur le bouton qui spécifie le nom de l'appareil actuel, puis choisissez un autre appareil.