Windows 8.1 Universal et Windows 10 UWP - Démonstration de bout en bout

Présentation

Cette démonstration présente un processus complet :

1. 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.
2. Un nouvel adaptateur ou un adaptateur fourni est déployé sur la console MobileFirst Operations Console.
3. 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 :

• Visual Studio 2013/5 configuré
• 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 et exécutez la commande ./run.cmd.

2. Création 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.

1. Cliquez sur le bouton Nouveau en regard de l’option Applications
   • Sélectionnez une plateforme Windows
   • Entrez MFPStarterCSharp.Windows en tant qu’identificateur d’application pour Windows ou MFPStarterCSharp.WindowsPhone pour Windows Phone
   • Entrez 1.0.0 dans la zone Version
   • Cliquez sur Enregistrer l’application

   

2. Cliquez sur le titre Obtenir le code de démarrage puis indiquez que vous souhaitez télécharger l’application exemple Windows 8.1 ou Windows 10.

   

3. Edition d’une logique d’application

1. Ouvrez le projet Visual Studio.

2. Sélectionnez le fichier MainPage.xaml.cs de la solution et collez le fragment de code suivant dans la méthode GetAccessToken() :

   try
                   {
          IWorklightClient _newClient = WorklightClient.CreateInstance();
          accessToken = await _newClient.AuthorizationManager.ObtainAccessToken("");
          if (accessToken.IsValidToken &&  accessToken.Value != null &&  accessToken.Value != "")
          {
              System.Diagnostics.Debug.WriteLine("Received the following access token value: " + accessToken.Value);
              titleTextBlock.Text = "Yay!";
              statusTextBlock.Text = "Connected to MobileFirst Server";
   
              Uri adapterPath = new Uri("/adapters/javaAdapter/resource/greet",UriKind.Relative);
              WorklightResourceRequest request = _newClient.ResourceRequest(adapterPath, "GET","");
              request.SetQueryParameter("name", "world");
              WorklightResponse response = await request.Send();
   
              System.Diagnostics.Debug.WriteLine("Success: " + response.ResponseText);
   
            }
        }
        catch (Exception e)
        {
            titleTextBlock.Text = "Uh-oh";
            statusTextBlock.Text = "Client failed to connect to MobileFirst Server";
            System.Diagnostics.Debug.WriteLine("An error occurred: '{0}'", e);
        }
   

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.

5. Test de l’application

1. Dans Visual Studio, sélectionnez le fichier mfpclient.resw puis modifiez les propriétés protocol, host et port en indiquant les valeurs correctes de 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 commande mfpdev server add pour ajouter le serveur, suivi par exemple de la commande mfpdev app register myIBMCloudServer.

2. Cliquez sur le bouton Run App.

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 envoyée dans la console de sortie de Visual Studio.

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