Construction d'une application console Hello World macOS

Remonter à Développement d'applications macOS

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

Prérequis

Voir Configuration de votre environnement de développement pour macOS.

Etapes

Pour créer l'application console "Hello world" macOS :

Connecter votre PC à un Mac

Voir Travailler avec un Mac et un PC.

Exécuter Platform Assistant sur la cible macOS

• Plus de détails.

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, passez à 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 :
     • Pour installer sur le Mac cible, utilisez RADPAServerXE4.pkg. Pour obtenir des instructions, voir Installation de Platform Assistant sur un Mac.
     • Pour installer sur le PC, utilisez setup_paserver.exe. Pour obtenir des instructions, voir Installation de Platform Assistant sur Windows.

   Remarque: 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

• Plus de détails.

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, saisissez un nom pour le profil de connexion.
   • Dans Plate-forme, sélectionnez la plate-forme cible sur laquelle le serveur Platform Assistant est exécuté, dans ce cas macOS 64 bits (Intel) ou macOS 64 bits (ARM).
   • 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), saisissez 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 crypté 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 la 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 macOS, c'est-à-dire lors de l'exécution, du débogage et du déploiement.

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

Ajouter un SDK pour la cible macOS

• Plus de détails.

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 macOS 64 bits (Intel) ou macOS 64 bits (ARM).
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 macOS. 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 macOS, en utilisant le profil de connexion que vous avez sélectionné à 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 macOS 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 macOS

• Plus de détails.

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 :

   

5. Dans la zone de sélection Sélectionner une plate-forme, sélectionnez macOS 64 bits (Intel) ou macOS 64 bits (ARM), cochez la case Rendre active la plate-forme sélectionnée, puis cliquez sur OK :

   

6. Associez un SDK et un profil de connexion à la cible macOS :
   1. Cliquez avec le bouton droit sur la plate-forme macOS dans le Gestionnaire de projets pour afficher le menu contextuel suivant :

      

      Dans le menu contextuel, sélectionnez Propriétés. La boîte de dialogue Propriétés de la plate-forme s'ouvre.

      

   2. Dans SDK (Software Development Kit), sélectionnez 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 s'affiche maintenant à côté de la plate-forme macOS 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 block (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 macOS

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!" s'affiche à 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

• Plus de détails.

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 macOS 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 ou 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

• Développement d'applications MacOS
• Travailler avec un Mac et un PC
• Développement des applications multi-périphériques
• Page Gestionnaire de profils de connexion dans Options des outils
• Expert Créer un profil de connexion
• Boîte de dialogue Sélectionner un profil de connexion
• Page Gestionnaire de SDK dans Options des outils
• paserver, l'application serveur Platform Assistant
• Prérequis de plate-forme FireMonkey
• Pages Man macOS
• macOS Command Line 101 (EN)