Cordova - Démonstration de bout en bout
improve this page | report issuePrésentation
Cette démonstration présente un processus complet :
- Une application exemple fournie avec le kit SDK client MobileFirst est enregistrée et téléchargée à partir de la console MobileFirst Operations Console.
- Un nouvel adaptateur ou un adaptateur fourni est déployé sur la console MobileFirst Operations Console.
- La logique d’application est changée afin d’effectuer une demande de ressource.
Résultat final :
- Interrogation par commande ping du serveur MobileFirst Server réussie.
- Extraction réussie des données à l’aide d’un adaptateur.
Prérequis :
- Xcode for iOS, Android Studio for Android ou Visual Studio 2013/2015 for Windows 8.1 Universal / Windows 10 UWP
- Cordova CLI 6.x.
- Facultatif - MobileFirst CLI (téléchargement)
- Facultatif - Serveur MobileFirst Server autonome (téléchargement)
1. Démarrage du serveur MobileFirst Server
Assurez-vous d’avoir créé une instance Mobile Foundation, ou
Si vous utilisez le kit MobileFirst Developer Kit, accédez au dossier du serveur puis exécutez la commande ./run.sh
sous Mac et Linux ou run.cmd
sous Windows.
2. Création et enregistrement d’une application
Dans une fenêtre de navigateur, ouvrez la console MobileFirst Operations Console en entrant l’URL http://your-server-host:server-port/mfpconsole
. Dans le cas d’une exécution locale, entrez l’URL http://localhost:9080/mfpconsole. Le nom d’utilisateur et le mot de passe sont admin/admin.
- Cliquez sur le bouton Nouveau en regard de l’option Applications
- Sélectionnez une plateforme : Android, iOS, Windows
- Entrez com.ibm.mfpstartercordova en tant qu’identificateur d’application
- Entrez 1.0.0 dans la zone Version
- Cliquez sur Enregistrer l’application
-
Cliquez sur le titre Obtenir le code de démarrage puis indiquez que vous souhaitez télécharger l’application exemple Cordova.
3. Edition d’une logique d’application
-
Ouvrez le projet Cordova dans l’éditeur de code de votre choix.
-
Sélectionnez le fichier www/js/index.js et collez le fragment de code suivant en remplaçant la fonction
WLAuthorizationManager.obtainAccessToken()
existante :
WLAuthorizationManager.obtainAccessToken()
.then(
function(accessToken) {
titleText.innerHTML = "Yay!";
statusText.innerHTML = "Connected to MobileFirst Server";
var resourceRequest = new WLResourceRequest(
"/adapters/javaAdapter/resource/greet/",
WLResourceRequest.GET
);
resourceRequest.setQueryParameter("name", "world");
resourceRequest.send().then(
function(response) {
// Will display "Hello world" in an alert dialog.
alert("Success: " + response.responseText);
},
function(response) {
alert("Failure: " + JSON.stringify(response));
}
);
},
function(error) {
titleText.innerHTML = "Bummer...";
statusText.innerHTML = "Failed to connect to MobileFirst Server";
}
);
4. Déploiement d’un adaptateur
Téléchargez cet artefact .adapter préparé et déployez-le à partir de la console MobileFirst Operations Console en sélectionnant Actions → Déployer un adaptateur.
Vous pouvez également cliquer sur le bouton Nouveau en regard de la zone Adaptateurs.
-
Sélectionnez l’option Actions → Télécharger des exemples. Téléchargez l’adaptateur Java exemple “Hello World”.
Si Maven et MobileFirst CLI ne sont pas installés, suivez les instructions de configuration de votre environnement de développement s’affichant à l’écran.
-
A partir d’une fenêtre de ligne de commande, accédez au dossier racine du projet Maven de l’adaptateur et exécutez la commande :
mfpdev adapter build
-
Une fois la génération terminée, déployez-la à partir de la console MobileFirst Operations Console en utilisant l’option Actions → Déployer un adaptateur. L’adaptateur est disponible dans le dossier [adaptateur]/target.
5. Test de l’application
- A partir d’une fenêtre de ligne de commande**, accédez au dossier racine du projet Cordova.
- Exécutez la commande
cordova platform add ios|android|windows
pour ajouter une plateforme. - Dans le projet Cordova, sélectionnez le fichier config.xml et modifiez les propriétés protocol, host et port de la valeur
<mfp:server ... url=" "/>
en entrant les valeurs correspondant à votre serveur MobileFirst Server.- Si vous utilisez un serveur MobileFirst Server local, les valeurs sont généralement http, localhost et 9080.
- Si vous utilisez un serveur MobileFirst Server distant (sur IBM Cloud), les valeurs sont généralement https, your-server-address et 443.
- Si vous utilisez un cluster Kubernetes sur IBM Cloud Private et si le déploiement est de type NodePort, la valeur du port est généralement celle de NodePort exposée par le service dans le cluster Kubernetes.
Par ailleurs, si vous avez installé l’interface MobileFirst CLI, accédez au dossier racine du projet puis exécutez la commande
mfpdev app register
. Si un serveur MobileFirst Server distant est utilisé, exécutez la commandemfpdev server add
pour ajouter le serveur, suivi par exemple de la commandemfpdev app register myIBMCloudServer
.
Si un appareil est connecté, l’application est installée et exécutée sur ce dernier.
Dans le cas contraire, le simulateur ou l’émulateur est utilisé.
Résultats
- Si vous cliquez sur Ping MobileFirst Server, la mention Connected to MobileFirst Server s’affiche.
- Si l’application a pu se connecter au serveur MobileFirst Server, un appel de demande de ressource utilisant l’adaptateur Java déployé aura lieu.
La réponse de l’adaptateur est ensuite affichée dans une alerte.
Etapes suivantes
Pour en savoir plus notamment sur l’utilisation d’adaptateurs dans des applications et sur le mode d’intégration de services supplémentaires (notifications Push, par exemple) à l’aide de l’infrastructure de sécurité MobileFirst :
- Consultez les tutoriels Developing Applications
- Consultez les tutoriels Adapters development
- Consultez les tutoriels Authentication and security
- Consultez les tutoriels Notifications
- Consultez tous les tutoriels
Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.