Construction d'une application console Hello World OS X

De RAD Studio
Aller à : navigation, rechercher

Remonter à Développement d'applications OS X


Ce tutoriel "Hello World" illustre les étapes essentielles de la création d'une application multi-périphérique dans Delphi ou C++. Cette application cible la plate-forme OS X (le Mac), une fenêtre console, un événement, et affiche une boîte de dialogue en réponse à une action de l'utilisateur.

Prérequis

Voir Configuration de votre environnement de développement pour OS X.

Etapes

Pour créer l'application console "Hello World" OS X :

Connecter votre PC à un Mac

Voir Travailler avec un Mac et un PC.

Exécuter Platform Assistant sur la cible OS X

  1. Platform Assistant nécessite d'être exécuté à la fois sur le PC de développement et sur le Mac cible :
    • Si Platform Assistant est déjà installé sur le PC et le Mac, allez à l'étape suivante.
    • Si Platform Assistant n'est pas encore installé sur le PC ou le Mac, installez Platform Assistant sur la plate-forme cible. L'installateur est disponible pour s'exécuter sur le PC ou le Mac, comme suit :
    Notez que paclient.exe, l'application client Platform Assistant est installée sur votre système de développement lors de l'installation de RAD Studio.
  2. Ouvrez une fenêtre Terminal sur le Mac.
  3. Accédez au répertoire (cd) qui contient Platform Assistant (PAServer).
  4. Exécutez Platform Assistant en entrant :
    ./paserver
  5. Quand vous êtes invité à définir un mot de passe, entrez une chaîne de mot de passe facultative. C'est le mot de passe qui sera requis depuis tout profil de connexion se connectant à cette instance de Platform Assistant. Pour ne définir aucun mot de passe, appuyez sur Entrée.
Platform Assistant affiche un message d'authentification et son invite de commande (>).

Créer un profil de connexion pour le serveur Platform Assistant

  1. Choisissez Outils > Options > Options d'environnement > Gestionnaire de profils de connexion.
  2. Cliquez sur Ajouter. L'expert Créer un profil de connexion s'ouvre.
  3. Sur la première page de l'expert, (Informations relatives au profil) :
    • Dans Nom du profil, entrez un nom pour le profil de connexion.
    • Dans Plate-forme, sélectionnez la plate-forme sur laquelle le serveur Platform Assistant est exécuté, dans ce cas OS X.
    • Cliquez sur Suivant.
  4. Sur la seconde page de l'expert, (Informations relatives à la machine distante) :
    • Dans Machine distante (adresse IP ou nom de machine), entrez le nom ou l'adresse IP de la machine cible (le Mac).
      • Pour déterminer l'adresse IP de la machine distante, entrez l'une des commandes suivantes :
        • i sur la console PAServer, sur le Mac.
        • ifconfig sur la fenêtre terminal du Mac.
    • Laissez Numéro du port à sa valeur par défaut, 64211.
    • Dans le champ Mot de passe, entrez la chaîne du mot de passe facultatif qui a été définie au démarrage du Platform Assistant auquel vous vous connectez. Pour chercher un fichier de mot de passe (*.passfile, créé avec paserver et contenant un mot de passe encrypté pour le partage avec d'autres utilisateurs), cliquez sur les points de suspension (...). Si aucun mot de passe n'a été défini pour Platform Assistant, laissez ce champ vide.
    • Cliquez sur Tester connexion.
      • Si la connexion échoue, vérifiez l'adresse IP ou le nom de la machine cible (avec une requête ping sur la fenêtre cmd), puis assurez-vous que Platform Assistant est installé et en cours d'exécution sur la machine cible.
      • Si la connexion réussit (ou échoue), cliquez sur Suivant.

        Remarque : Vous pouvez créer un profil de connexion même si la connexion à la cible n'a pas encore réussi. Toutefois, un profil de connexion valide est nécessaire à plusieurs moments critiques du développement d'une application OS X, c'est-à-dire lors de l'exécution, le débogage et le déploiement.

  5. Cliquez sur OK pour fermer la page Gestionnaire de profils de connexion.

Ajouter un SDK pour la cible OS X

  1. Choisissez Outils > Options > Options d'environnement > Gestionnaire de SDK.
  2. Cliquez sur Ajouter. La boîte de dialogue Ajouter un nouveau SDK s'ouvre.
  3. Dans Sélectionner une plate-forme, sélectionnez la plate-forme cible, dans ce cas OS X.
  4. Dans Sélectionner un profil à connecter, sélectionnez le profil de connexion préalablement créé.
  5. Dans Sélectionner une version SDK, sélectionnez Command Line Tools.
    Le SDK Command Line Tools (Outils en ligne de commande) fournit les bibliothèques et les en-têtes de base pour la construction d'une application OS X. C'est le strict nécessaire pour votre application Hello World. Tout autre SDK de la liste le ferait aussi, puisque tous fournissent aussi les bibliothèques du SDK Command Line Tools.
    Remarque : La liste des SDK disponibles est récupérée à partir de votre système OS X, en utilisant le profil de connexion que vous avez sélectionné lors de l'étape précédente. Si la liste de la zone de liste déroulante est vide ou qu'un SDK spécifique est manquant, voir Ajout d'un SDK OS X ou iOS à des fins de dépannage.
  6. Cliquez sur OK pour fermer la page Gestionnaire de SDK.

Les fichiers (en-têtes et bibliothèques) du SDK spécifié seront extraits du Mac et copiés dans le PC de développement. Pour inclure des frameworks ou des bibliothèques supplémentaires, voir Ajouter un élément de chemin distant ou Modifier un élément de chemin distant.

Créer et configurer une application console pour la cible OS X

  1. Choisissez Fichier > Nouveau > Autre. La boîte de dialogue Nouveaux éléments apparaît.
  2. Sélectionnez Projets Delphi ou Projets C++Builder, puis double-cliquez sur Application console.
  3. Dans la boîte de dialogue Nouvelle application console (C++), assurez-vous que Application console est cochée, que Framework cible est défini sur Aucun et que Multi-thread est décochée. Cliquez ensuite sur OK.
  4. Dans le Gestionnaire de projets, cliquez avec le bouton droit sur le noeud Plates-formes cible puis cliquez sur Ajouter une plate-forme :
    AddTargetPlatform.png
  5. Sur la boîte de sélection Sélectionner une plate-forme, sélectionnez OS X, activez la case à cocher Rendre active la plate-forme sélectionnée, puis cliquez sur OK :
    SelectPlatform.png
  6. Associez un SDK et un profil de connexion à la cible OS X :
    1. Cliquez avec le bouton droit sur la plate-forme OS X dans le Gestionnaire de projets pour afficher le menu contextuel suivant :
      AddActivateOSX.png
      Sur le menu contextuel, sélectionnez Propriétés. La boîte de dialogue Propriétés de la plate-forme s'ouvre.
      PlatformProperties.png
    2. Sélectionnez dans SDK (Software Development Kit) le SDK que vous avez créé pour cette application Hello World.
    3. Dans Profil, sélectionnez le profil de connexion que vous avez créé pour cette application Hello World.
    4. Cliquez sur OK pour enregistrer les modifications.

Le nom du profil est maintenant affiché auprès de la plate-forme OS X dans le Gestionnaire de projets. Le nom du SDK est aussi affiché si votre application est C++.

Ecrire le code

Dans l'éditeur de code, modifiez le code généré depuis le template :

  1. Pour C++ seulement, ajoutez le code suivant après les autres directives #include :
    #include <iostream>
    
  2. Ajoutez le code pour dire hello et attendre la touche Entrée.
    • Pour Delphi, entrez les instructions suivantes dans le bloc try (avant le mot clé except) :
      Writeln('Hello, World!');
      Readln;
      
    • Pour C++, entrez le code suivant avant la ligne return 0; :
      std::cout << "Hello, World!" << std::endl;
      std::cin.ignore();
      
  3. Enregistrez et nommez l'application (Fichier > Enregistrer).

Exécuter l'application console sur la cible OS X

  1. Choisissez Exécuter > Exécuter sans déboguer.
  2. RAD Studio affiche : Le projet doit être compilé avant son déploiement. Continuer ?. Cliquez sur Oui.
  3. Sur la machine cible, le message "Hello, World!" est affiché à l'invite de Platform Assistant (après les messages du débogueur). Appuyez sur la touche ENTREE. Dès que votre application console est terminée, le serveur Platform Assistant réaffiche son invite de commande (>).

Déboguer l'application

Pour déboguer votre application dans l'EDI, utilisez l'une des commandes Exécuter standard :

  • Exécuter > Exécuter (F9)
  • Exécuter > Pas à pas (F8)
  • Exécuter > Pas à pas approfondi (F7)

Vous pouvez aussi utiliser la commande Charger un processus ou Attacher au processus pour démarrer le débogueur.

Toutes ces commandes :

  • Transfèrent les fichiers requis sur la machine cible, selon le profil assigné en cours.
  • Exécutent l'application en mode débogage.

L'utilisation du débogueur intégré dans l'EDI pour déboguer une application OS X est très similaire à l'utilisation du débogueur intégré pour déboguer une application Win32 native.

Si vous exécutez votre application en utilisant une commande Exécuter qui démarre le débogueur (telle que Exécuter > Exécuter, Exécuter > Pas à pas ou Exécuter > Pas à pas approfondi), il est possible que vous soyez invité à entrer le mot de passe root pour le Mac afin de donner l'accès au débogueur.

Voir aussi