Afficher : Delphi C++
Préférences d'affichage

Installation et exécution de Platform Assistant (paserver) sur la plate-forme cible

De RAD Studio XE2

Remonter à Etapes de la création d'applications multiplates-formes

Remonter à Utilitaires en ligne de commande - Index


Sommaire

Afin d'utiliser l'EDI pour développer des applications multiplates-formes, vous devez installer et exécuter Platform Assistant sur la plate-forme cible. Le nom de fichier de Platform Assistant est paserver, le serveur d'applications distant. Si vous utilisez le numéro de port par défaut (64211), vous pourrez utiliser Platform Assistant sans changer les paramètres. Pour changer les paramètres, voir Définition des options pour paserver ou Fichier paserver.config.

Quand vous installez Platform Assistant sur la plate-forme cible, les éléments nécessaires de la bibliothèque multiplate-forme sont installés dans le répertoire d'installation PAServer. Platform Assistant installe les fichiers nécessaires au débogage d'une application multiplate-forme.

Connexion à Platform Assistant à des moments spécifiques

Important : Pour exécuter, déboguer et déployer une application multiplate-forme, RAD Studio doit être connecté à Platform Assistant en cours d'exécution sur la plate-forme cible. Vous devez garantir cette connexion quand vous :
  • Testez la connexion d'un profil distant.
  • Exécutez votre application multiplate-forme.
  • Déboguez votre application multiplate-forme.
  • Déployez votre application multiplate-forme.
A d'autres moments pendant le développement de l'application, il n'est pas nécessaire que la plate-forme cible soit connectée et exécute Platform Assistant.

Mac : Installation et exécution de Platform Assistant (paserver) sur un Mac

L'installateur pour le Mac, setup_paserver.zip, est situé dans le dossier PAServer à l'intérieur du répertoire d'installation de votre produit, par défaut : 

C:\Program Files\Embarcadero\RAD Studio\n.n\PAServer\setup_paserver.zip

Le nom de l'exécutable est paserver.

Pour installer le serveur Platform Assistant sur un Mac

  1. Sur le Mac, téléchargez setup_paserver.zip depuis l'emplacement donné ci-dessus dans un répertoire local.
  2. Dézippez le fichier en double-cliquant sur le fichier zip dans le Finder.
    Ou dézippez le fichier à partir de la ligne de commande en utilisant la commande suivante dans une fenêtre Terminal :
    unzip setup_paserver.zip
  3. Double-cliquez sur l'installateur setup_paserver dans le Finder. L'installateur InstallAnywhere de Platform Assistant Server se lance.
  4. Sélectionnez votre langue cible (par exemple, Français) et cliquez sur OK.
  5. Par défaut, Platform Assistant est installé dans le répertoire Applications/Embarcadero/PAServer. Sur la page de sélection d'un dossier de destination, vous pouvez changer l'emplacement de l'installation ou accepter celui par défaut. Platform Assistant doit démarrer avec succès lors de l'utilisation du port par défaut, 64211.

Pour exécuter Platform Assistant sur un Mac

L'emplacement par défaut de l'installation se trouve sous votre dossier Applications sur le Mac (/USER_HOME/Applications/Embarcadero/PAServer).

  1. Ouvrez une fenêtre terminal.
  2. Utilisez la commande cd pour passer au répertoire de Platform Assistant (Applications/Embarcadero/PAServer) : 
mymac:~ myname$ cd Applications
mymac:Applications myname$ cd Embarcadero
mymac:Embarcadero myname$ cd PAServer
mymac:PAServer myname$
3. Lancez Platform Assistant en utilisant la commande suivante : 
mymac:PAServer myname$ ./paserver
Remarque : Un message "commande non trouvée" est affiché si vous ne commencez pas la commande par le ./ ("point-barre oblique") requis.
La bannière paserver et l'invite du mot de passe apparaissent : 
Platform Assistant version 1.0.2
Copyright (c) 2009-2011 Embarcadero Technologies, Inc.

Remote Profile password <press Enter for no password>:
4. A l'invite Mot de passe du profil distant :, choisissez l'une des actions suivantes :
  • Pour définir un mot de passe qui sera obligatoire pour être dans tout profil distant qui se connecte à ce processus paserver, entrez un mot de passe de votre choix et appuyez sur Entrée.
Dans ce cas, le mot de passe doit être correctement spécifié dans le profil distant utilisé par l'application multiplate-forme.
  • Pour ne pas demander un mot de passe pour la connexion à ce processus paserver, appuyez sur Entrée.
Dans ce cas, aucun mot de passe n'est requis dans le profil distant.
5. Acquisition de la permission de support du débogage sur le Mac
Sur la plate-forme OS X, Platform Assistant utilise l'accès aux outils de développement pour garantir le débogage de votre application OS X. La première fois que vous démarrez Platform Assistant lors d'une session sur le Mac, l'invite suivante apparaît (après l'invite du mot de passe) : 
Acquiring permission to support debugging...
Le Mac affiche maintenant la boîte de dialogue concernant l'accès aux outils de développement : 
Type your password to allow Developer Tools 
Access to make changes.
Le mot de passe pour l'accès aux outils de développement est demandé une seule fois par session utilisateur afin d'accorder une permission pour le débogage. Entrez le mot de passe administrateur pour le Mac (typiquement le mot de passe que vous entrez lors de la connexion au système) :
  • Si vous entrez le mot de passe correct, un message de réussite est affiché sur le Mac.
Dans ce cas, vous pouvez à présent exécuter, déboguer et déployer votre application OS X sur le Mac.
  • Si vous n'entrez pas le mot de passe correct (ou si vous appuyez sur Annuler), un message d'échec est affiché sur le Mac, suivi par :
    Vous serez invité à accéder aux outils de développement au prochain démarrage d'une session de débogage.
Dans ce cas :
  • Vous pouvez exécuter et déployer vos applications OS X pour le reste de votre session sur le Mac (mais vous ne pouvez pas encore déboguer).
  • Quand vous essayez d'exécuter avec débogage (par exemple, Exécuter ou F9), la boîte de dialogue d'accès aux outils de développement apparaît. Vous devez accéder aux outils de développement afin de déboguer votre application OS X avec l'EDI.
Remarque : Utilisation de l'option -nopermissioncheck : Pour différer l'étape Accès aux outils de développement, démarrez Platform Assistant avec l'option -nopermissioncheck :
./paserver -nopermissioncheck
Cette option retarde la nécessité d'entrer le mot de passe pour l'accès aux outils de développement jusqu'au débogage réel d'une application.
Pour de plus amples informations, voir Sur la plate-forme Mac OS X, le débogueur nécessite des permissions de fichier.
Enfin, paserver affiche le numéro du port qu'il utilise : 
Starting Platform Assistant Server on port 64211 
>
L'invite de commande > indique que Platform Assistant est en mode "écoute" et est prêt à communiquer avec son client sur le PC de développement pour l'exécution, le débogage (s'il est activé par la connexion à l'accès aux outils de développement) ou le déploiement d'une application multiplate-forme Mac OS X.
6. Lorsque vous avez terminé votre session de développement, fermez le processus Platform Assistant en tapant q (quitter) et en appuyant sur Entrée au niveau de l'invite de commande de Platform Assistant : 
> q

Win64 : Installation et exécution de Platform Assistant sur une cible Win64

L'installateur pour Win64, setup_paserver.exe, est situé dans le dossier PAServer à l'intérieur du répertoire d'installation de votre produit, par défaut : 

C:\Program Files\Embarcadero\RAD Studio\n.n\PAServer\setup_paserver.exe
  1. Copiez setup_paserver.exe dans le répertoire de votre choix sur le système Win64.
  2. Exécutez setup_paserver.exe, qui installe Platform Assistant.
    Lors de l'installation, sélectionnez ou créez un répertoire d'installation qui n'est pas situé dans C:\Program Files. Le répertoire recommandé est : C:\Users\name\AppData\Roaming\Embarcadero\PAServer.
  3. Pour exécuter Platform Assistant sur un système Win64, effectuez l'une des actions suivantes :
    • Double-cliquez sur paserver.exe dans l'explorateur Windows.
    • Ouvrez une fenêtre cmd, lancez la commande cd sur le répertoire d'installation de PAServer, entrez paserver et appuyez sur Entrée.
    paserver affiche sa bannière et son invite de mot de passe : 
Platform Assistant version 1.0.2
Copyright (c) 2009-2011 Embarcadero Technologies, Inc.

Remote Profile password <press Enter for no password>:

  1. A l'invite Remote Profile password:, choisissez l'une des actions suivantes :
    • Pour définir un mot de passe qui sera obligatoire pour être dans tout profil distant qui se connecte à ce processus paserver, entrez un mot de passe de votre choix et appuyez sur Entrée. Dans ce cas, le mot de passe doit être correctement spécifié dans le profil distant utilisé par l'application multiplate-forme.
    • Pour ne pas demander un mot de passe pour la connexion à ce processus paserver, appuyez sur Entrée. Dans ce cas, aucun mot de passe n'est requis dans le profil distant.

Paserver affiche maintenant son invite de commande (>).

Désinstallation de Platform Assistant

Si vous voulez installer une nouvelle version de Platform Assistant, vous devez au préalable désinstaller l'application Platform Assistant existante :

  • Sur Windows, utilisez Uninstall PAServer.exe pour désinstaller Platform Assistant.
  • Sur le Mac, utilisez la commande Uninstall pour désinstaller Platform Assistant.

Les programmes Uninstall sont situés dans le répertoire d'installation de Platform Assistant sur le PC et sur le Mac.

Aide paserver

Il y a deux façons d'obtenir l'aide en ligne de paserver.

Exécution de paserver et inclusion de l'option Help

Pour afficher l'aide "verbeuse", lancez paserver depuis la ligne de commande et incluez l'option -help, comme suit : 

C:\>paserver -help
Platform Assistant Server  Version 1.0.2
Copyright (c) 2009-2011 Embarcadero Technologies, Inc.
Usage: paserver [options>]

<options> :
 -port=<nnnnn>        Spécifier le numéro du port, default=64211
 -scratchdir=<dir>    Spécifier le répertoire parent pour les fichiers temporaires client
 -libextension=<cmd>  Spécifier les extensions de bibliothèques dynamiques, default=,dylib, h
 -tarcommand=<cmd>    Spécifier le chemin pour le binaire tar, default=/usr/bin/tar
 -debuglauncher=<app> Spécifier l'application lanceur du débogueur
 -nopermissioncheck   Ne pas essayer d'acquérir la permission du support du débogage
 -unrestricted        Permettre l'opération de placement et de retrait des fichiers en dehors du
                      répertoire des fichiers temporaires client, default n'est pas autorisé
 -password=<text>     Spécifier le mot de passe de connexion du profil distant, par défaut
                      demander le mot de passe de la connexion
 -passfile=<file>     Spécifier le fichier de passe de connexion du profil distant, par défaut 
                      demander le mot de passe de la connexion
 -config=<file>       Spécifier les paramètres par défaut
 -help                Imprimer cet écran d'aide

Affichage de l'aide pendant l'exécution de paserver

Dès que paserver s'exécute sur la plate-forme cible, vous pouvez entrer h à l'invite de commande pour afficher l'aide pour les cinq commandes auxquelles un processus paserver peut répondre (pour faire autre chose que celles-ci, vous devez quitter et redémarrer). Par exemple : 

> h
q - arrêter le serveur
c - imprimer tous les clients
p - imprimer le numéro du port
s - imprimer le répertoire de travail
g - générer le fichier de passe de connexion
>

Remarques :

  • Le répertoire de travail est utilisé par Platform Assistant pour les opérations sur les fichiers temporaires, notamment les fichiers projet et les profils distants.
  • Le fichier .passfile est un fichier de mot de passe qui contient un mot de passe encrypté pour Platform Assistant. Vous pouvez partager ce fichier avec toute personne ayant besoin d'utiliser la connexion, sans compromettre la confidentialité du mot de passe.

Définition des options pour paserver

Les valeurs par défaut pour le port, le mot de passe et le répertoire de travail sont :

  • Numéro du port : 64211
  • Aucun mot de passe n'est requis
  • Le répertoire de travail est situé à l'intérieur du répertoire d'installation PAServer
    • Le dossier scratch-dir contient votre profil distant, les dossiers du projet et les fichiers associés.

Vous pouvez définir les paramètres port, mot de passe et répertoire de travail dans votre commande d'exécution de paserver ou dans le fichier paserver.config. Vous pouvez spécifier un autre fichier config pour paserver en utilisant l'option -config. Vous pouvez aussi créer un fichier de mot de passe encrypté (.passfile) afin qu'une autre personne puisse se connecter à paserver sans connaître le mot de passe que vous avez défini pour lui.

La valeur d'une option est déterminée comme suit :

  1. Option de commande : La valeur d'option spécifiée dans votre commande d'exécution de paserver a la priorité.
  2. Fichier config : La valeur d'option spécifiée dans le fichier paserver.config est utilisée si aucune valeur d'option n'est spécifiée dans la commande paserver.
  3. Valeur par défaut : Si aucune des deux premières valeurs d'option n'existe, la valeur par défaut intégrée pour l'option est utilisée.

Définition du numéro de port

Incluez l'option -port dans votre commande pour démarrer paserver. Par exemple, pour spécifier un port autre que la valeur par défaut 64211 :

Windows : 

> paserver -port=nnnnn

Mac : 

> ./paserver -port=nnnnn

Le numéro de port doit être compris entre 1 et 65 535.

Définition du mot de passe

Quand vous démarrez Platform Assistant, vous pouvez facultativement spécifier un mot de passe qui sera requis dans tout profil distant qui essaie d'établir une connexion à ce processus paserver.

Platform Assistant affiche l'invite de mot de passe suivant : 

Remote Profile password <press Enter for no password>:

Voici vos choix :

  • Spécifier un mot de passe si vous voulez que le processus paserver requiert ce mot de passe particulier depuis chaque profil distant avant de permettre la connexion.
  • Appuyer sur Entrée au niveau de l'invite si vous ne voulez pas qu'un mot de passe soit demandé depuis chaque profil distant.
  • Vous pouvez définir alternativement le mot de passe de paserver en ajoutant l'option -password à votre commande pour démarrer Platform Assistant, comme suit : 
paserver -password=B2C3d4!

Génération et utilisation d'un fichier .passfile

Vous pouvez créer un fichier de mot de passe encrypté (.passfile), situé dans le répertoire d'installation PAServer. Si vous démarrez paserver avec l'option .passfile, paserver nécessite un profil distant pour contenir le mot de passe encrypté dans le fichier .passfile. Vous pouvez partager le fichier de mot de passe encrypté avec d'autres utilisateurs afin qu'ils puissent se connecter à votre serveur paserver en utilisant un profil distant qui partage le fichier .passfile.

Génération d'un fichier .passfile

Lors de l'exécution de paserver, vous pouvez générer un fichier .passfile qui encrypte le mot de passe spécifié au démarrage de paserver :

  1. Démarrez paserver :
    • Windows :C:\rép\PAServer > paserver
    • Mac :PAServer username$ ./ paserver
  2. A l'invite mot de passe :, entrez le mot de passe de votre choix et appuyez sur Entrée.
  3. A l'invite paserver, entrez l'option g (générer un fichier .passfile de connexion) :
    > g
    paserver affiche un message de confirmation, tel que :
    répertoire\PAServer\paserver.passfile généré

Afin d'établir la connexion à ce processus paserver, un profil distant doit contenir le nom de ce fichier .passfile dans le champ Mot de passe.

Démarrage de paserver avec un fichier .passfile

Démarrez paserver et incluez l'option passfile, comme suit :

Windows : > paserver -passfile=nom-de-fichier

Mac : paserver nom-utilisateur$ ./ paserver -passfile=nom-de-fichier


Afin d'établir la connexion à ce paserver, un profil distant doit contenir le nom de ce fichier .passfile dans le champ Mot de passe.

Spécification d'un fichier .passfile dans un profil distant

Afin d'établir la connexion à un paserver ayant démarré avec une option -passfile, un profil distant doit contenir le nom du fichier .passfile dans le champ Mot de passe.

  1. Allez sur Outils > Options > Options d'environnement > Profils distants.
  2. Sur la boîte de dialogue Profils distants, sélectionnez le profil distant qui utilisera le fichier .passfile.
  3. Cliquez sur les points de suspension [...] dans le champ Mot de passe.
  4. Naviguez vers le fichier .passfile sur la plate-forme cible. Le répertoire contenant le fichier .passfile doit être partagé sur le réseau.

Gestion du répertoire de travail

Platform Assistant a un répertoire de travail configurable qui est utilisé pour la sortie du fichier exécutable lors du développement de l'application.

Le répertoire scratch-dir est situé par défaut à l'intérieur du répertoire où vous avez installé Platform Assistant (paserver.exe) sur la plate-forme cible. A l'intérieur du répertoire de travail, Platform Assistant enregistre les fichiers de sortie du projet dans des dossiers spécifiques dont les noms incluent votre nom d'utilisateur et le profil distant en cours d'utilisation :

PAServer\scratch-dir\nomutilisateur-nomprofil

Par exemple, sur OS X, vos fichiers exécutables compilés (comme NomProjet) sont enregistrés dans un répertoire tel que : 

Applications \ Embarcadero \ PAServer \ scratch-dir \ MyUserName-MyOSXRemoteProfile

Le répertoire de travail contient aussi les fichiers supplémentaires qui sont requis afin d'exécuter votre application. Par exemple, le répertoire de travail sur OS X inclut les fichiers dylib, un dossier Contenu contenant le fichier Info.plist et peut-être un dossier Ressources pour les fichiers de ressources tels que les fichiers .icns (icône).

Spécification d'un autre répertoire de travail

Pour définir explicitement l'emplacement du répertoire de travail, effectuez l'une des opérations suivantes :

  • Utilisez l'option -scratchdir dans votre commande de démarrage de paserver.
  • Editez le fichier paserver.config sur la plate-forme cible. Pour obtenir des détails, voir #Fichier paserver.config.

L'option -scratchdir contrôle seulement les projets que vous exécutez avec le processus paserver que vous démarrez avec l'option -scratchdir ; elle ne change pas le répertoire de travail de façon permanente.

Par exemple, pour démarrer Platform Assistant et spécifier un répertoire nommé TestDir en tant que répertoire de travail. Voici les lignes de commande à utiliser (sur des plates-formes cible spécifiques) :

Sur Windows : > paserver -scratchdir=TestDir

Sur Mac : paserver username$ ./ paserver -scratchdir=TestDir

Le processus paserver qui est démarré avec cette commande enregistre les exécutables dans un répertoire nommé TestDir, situé dans le répertoire d'installation de PAServer, auprès du répertoire scratch-dir existant.

Sur Mac OS X, vous pouvez spécifier un autre répertoire de travail en relation à votre répertoire utilisateur en faisant précéder le nom du répertoire par un tilde-tiret (~/) quand vous démarrez paserver : 

> ./paserver -scratchdir=~/MyTestDir

Cette commande enregistre les exécutables sur le Mac dans le répertoire /Users/myusername/MyTestDir.

Permettre les opérations sur les fichiers en dehors du répertoire de travail

Attention : L'utilisation du mode -unrestricted avec paserver n'est pas recommandée.

Par défaut, paserver opère en mode restreint. C'est-à-dire que Platform Assistant effectue des opérations sur les fichiers (placer et retirer) seulement à l'intérieur du répertoire de travail pour votre profil distant (situé à l'intérieur du répertoire d'installation de PAServer). Dans le mode par défaut (restreint), paclient.exe et le Gestionnaire de déploiement peuvent ajouter ou supprimer des fichiers à l'intérieur du répertoire de travail de paserver.

Toutefois, si vous spécifiez -unrestricted dans votre commande de démarrage de paserver, Platform Assistant permet les opérations sur les fichiers en dehors du répertoire de travail de paserver.

Fichier paserver.config

Platform Assistant a un fichier de configuration installé dans le même répertoire. Le fichier paserver.config peut contenir les paramètres acceptés par paserver (voir Exécution de paserver et inclusion de l'option Help).

Par défaut, le fichier paserver.config contient seulement les deux commandes suivantes, mais vous pouvez modifier ces commandes et ajouter d'autres commandes paserver (telles que passfile, password et unrestricted) : 

port=64211
scratchdir=

Ces deux commandes définissent les éléments suivants :

  • Le port de communication (la valeur par défaut est 64211)
  • Le répertoire de travail (utilisé pour les opérations paserver sur les fichiers)
Le répertoire de travail par défaut est nommé scratch-dir et il est situé à l'intérieur du répertoire où paserver.exe est installé. Un dossier distinct est créé pour chaque profil distant. Par exemple, le répertoire de travail par défaut pour le profil distant MyOSX est : nomutilisateur-MyOSX.
Remarque : L'utilisation des valeurs par défaut est vivement recommandée. Toutefois, si vous voulez assigner différentes valeurs pour le port et le répertoire de travail, vous pouvez le faire des deux façons suivantes :
  • Editez le fichier paserver.config :
    • Remplacez le numéro du port (64211 est la valeur par défaut) par le numéro du port que vous voulez utiliser.
    • Ajoutez le nom du répertoire de travail sans les guillemets. Par exemple :
    scratchdir=Test_dir_3
  • Spécifiez les options de ligne de commande quand vous démarrez paserver. Pour un exemple, voir Spécification d'un autre répertoire de travail.

Problèmes de connexion

  • Pour tester la connexion entre votre système de développement et la plate-forme cible, utilisez le bouton Tester la connexion sur la page Profils distants de la boîte de dialogue Outils -> Options.
  • Si vous recevez un message d'erreur "Connexion refusée" associé à la non concordance de la version du serveur Platform Assistant, mettez à jour votre installation paserver sur la plate-forme cible avec le numéro de version spécifié dans le message d'erreur. Quand vous exécutez PAServer sur la plate-forme cible, son numéro de version est affiché dans sa bannière.
  • Pour obtenir des informations sur le message "Acquérir la permission pour supporter le débogage" et sur les problèmes lors d'une tentative de débogage d'une application Mac OS X, voir "Le débogueur nécessite des permissions de fichier sur la plate-forme Mac OS X" dans Débogage des applications multiplates-formes.
  • Pour obtenir des informations sur un message du Pare-feu Windows lors d'une tentative de connexion à un système Win64, voir Connexion de votre PC à un PC Win64.

Voir aussi

Récupérée de « http://docwiki.embarcadero.com/RADStudio/XE2/f/index.php?title=Installation_et_ex%C3%A9cution_de_Platform_Assistant_sur_la_plate-forme_cible&oldid=114453 »
Versions précédentes
Autres langues