Erstellen einer macOS-Konsolenanwendung Hello World

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu MacOS-Anwendungsentwicklung


In diesem Tutorial werden die grundlegenden Schritte zum Erstellen einer geräteübergreifenden "Hello World"-Anwendung in Delphi gezeigt. Diese Anwendung ist für die macOS-Plattform (den Mac) vorgesehen und enthält ein Konsolenfenster sowie ein Ereignis, und zeigt als Reaktion auf eine Benutzeraktion ein Dialogfeld an.

Voraussetzungen

Siehe Konfigurieren der Entwicklungsumgebung für macOS.

Schritte

So erstellen Sie die macOS-Konsolenanwendung "Hello world":

Verbinden Ihres PC mit einem Mac

Siehe Arbeiten mit einem Mac und einem PC.

Ausführen von "Platform Assistant" auf dem macOS-Ziel

  1. Der Platform Assistant muss auf dem Entwicklungs-PC und dem Ziel-Mac ausgeführt werden:
    • Wenn der Platform Assistant bereits auf dem PC und dem Mac installiert ist, fahren Sie mit dem nächsten Schritt fort.
    • Wenn der Platform Assistant noch nicht auf dem PC oder dem Mac installiert ist, installieren Sie den Platform Assistant auf der Zielplattform. Folgendermaßen wird das Installationsprogramm auf dem PC oder dem Mac ausgeführt:
    Hinweis: PAClient.exe: Die Client-Anwendung von Platform Assistant wird auf dem Entwicklungssystem bei der Installation von RAD Studio installiert.
  2. Öffnen Sie auf dem Mac ein Terminalfenster.
  3. Wechseln Sie zu dem Verzeichnis (cd), das den Platform Assistant (PAServer) enthält.
  4. Führen Sie den Platform Assistant mit dem folgenden Befehl aus:
    ./paserver
  5. Wenn Sie zur Eingabe eines Passworts aufgefordert werden, geben Sie ein optionales Passwort ein. Dabei handelt es sich um das Passwort, das jedes Verbindungsprofil benötigt, das eine Verbindung mit dieser Instanz des Platform Assistant herstellt. Wenn Sie kein Passwort festlegen möchten, drücken Sie die Taste EINGABE.
Der Platform Assistant zeigt eine Anmeldemeldung und die Eingabeaufforderung (>) an.

Erstellen eines Verbindungsprofils für den Platform Assistant-Server

  1. Wählen Sie Tools > Optionen > Umgebungsoptionen > Verbindungsprofil-Manager aus.
  2. Klicken Sie auf Hinzufügen. Der Experte Verbindungsprofil erstellen wird geöffnet.
  3. Legen Sie auf der ersten Seite des Experten (Profilinformation) folgende Einstellungen fest:
    • Geben Sie in Profilname einen Namen für das Verbindungsprofil ein.
    • Wählen Sie in der Dropdown-Liste Plattform die Zielplattform aus, auf der der Platform Assistant-Server ausgeführt wird, in diesem Fall macOS 64 Bit (Intel) oder macOS 64 Bit (ARM).
    • Klicken Sie auf Weiter.
  4. Legen Sie auf der zweiten Seite des Experten (Informationen zum Remote-Computer) folgende Einstellungen fest:
    • Geben Sie in das Feld Remote-Computer (IP-Adresse oder Name des Computers) den Namen oder die IP-Adresse des Remote-Computers (Mac) ein.
      • Geben Sie zum Ermitteln der IP-Adresse des Remote-Computers einen der folgenden Befehle ein:
        • i in der PAServer-Konsole auf der Mac.
        • ifconfig im Mac-Terminal-Fenster.
    • Belassen Sie für die Port-Nummer die Vorgabe 64211.
    • Geben Sie in das Feld Passwort ein optionales Passwort ein, das Sie beim Starten des Platform Assistant festgelegt haben, mit dem Sie eine Verbindung herstellen. Um nach einer Passwortdatei (*.passfile, die mit Paserver erstellt wurde und ein verschlüsseltes Passwort zur gemeinsamen Nutzung mit anderen Benutzern enthält) zu suchen, klicken Sie auf die Ellipsen-Schaltfläche (...). Lassen Sie dieses Feld leer, wenn für den Platform Assistant kein Passwort festgelegt wurde.
    • Klicken Sie auf Verbindung testen.
      • Wenn die Verbindung fehlschlägt, überprüfen Sie den Namen des Zielcomputers oder die IP-Adresse (mit "ping" im cmd-Fenster) und ob der Platform Assistant auf dem Zielcomputer installiert ist und auf dem Zielcomputer ausgeführt wird.
      • Klicken Sie auf Weiter, wenn die Verbindung hergestellt (oder nicht hergestellt) werden konnte.
    Hinweis: Sie können ein Verbindungsprofil erstellen, auch wenn die Verbindung zu dem Ziel noch nicht erfolgreich hergestellt werden konnte. Ein gültiges Verbindungsprofil ist jedoch zu verschiedenen kritischen Zeitpunkten während der macOS-Anwendungsentwicklung erforderlich, und zwar beim Ausführen, Debuggen und Bereitstellen.
  5. Klicken Sie auf OK, um die Seite Verbindungsprofil-Manager zu schließen.

Hinzufügen eines SDK für das macOS-Ziel

  1. Wählen Sie Tools > Optionen > Umgebungsoptionen > SDK-Manager aus.
  2. Klicken Sie auf Hinzufügen. Das Dialogfeld Neues SDK hinzufügen wird geöffnet.
  3. Wählen Sie in der Dropdown-Liste Plattform auswählen die Zielplattform aus, in diesem Fall macOS 64 Bit (Intel) oder macOS 64 Bit (ARM).
  4. Wählen Sie in Profil für Verbindung auswählen das zuvor erstellte Verbindungsprofil aus.
  5. Wählen Sie in SDK-Version auswählen "Command Line Tools" aus.
    Das "Command Line Tools"-SDK stellt die grundlegenden Header und Bibliotheken zum Erzeugen von macOS-Anwendungen bereit, die für die "Hello World"-Anwendung ausreichen. Jedes andere SDK aus der Liste wäre auch ausreichend, da alle die Bibliotheken aus dem "Command Line Tools-"SDK enthalten.
    Hinweis: Die Liste der verfügbaren SDKs wird von Ihrem macOS-System über das im vorherigen Schritt ausgewählte Verbindungsprofil ermittelt. Wenn die Liste des Kombinationsfelds leer ist oder ein bestimmtes SDK fehlt, finden Sie unter Hinzufügen eines macOS- oder iOS-SDK Hinweise zur Fehlerbehebung.
  6. Klicken Sie auf OK, um die Seite SDK-Manager zu schließen.

Die Dateien (Header und Bibliotheken) des angegebenen SDK werden vom Mac auf den Entwicklungs-PC kopiert. Zum Einbeziehen weiterer Bibliotheken oder Frameworks siehe Remote-Pfadeintrag hinzufügen oder Remote-Pfadeintrag bearbeiten.

Erstellen und Konfigurieren einer plattformübergreifenden Konsolenanwendung für das macOS-Ziel

  1. Wählen Sie Datei > Neu > Weitere aus. Das Dialogfeld Objektgalerie wird angezeigt.
  2. Wählen Sie entweder Delphi-Projekte oder C++Builder-Projekte aus, und doppelklicken Sie dann auf Konsolenanwendung.
  3. Stellen Sie sicher, dass im Dialogfeld Neue Konsolenanwendung (C++) die Option Konsolenanwendung ausgewählt, die Option Ziel-Framework auf Keine gesetzt und Multi-Threads deaktiviert ist. Klicken Sie anschließend auf OK.
  4. Klicken Sie im Fenster "Projekte" mit der rechten Maustaste auf den Knoten Zielplattformen, und wählen Sie Plattform hinzufügen aus:
    AddTargetPlatform.png
  5. Wählen Sie im Auswahlfeld Plattform auswählen macOS 64 Bit (Intel) oder macOS 64 Bit (ARM) aus, aktivieren Sie das Kontrollkästchen Ausgewählte Plattform aktivieren, und klicken Sie auf OK:
    Select Platform Options.png
  6. Weisen Sie dem macOS-Ziel ein SDK und ein Verbindungsprofil zu:
    1. Klicken Sie im Fenster "Projekte" mit der rechten Maustaste auf die Plattform macOS, um das folgende Kontextmenü anzuzeigen:
      Platform Properties Menu.png
      Wählen Sie im Kontextmenü Eigenschaften aus. Das Dialogfeld Plattformeigenschaften wird angezeigt.
      Platform Properties Box.png
    2. Wählen Sie in SDK (Software Development Kit) das SDK aus, das Sie für diese "Hello World"-Anwendung erstellt haben.
    3. Wählen Sie in Profil das Verbindungsprofil aus, das Sie für die "Hello World"-Anwendung erstellt haben.
    4. Klicken Sie zum Speichern der Änderungen auf OK.

Der Profilname wird nun im Fenster "Projekte" neben der macOS-Plattform angezeigt. Wenn Sie eine C++-Anwendung erstellen, wird auch der SDK-Name angezeigt.

Schreiben des Codes

Ändern Sie im Quelltext-Editor den aus der Vorlage generierten Code:

  1. Nur für C++: Fügen Sie nach den anderen #include-Direktiven die folgende hinzu:
    #include <iostream>
    
  2. Fügen Sie den Code für die Anzeige von "Hello World!" und das Warten auf das Drücken der Eingabetaste hinzu.
    • Geben Sie für Delphi die folgenden Anweisungen in den try-Block (vor dem Schlüsselwort except) ein:
      Writeln('Hello, World!');
      Readln;
      
    • Geben Sie für C++ den folgenden Code vor der Zeile return 0; ein:
      std::cout << "Hello, World!" << std::endl;
      std::cin.ignore();
      
  3. Speichern und benennen Sie die Anwendung (Datei > Speichern).

Ausführen der Konsolenanwendung auf dem macOS-Ziel

  1. Wählen Sie Start > Ohne Debugger ausführen aus.
  2. RAD Studio zeigt Folgendes an: Das Projekt muss vor der Bereitstellung compiliert werden. Fortsetzen?. Klicken Sie auf Ja.
  3. Auf dem Zielcomputer wird die Meldung "Hello, World!" an der Eingabeaufforderung des Platform Assistant angezeigt (nach Meldungen vom Debugger). Drücken Sie die EINGABETASTE. Nach Beendigung der plattformübergreifenden Konsolenanwendung zeigt der Platform Assistant-Server wieder die Eingabeaufforderung (>) an.

Debuggen der Anwendung

Die Anwendung können Sie in der IDE mit einem beliebigen Standard-Start-Befehl debuggen:

  • Start > Start (F9)
  • Start > Gesamte Routine (F8)
  • Start > Einzelne Anweisung (F7)

Sie können den Debugger auch mit dem Befehl Prozess laden oder Mit Prozess verbinden starten.

All diese Befehle:

  • Übertragen die erforderlichen Dateien auf Grundlage des aktuell zugewiesenen Profils auf den Zielcomputer.
  • Führen die Anwendung im Debug-Modus aus.

Die Verwendung des in der IDE integrierten Debuggers zum Debuggen einer macOS-Anwendung entspricht weitgehend der Verwendung des integrierten Debuggers zum Debuggen einer nativen Win32-Anwendung.

Wenn Sie Ihre Anwendung mit einem Start-Befehl ausführen, der den Debugger aufruft (wie z. B. Start > Start oder Start > Gesamte Routine oder Start > Einzelne Anweisung), kann es sein, dass Sie zur Eingabe des "Root"-Passworts für den Mac aufgefordert werden, damit dem Debugger der Zugriff ermöglicht wird.

Siehe auch