Ausführen des Platform Assistant auf dem Mac
Nach oben zu PAServer: Die Platform Assistant Server-Anwendung
Nach oben zu Hilfe-Experten für mobile iOS-Anwendungen
Inhaltsverzeichnis
Den "Platform Assistant" können Sie auf dem Mac auf eine der beiden folgenden Weisen starten:
- Doppelklicken Sie im Finder auf PAServer-23.0.app (grafisch).
- Führen Sie die ausführbare Datei paserver im Terminal-Fenster (Befehlszeile) aus.
-
- 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:
- Navigieren Sie zum obersten Applications-Ordner.
- Tipp:
- Wenn Sie ein anderes Installationsziel verwendet haben, wählen Sie das entsprechende Laufwerk aus, bevor Sie zum obersten Anwendungsordner wechseln.
- Ein Beispiel finden Sie unter Beispiel: Navigieren zum Installationsverzeichnis von paserver (MacOS-Ordner)
- Doppelklicken Sie auf PAServer-23.0.app, um den "Platform Assistant" zu starten.
- 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>:
- Die Reaktion auf die Eingabeaufforderung ist unter Anmelden beim Platform Assistant beschrieben.
- Als Nächstes werden Sie nach Ihrem Passwort gefragt, um das Debuggen von Apps auf dem Mac zuzulassen.
Nachdem Sie die Berechtigung zum Debugging auf dem Mac erworben haben, sollte das Terminal-Fenster wie folgt aussehen:
- 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:
- Ö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
- Drücken Sie die EINGABE-Taste.
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:
- 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>
- Zeigen Sie den Inhalt des "Applications"-Ordners durch folgende Eingabe an:
Applications IhrName $ ls
- Im "Applications"-Verzeichnis sollte PAServer-23.0.app angezeigt werden.
- 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
- Drücken Sie die EINGABE-Taste, um den Befehl auszuführen.
- 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.
- 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>:
- 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.
- Wird der "Platform Assistant" während einer Sitzung auf dem Mac zum ersten Mal gestartet, wird das Dialogfeld Developer Tools Access angezeigt:
- 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.
- 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.
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:
- Öffnen Sie auf dem Mac im Apple-Menü Systemeinstellungen.
- Wählen Sie Sicherheit und dann die Registerkarte Firewall.
- Klicken Sie auf das Schloss-Symbol in der linken unteren Ecke.
- Klicken Sie auf die Schaltfläche Stopp.
- 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:
- Öffnen Sie auf dem Mac im Apple-Menü Systemeinstellungen.
- Wählen Sie Sicherheit und dann die Registerkarte Firewall.
- Klicken Sie auf Firewall. (Wenn diese Schaltfläche deaktiviert ist, klicken Sie auf das Schloss-Symbol in der linken, unteren Ecke.)
- Klicken Sie auf das Plus-Zeichen (+), und navigieren Sie zum Applications-Ordner.
- 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.
- So fügen Sie die binäre paserver-Datei hinzu:
- Klicken Sie auf das Pluszeichen (+).
- Drücken Sie die Tasten
BEFEHL-UMSCHALT-G
. - Geben Sie in Gehe zum Ordner: den vollständigen Pfad zu paserver ein. Zum Beispiel:
/Applications/PAServer <Version>.app/Contents/MacOS
- 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.
- 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:
- Geben Sie im Terminalfenster
ps -a
ein. - Suchen Sie die Instanz von PAServer und deren PID-Nummer.
- Geben Sie folgenden Befehl ein:
kill <pid>
.
- Geben Sie im Terminalfenster
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
.
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
- Mobile-Tutorial: Konfigurieren der Entwicklungsumgebung auf dem Mac (iOS)
- Installieren des Platform Assistant auf dem Mac
- Ausführen des Platform Assistant unter Windows
- Ausführen von iOS-Anwendungen auf einem iOS-Gerät
- Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC
- Ausführen von PAServer Manager auf dem Mac