Exécution de Platform Assistant sur un Mac

Remonter à PAServer, l'application serveur Platform Assistant

Remonter à Développement d'applications Mac OS X

Remonter à Développement d'applications mobiles iOS

Sur le Mac, vous pouvez démarrer Platform Assistant de l'une des manières suivantes :

Double-cliquez sur RAD PAServer <version>.app dans le Finder (représentation graphique)
Par exemple : RAD PAServer XE5.app
Exécutez le fichier exécutable paserver en utilisant la fenêtre Terminal (ligne de commande)

Remarques :

Si vous utilisez la fenêtre Terminal, vous pouvez démarrer Platform Assistant avec des options personnalisées ; voir Définition des options de Platform Assistant.
Si vous utilisez le Finder, vous pouvez spécifier les options en utilisant un fichier .config comme décrit dans Définition des options de Platform Assistant.

Utilisation du Finder pour exécuter Platform Assistant

Sur le Mac, dans le Finder, activez le fichier .app (RAD PAServer <version>.app) de la manière suivante :

Naviguez jusqu'au dossier de niveau supérieur Applications.
Conseil : Si vous avez utilisé un autre chemin d'installation, accédez au répertoire approprié.
Double-cliquez sur RAD PAServer <version>.app pour démarrer Platform Assistant.

La fenêtre Terminal apparaît, affichant la bannière Platform Assistant et l'invite de mot de passe :

Mot de passe du profil de connexion <appuyez sur Entrée si aucun mot de passe> :

Pour savoir comment répondre à l'invite de mot de passe, voir Identification sur Platform Assistant.

Conseil : Pour afficher le fichier exécutable paserver dans le Finder, cliquez avec le bouton droit de la souris sur le fichier RAD PAServer <version>.app et sélectionnez Afficher le contenu du paquet. Cette action affiche les répertoires Contents et MacOS dans le Finder. Dans la fenêtre Terminal, ces répertoires sont toujours affichés. L'exécutable paserver se trouve dans le répertoire MacOS :

Applications/RAD PAServer <version>.app/Contents/MacOS/paserver

Exécution de paserver dans une fenêtre Terminal

Le fichier nommé paserver est l'exécutable en ligne de commande de Platform Assistant ; le chemin d'accès à paserver est :

 /Applications/RAD PAServer <version>.app/Contents/MacOS/paserver

Ce qui signifie que le fichier exécutable paserver se trouve dans le dossier Contents/MacOS au sein du package RAD PAServer <version>.app. Vous pouvez exécuter directement l'exécutable paserver dans la fenêtre Terminal.

Les procédures suivantes décrivent les deux façons de démarrer paserver sur la ligne de commande : en entrant une seule ligne de commande à partir du dossier Applications, ou en naviguant jusqu'au dossier MacOS. Cette méthode vous donne l'opportunité de voir les propriétés des fichiers dans le répertoire PAServer <version>.app\Contents\MacOS, y compris celles de paserver.

Exemple : Entrée d'une seule ligne de commande à partir du dossier Applications

Dans la fenêtre Terminal du Mac, vous pouvez utiliser une seule commande pour explorer le contenu du fichier RAD PAServer <version>.app et démarrer paserver :

Ouvrez une fenêtre Terminal sur le Mac, et utilisez la commande cd pour accéder au dossier de niveau supérieur Applications.
Par exemple; entrez la première ou les lettres du dossier Applications, puis appuyez sur la touche Tab. S'il n'existe qu'un seul répertoire dont le nom commence par les lettres entrées, le nom du répertoire apparaît :
yourname $ cd /A <Tab>
yourname $ cd /Applications <Retour>
Applications yourname $
- Entrez une commande cd contenant les premières lettres des parties successives du chemin d'accès, en appuyant sur la touche Tab après chaque entrée pour compléter ces parties.
Une fois le chemin d'accès entièrement saisi, votre ligne de commande ressemble à ceci :
Applications yourname $ /Applications/RAD\ PAServer\ <version>.app/Contents/MacOS/paserver
Appuyez sur Retour.

Exemple : Navigation jusqu'à l'emplacement d'installation de paserver (dossier MacOS)

Dans la fenêtre Terminal du Mac, vous pouvez utiliser une série de commandes cd pour explorer le contenu du fichier RAD PAServer <version>.app et démarrer paserver :

Utilisez la commande cd et la touche Tab. Par exemple, pour ouvrir le dossier Applications (en commençant depuis l'emplacement principal de l'utilisateur sur le Mac), entrez :
yourname $ cd /A <Tab> <Retour>
Affichez le contenu du dossier Applications en entrant :
Applications yourname $ ls
'RAD PAServer <version>.app doit apparaître dans le répertoire Applications.
Naviguez jusqu'au package RAD PAServer <version>.app en entrant les premières lettres de chaque dossier et en appuyant sur la touche Tab, comme suit :
Applications yourname $ cd RAD <Tab>
Con <Tab>
Mac <Tab>
pas <Tab>

La ligne de commande doit avoir l'apparence suivante :
Applications yourname $ /Applications/RAD\ PAServer\ <version>.app/Contents/MacOS/paserver
Appuyez sur Retour pour exécuter la commande.
Dans le répertoire MacOS, vous devez voir paserver. Entrez :
MacOS yourname $ ./paserver.
Remarque : Sur le Mac, vous devez préfixer toute commande d'exécution des caractères './'.
Appuyez sur Retour.

Lorsque vous exécutez paserver, vous pouvez également ajouter des options de ligne de commande, comme :

MacOS yourname $ ./paserver -port=64444

Pour de plus amples informations, voir Définition des options de Platform Assistant.

Identification sur Platform Assistant

Après avoir démarré paserver, Platform Assistant affiche sa bannière, puis son invite de mot de passe :

 Connection Profile password <press Enter for no password>:

A l'invite de mot de passe, choisissez l'une des actions suivantes :
- Pour demander un mot de passe lors de la connexion à Platform Assistant, entrez le mot de passe de votre choix, puis appuyez sur Entrée.
- Si vous ne souhaitez pas demander un mot de passe lors de la connexion à Platform Assistant, appuyez sur Entrée.
Si vous démarrez Platform Assistant pour la première fois au cours d'une session sur le Mac, le Mac affiche la boîte de dialogue d'accès aux outils de développement suivante :
Developer Tools Access is trying to take control of another process.
Type your password to allow Developer Tools Access to make changes.

Entrez le mot de passe administrateur pour le Mac (typiquement le mot de passe que vous entrez lors de la connexion au système) pour permettre le débogage avec Platform Assistant.

Si vous n'entrez pas le mot de passe correct ou si vous annulez, Platform Assistant démarre normalement, mais lorsque vous réessayerez de déboguer une application à partir de RAD Studio en utilisant Platform Assistant, vous serez à nouveau invité à fournir le mot de passe administrateur. Voir Acquisition de la permission permettant de supporter le débogage sur un Mac.

Après avoir suivi ces étapes, les deux lignes suivantes s'affichent dans la fenêtre Terminal :

 Starting Platform Assistant Server on port 64211
 >

L'invite de commande > indique que Platform Assistant est en mode "écoute" sur le port spécifié (64211 par défaut). Vous pouvez entrer la commande h (tapez "h" et appuyez sur Entrée) pour voir la liste des commandes disponibles et leur description. Pour quitter Platform Assistant, entrez la commande q.

Problèmes de connexion

Exécution de PAServer si le coupe-feu du Mac est activé

Si le coupe-feu Mac est activé, vous obtenez le message suivant après la notification "Acquérir la permission pour supporter le débogage" lorsque vous démarrez PAServer sur le Mac :

 Do you want the application "paserver" to accept incoming network connections?"

Même si vous cliquez sur "Autoriser", PAServer ne peut pas se connecter sur le Mac depuis votre système de développement. Vous devez spécifiquement autoriser PAServer à utiliser l'une des solutions suivantes :

Solution 1 : Désactivez le coupe-feu sur le Mac. Utilisez les étapes suivantes :

Sur le Mac, ouvrez Préférences Système dans le menu Apple.
Sélectionnez Sécurité et confidentialité puis l'onglet Coupe-feu.
Cliquez sur l'icône Cadenas dans le coin inférieur gauche.
Cliquez sur le bouton Désactiver le coupe-feu.
Cliquez sur l'icône Cadenas et fermez la fenêtre Sécurité et confidentialité.

Solution 2 : Autorisez spécifiquement l'accès à PAServer via le coupe-feu sur le Mac. Utilisez les étapes suivantes :

Sur le Mac, ouvrez Préférences Système dans le menu Apple.
Sélectionnez Sécurité et confidentialité puis l'onglet Coupe-feu.
Cliquez sur Options du coupe-feu. (Si le bouton est désactivé, cliquez sur l'icône Cadenas dans le coin inférieur gauche.)
Cliquez sur le signe + pour naviguer vers le dossier Applications.
Sélectionnez RAD PAServer <version>.app puis cliquez sur Ajouter. Cela a pour effet d'ajouter le bundle RAD PAServer <version>.app à la liste des applications listées dans Options du coupe-feu.
Pour ajouter le fichier binaire paserver :
1. Cliquez sur le signe +.
2. Tapez Commande-Maj-G.
3. Dans Aller au dossier :, entrez le chemin complet de paserver. Par exemple :
  /Applications/RAD PAServer <version>.app/Contents/MacOS
4. Le contenu du répertoire MacOS est affiché. Localisez et double-cliquez sur paserver. Cela a pour effet d'ajouter le fichier binaire paserver à la liste des applications listées dans Options du coupe-feu.
Cliquez sur l'icône Cadenas et fermez la fenêtre Sécurité et confidentialité.

Voir aussi Exécution de Platform Assistant sur un Mac.

Connexion à PAServer lorsque le port est en cours d'utilisation

Vous pouvez obtenir cette erreur lorsque vous essayez d'exécuter PAServer sur le Mac et que le socket est en cours d'utilisation (possiblement par une instance de PAServer qui est déjà exécutée ou qui est devenue inaccessible) :

Message: Could not bind socket. Address and port are already in use.

La solution consiste à utiliser l'une des méthodes ci-dessous :

Utilisez l'instance existante de PAServer.
Arrêtez l'instance existante de PAServer.
Tuez l'instance existante de PAServer en procédant comme suit :
1. Dans la fenêtre Terminal, entrez : ps -a.
2. Trouvez l'instance de PAServer et son numéro PID.
3. Entrez : kill <pid>.