Ausführen des Platform Assistant auf dem Mac

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu PAServer: Die Platform Assistant Server-Anwendung

Nach oben zu Hilfe-Experten für mobile iOS-Anwendungen

Den "Platform Assistant" können Sie auf dem Mac auf eine der beiden folgenden Weisen starten:

Hinweis:
  • Im Finder können Sie Optionen in einer .config-Datei festlegen.
  • Im Terminal-Fenster können Sie den "Platform Assistant" mit angepassten Optionen starten.

Unter Festlegen von Optionen für den Platform Assistant finden Sie Informationen zum Festlegen von Optionen für PAServer.

Ausführen von "Platform Assistant" im Finder

Aktivieren Sie auf dem Mac im Finder die .app-Datei (PAServer-23.0.app) wie folgt:

  1. Navigieren Sie zum obersten Applications-Ordner.
    Tipp:
  2. Doppelklicken Sie auf PAServer-23.0.app, um den "Platform Assistant" zu starten.
    PAServer22.0 Finder MacOS.png

    Informationen zu PAServer Manager finden Sie unter Ausführen von PAServer Manager auf dem Mac.
    Das Terminal-Fenster wird mit dem "Platform Assistant"-Banner und der Passworteingabeaufforderung angezeigt:
    Verbindungsprofil-Passwort <Eingabetaste für kein Passwort>:
    MyMac:~ myname$ /Applications/PAServer-16.0.app/Contents/MacOS/paserver ; exit; Platform Assistant Server Version 7.0.1.40 Copyright (c) 2009-2015 Embarcadero Technologies, Inc. Connection Profile password <press Enter for no password>: Acquiring permission to support debugging...succeeded Starting Platform Assistant Server on port 64211 Type ? for available commands >
Tipp: Um die ausführbare Datei paserver im Finder anzuzeigen, klicken Sie mit der rechten Maustaste auf die Datei PAServer 23.0.app und wählen Paketinhalt anzeigen aus. Dadurch werden die Verzeichnisse Contents und MacOS im Finder angezeigt. Im Terminal-Fenster werden diese Verzeichnisse immer angezeigt. Die ausführbare Datei paserver befindet sich im Verzeichnis "MacOS":
Applications/PAServer-23.0.app/Contents/MacOS/paserver

Ausführen von paserver in einem Terminal-Fenster

Die Datei paserver ist die ausführbare Befehlszeilendatei für den "Platform Assistant", und der Pfad zu paserver lautet:

 Applications yourname $ /Applications/PAServer-23.0.app/Contents/MacOS/paserver 

Das heißt, dass sich die ausführbare Datei paserver im Paket PAServer-23.0.app im Ordner Contents/MacOS befindet. Sie können die ausführbare paserver-Datei direkt im Terminal-Fenster ausführen.

Die folgende Anleitung zeigt zwei grundlegende Möglichkeiten zum Starten von paserver von der Befehlszeile aus: Durch Eingabe einer einzigen Befehlszeile im Ordner "Applications" oder durch Navigieren zum Ordner "MacOS". Bei dieser Methode haben Sie die Möglichkeit, die Dateieigenschaften im Verzeichnis PAServer-23.0.app/Contents/MacOS, einschließlich von paserver, zu überprüfen.

Beispiel: Eingeben einer einzelnen Befehlszeile im Ordner "Applications"

Im Mac-Terminal-Fenster können Sie mit einem einzigen Befehl den Inhalt der Datei PAServer-23.0.app durchsuchen und paserver starten:

  1. Öffnen Sie auf dem Mac ein Terminal-Fenster, und wechseln Sie mit cd zum obersten "Applications"-Ordner.
    Geben Sie beispielsweise den oder die Anfangsbuchstaben des "Applications"-Ordners ein, und drücken Sie dann die Taste TAB. Wenn ein Verzeichnis und nur ein Verzeichnis vorhanden ist, dessen Name mit den eingegebenen Buchstaben beginnt, wird der Verzeichnisname angezeigt:
    IhrName $ cd /A <TAB>
    IhrName $ cd /Applications <EINGABE>
    Applications IhrName $
    • Geben Sie einen "cd"-Befehl mit den Anfangsbuchstaben der aufeinanderfolgenden Teile des Pfades ein, und drücken Sie nach jeder Eingabe die Taste TAB, um den Teil zu vervollständigen.
    Die komplette Befehlszeile für den Pfad sollte ungefähr wie folgt aussehen:
    Applications IhrName $ /Applications/PAServer\ &23.0.app/Contents/MacOS/paserver
  2. Drücken Sie die EINGABE-Taste.

Beispiel: Navigieren zum Installationsverzeichnis von paserver (MacOS-Ordner)

Sie müssen zu folgendem PAServer-Verzeichnis navigieren:

 mymac:~ myname$ cd Applications
 mymac:Applications myname$ cd PAServer 16.0
 mymac:PAServer 16.0 myname$

Im Mac-Terminal-Fenster können Sie mit einer Reihe von cd-Befehlen den Inhalt der Datei PAServer-23.0.app durchsuchen und paserver starten:

  1. Verwenden Sie cd-Befehle und die TAB-Taste. Um beispielsweise den Ordner "Applications" (vom Benutzerverzeichnis auf dem Mac aus) zu starten, geben Sie Folgendes ein:
    IhrName $ cd /A <TAB> <EINGABE>
  2. Zeigen Sie den Inhalt des "Applications"-Ordners durch folgende Eingabe an:
    Applications IhrName $ ls
    Im "Applications"-Verzeichnis sollte PAServer-23.0.app angezeigt werden.
  3. Navigieren Sie durch das PAServer 23.0-Paket, indem Sie die Anfangsbuchstaben jedes Ordners eingeben und die Taste TAB drücken:
    Applications IhrName $ cd PAS <TAB>
    Con <TAB>
    Mac <TAB>
    pas <TAB>
    Nun sollte die folgende Befehlszeile angezeigt werden:
    Applications IhrName $ /Applications/PAServer\ <Version>.app/Contents/MacOS/paserver
  4. Drücken Sie die EINGABE-Taste, um den Befehl auszuführen.
  5. Im MacOS-Verzeichnis wird "paserver" angezeigt. Geben Sie folgenden Befehl ein:
    MacOS IhrName $ ./paserver.
    Hinweis: Auf dem Mac müssen Sie jedem Ausführen-Befehl die Zeichen ./ voranstellen.
  6. Drücken Sie die EINGABE-Taste.

Beispiel: Festlegen der Port-Nummer beim Starten von PAServer von der Befehlszeile

Sie können mehrere Instanzen von PAServer ausführen, solange jeder Server eine eindeutige Port-Nummer verwendet.

Fügen Sie die Befehlszeilenoption -port hinzu, wenn Sie PAServer ausführen:

MacOS IhrName $ ./paserver -port=64444

Weitere Informationen finden Sie unter Festlegen von Optionen für den Platform Assistant.

Anmelden beim Platform Assistant

Nach dem Start von paserver zeigt der "Platform Assistant" ein Banner und dann die Passworteingabeaufforderung an:

 Connection Profile password <press Enter for no password>: 
  1. Bei der Passworteingabeaufforderung haben Sie folgende Möglichkeiten:
    • Geben Sie ein Passwort Ihrer Wahl ein, und drücken Sie die EINGABE-Taste. Für die Verbindung zu diesem "Platform Assistant" ist dann dieses Passwort erforderlich.
    • Wenn Sie kein Passwort für die Verbindung zu diesem "Platform Assistant" festlegen möchten, drücken Sie die EINGABE-Taste.
  2. Wird der "Platform Assistant" während einer Sitzung auf dem Mac zum ersten Mal gestartet, wird das Dialogfeld Developer Tools Access angezeigt:
    TakeControl.png
    • Geben Sie das Passwort für den Mac ein, und klicken Sie auf Take Control (Steuerung übernehmen), um das Debuggen mit dem "Platform Assistant" zuzulassen. Dieses Passwort ist dasselbe, das Sie eingeben, wenn Sie sich beim System anmelden; Administratorzugriff ist erforderlich.
      Sie können die Anmeldung entweder mit dem in diesem Dialogfeld angezeigten Benutzernamen fortsetzen oder einen anderen Benutzernamen eingeben.
    • Erneuter Versuch: Wenn Sie nicht das richtige Passwort eingeben oder den Vorgang abbrechen, startet der "Platform Assistant" normal, aber beim nächsten Versuch, eine Anwendung von RAD Studio aus mit dem "Platform Assistant" zu debuggen, werden Sie wieder zur Eingabe des Administratorpassworts aufgefordert.
      Siehe Übernahme der Berechtigung zur Debugging-Unterstützung auf einem Mac.

Nach Ausführung dieser Schritte werden im Terminal-Fenster die beiden folgenden Zeilen angezeigt:


Starting Platform Assistant Server on port 64211 
>

Die Eingabeaufforderung > gibt an, dass sich der Platform Assistant im Empfangsmodus für den angegebenen Port (standardmäßig Port 64211) befindet. Geben Sie den Befehl h ein (geben Sie "h" ein, und drücken Sie die EINGABE-Taste), um die Liste der verfügbaren Befehle zusammen mit einer Beschreibung anzuzeigen. Geben Sie den Befehl q ein, um den "Platform Assistant" zu beenden.

Verbindungsprobleme

Ausführen von PAServer bei aktivierter Mac-Firewall

Wenn auf dem Mac die Firewall aktiviert ist, wird beim Start von PAServer auf dem Mac nach "Berechtigung zur Debugging-Unterstützung wird übernommen" folgende Meldung angezeigt:

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

Auch wenn Sie hier auf "Allow" (Zulassen) klicken, kann PAServer keine Verbindung von Ihrem Entwicklungssystem zu dem Mac herstellen. Sie müssen PAServer ausdrücklich die Verwendung einer der folgenden Lösungen einräumen:

Lösung 1: Deaktivieren der Firewall auf dem Mac. Gehen Sie dazu folgendermaßen vor:

  1. Öffnen Sie auf dem Mac im Apple-Menü Systemeinstellungen.
  2. Wählen Sie Sicherheit und dann die Registerkarte Firewall.
  3. Klicken Sie auf das Schloss-Symbol in der linken unteren Ecke.
  4. Klicken Sie auf die Schaltfläche Stopp.
  5. Klicken Sie auf das Schloss-Symbol, und schließen Sie das Fenster Sicherheit.

Lösung 2: Zulassen, dass PAServer durch die Firewall auf den Mac zugreift. Gehen Sie dazu folgendermaßen vor:

  1. Öffnen Sie auf dem Mac im Apple-Menü Systemeinstellungen.
  2. Wählen Sie Sicherheit und dann die Registerkarte Firewall.
  3. Klicken Sie auf Firewall. (Wenn diese Schaltfläche deaktiviert ist, klicken Sie auf das Schloss-Symbol in der linken, unteren Ecke.)
  4. Klicken Sie auf das Plus-Zeichen (+), und navigieren Sie zum Applications-Ordner.
  5. Wählen Sie PAServer-23.0.app, und klicken Sie dann auf Hinzufügen. Dadurch wird PAServer <Version>.app den in den FireWall-Optionen aufgeführten Apps hinzugefügt.
  6. So fügen Sie die binäre paserver-Datei hinzu:
    1. Klicken Sie auf das Pluszeichen (+).
    2. Drücken Sie die Tasten BEFEHL-UMSCHALT-G.
    3. Geben Sie in Gehe zum Ordner: den vollständigen Pfad zu paserver ein. Zum Beispiel:
      /Applications/PAServer <Version>.app/Contents/MacOS
    4. Der Inhalt des MacOS-Verzeichnisses wird angezeigt. Suchen Sie paserver, und doppelklicken Sie darauf. Damit wird die binäre paserver-Datei den Apps in den FireWall-Optionen hinzugefügt.
  7. Klicken Sie auf das Schloss-Symbol, und schließen Sie das Fenster Sicherheit.

Siehe auch Ausführen des Platform Assistant auf dem Mac.

Herstellen einer Verbindung zu einem PAServer, wenn der Port verwendet wird

Möglicherweise wird der folgende Fehler angezeigt, wenn Sie versuchen, PAServer auf dem Mac auszuführen und der Socket verwendet wird (vielleicht von einer Instanz von PAServer, die bereits ausgeführt wird oder auf die nicht mehr zugegriffen werden kann):

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

Führen Sie zur Lösung dieses Problems einen der folgenden Schritte aus:

  • Verwenden der vorhandenen Instanz von PAServer.
  • Anhalten der vorhandenen Instanz von PAServer.
  • Beenden der vorhandenen Instanz von PAServer wie folgt:
    1. Geben Sie im Terminalfenster ps -a ein.
    2. Suchen Sie die Instanz von PAServer und deren PID-Nummer.
    3. Geben Sie folgenden Befehl ein: kill <pid>.

Voraussetzungen

M1-Debuggen

PAServer funktioniert auf M1 Mac-Hardware. Allerdings gibt es Probleme beim Debuggen für das iOS/64-Ziel auf einem M1-Gerät.

Für das M1-ARM-Debuggen wird ein anderer Debugger verwendet als für das Intel-Debuggen. Der Evaluator dieses Debuggers unterstützt keine Delphi-Syntax. Die Auswertung, z. B. im Dialogfeld "Auswerten/Ändern", überwachte Ausdrücke usw., muss in C++-Syntax erfolgen. Das bedeutet, dass doppelte Anführungszeichen für Strings verwendet und Ausdrücke unter Berücksichtigung der Groß- und Kleinschreibung geschrieben werden müssen.

LLDB erfordert Python

PAServer verwendet LLDB auf macOS 64 Bit (ARM), wofür Python 3.9 erforderlich ist.

Wenn Sie eine Debug-Sitzung auf Big Sur starten und ein Fehler in der IDE angezeigt wird,

Fehler: LLDB-Kernel kann nicht gestartet werden

müssen Sie Python auf Ihrem Computer ausführen. Verwenden Sie zur Konfiguration die Version von Xcode. Öffnen Sie das Terminal und führen Sie die folgenden Befehle aus:

  • cd /Applications/PAServer-22.0.app/Contents/MacOS/lldb/lib/python3.9
  • sudo rm Python
  • sudo ln -s <Xcode.app-location>/Contents/Developer/Library/Frameworks/Python3.framework/Versions/<version>/Python<version> Python

Wenn <Xcode.app-location> nicht in /Applications/Xcode.app installiert ist, müssen Sie PYTHONHOME auf den Speicherort festlegen, an dem sich die Xcode-Version von Python befindet, bevor Sie PAServer aufrufen.

Zum Beispiel:

  • Öffnen Sie das Terminal.
  • Exportieren Sie PYTHONHOME="/Applications/Xcode 12.2.app/Contents/Developer/Library/Frameworks/Python3.framework/Versions/3.8.
  • Öffnen Sie /Applications/PAServer-22.0.app.
Hinweis: Wenn Sie Python früher über HomeBrew installiert haben und es nicht mehr verwenden, können Sie es mit dem folgenden Befehl entfernen: brew uninstall python3

Verwenden von Xcode Beta

Die Verwendung von Xcode Beta wird nicht unterstützt. Mithilfe der folgenden Anweisungen können Sie es jedoch verwenden.

  • Passen Sie den Python-Pfad an. Benennen Sie die Xcode-beta.app um und verschieben Sie sie zur Standard-/Application/Xcode.app.
  • Wenn Sie Xcode Beta weiterhin wie gewohnt installiert behalten möchten, aktualisieren Sie den Python-Alias im LLDB-Ordner :
    • cd /Application/PAServer-22.0/Contents/MacOS/lldb/lib/python3.9
    • sudo rm Python
    • sudo ln -s `xcode-select -p`/Library/Frameworks/Python3.framework/Versions/3.8/Python3 Python
  • Legen Sie anschließend die Umgebungsvariable PYTHONHOME fest.
  • Exportieren Sie PYTHONHOME=`xcode-select -p`/Library/Frameworks/Python3.framework/Versions/3.8.
  • Öffnen Sie /Applications/PAServer-22.0.app.

Weiter

Siehe auch