Anzeigen: Delphi C++
Anzeigeeinstellungen

Remote-Profile

Aus RAD Studio XE2
Wechseln zu: Navigation, Suche

Nach oben zu Menü Tools


Tools > Optionen > Umgebungsoptionen > Remote-Profile

Inhaltsverzeichnis

Beschreibung

Zeigt die vorhandenen Remote-Profile an, und ermöglicht das Erstellen und Verwalten von Remote-Profilen.

Ein Remote-Profil ist eine benannte Gruppe von Eigenschaften, die die Eigenschaften einer Zielplattform definieren. Um ein Remote-Profil für die Verbindung zu einer Zielplattform (und für die Ausführung oder das Debuggen einer plattformübergreifenden Anwendung) einzusetzen, muss der Platform Assistant auf der Zielplattform installiert sein und ausgeführt werden.

Auf dieser Seite ist für jede Plattform, der ein Remote-Profil zugeordnet ist, ein Profil das Standardprofil, das in Fettschrift angezeigt wird.

Verwenden Sie zum Erstellen eines Remote-Profils dieses Dialogfeld.

Erforderliche Remote-Profile

Remote-Profile sind in den folgenden Situationen bei der Anwendungsentwicklung erforderlich:

  • Bei der plattformübergreifende Anwendungsentwicklung ist ein Remote-Profil für Anwendungen mit der Zielplattform OS X erforderlich.
    • Der integrierte Remote-Debugger kann als Ziel die OS X-Plattform auf einem Mac haben.
    • Ein Remote-Profil ist optional für Win64- oder Win32-Zielplattformen.
  • Beim Remote-Debugging auf Win32- oder Win64-Plattformen ist ein Remote-Profil für den integrierten Remote-Debugger erforderlich.
    • Der integrierte Remote-Debugger kann als Ziel einen Remote-PC haben, auf dem entweder Win32 oder Win64 ausgeführt wird.
  • Bei der Bereitstellung von Anwendungen ist ein Remote-Profil für die Verwendung des Bereitstellungs-Managers erforderlich.
    • Sie können Anwendungen ohne ein Remote-Profil bereitstellen, wenn Sie den Bereitstellungs-Manager nicht verwenden.
Hinweis: Für die Verbindung zu einem plattformübergreifenden Ziel muss der Remote-Anwendungsserver Platform Assistant auf dem plattformübergreifenden Ziel installiert sein und ausgeführt werden.

Dateinamen und Dateierweiterungen für Remote-Profile

Profilnamen unterliegen – außer dass sie gültige Dateinamen gemäß System.IOUtils.TPath.HasValidFileNameChars sein müssen – kaum Beschränkungen. Doppelte Profilnamen führen zu einem Fehler (beim Hinzufügen, Kopieren, Umbenennen und Importieren).

Die Erweiterung der Profildateien lautet .profile. Sie wird automatisch beim Speichern des Profils als Datei hinzugefügt.

Beispiele für Namen von Remote-Profilen:

  • MyFirstOSXApp
  • Gr8daZ!

Jedes definierte Profil wird als eine .profile-Datei in Ihrem Anwendungsdaten-Ordner (der von DesignIntf.IDesigner.GetAppDataDirectory zurückgegeben wird) gespeichert, wie z.B. der folgende Ordner unter Windows 7:

C:\Users\<username>\AppData\Roaming\Embarcadero\BDS\9.0

Ihre Profile sind auch als Ordner oder Verzeichnisse in dem folgenden Verzeichnis (unter Windows 7) vorhanden:

 C:\Users\<username>\Documents\RAD Studio\Profiles

In die Profilordner werden Dateien eingefügt, die der Platform Assistant bei der Entwicklung von der Zielplattform überträgt.

Fenster "Remote-Profile"

Element Beschreibung

Profile

Listet die definierten Remote-Profile zusammen mit ihren zugewiesenen Plattformen auf. Fettschrift zeigt das Standardprofil für eine Plattform an.

  • Zum Festlegen eines Standardprofils für eine Plattform klicken Sie mit der rechten Maustaste auf das Profil und wählen Als Standard.
  • Zum Bearbeiten eines Profils, wählen Sie es in der Liste Profile aus, nehmen die Änderungen an den Profileigenschaften vor und klicken dann auf OK (ohne OK werden Ihre Änderungen nicht gespeichert).

Durch Klicken auf die Profile werden die Schaltflächen zur Verwaltung eines Profils (Kopieren, Umbenennen, Löschen und Exportieren) aktiviert.

Profileigenschaften

Zeigt die aktuellen Einstellungen des ausgewählten Remote-Profils an.

Plattform

Zeigt die vorgesehene Zielplattform für das ausgewählte Remote-Profil an. Wenn Sie die Plattform auf dieser Seite ändern, wird die Position des Profils in der Liste der Profile analog geändert.

Host-Name

Geben Sie eine der beiden folgenden Angaben ein:

  • Den Name des Zielcomputers (übernommen aus dem Netzwerk mit der Standard-DNS-Suche)
  • Die IP-Adresse des Zielcomputers

Geben Sie zum Ermitteln der IP-Adresse des Zielcomputers den folgenden Befehl ein:

  • ifconfig im Mac-Terminalfenster
  • ipconfig im PC-Befehlsfenster

Port-Nummer

Zeigt die im ausgewählten Remote-Profil verwendete Port-Nummer an. Sie können eine Port-Nummer im Bereich von 1 bis 65.535 festlegen. Dieser Port wird bei der Verbindung zum Platform Assistant auf der Zielplattform verwendet.

Passwort

Zeigt das Passwort an, das für die Verbindung zum Platform Assistant auf der Zielplattform verwendet wird.

Das Passwort wird beim Start von paserver (Platform Assistant) auf der Zielplattform festgelegt:

  • Sie werden zum Festlegen eines Passwortes bei der Initialisierung von paserver (Platform Assistant) auf der Zielplattform aufgefordert.
    Remote-Profil-Passwort <Eingabetaste für kein Passwort>:
  • Andere Möglichkeiten zum Festlegen des Passwortes:
    • Fügen Sie dem Befehl zum Starten von paserver die Option -password=<Text> hinzu.
    • Verwenden Sie ein geheimes Passwort durch Angabe einer .passfile-Datei (einer verschlüsselten Passwortdatei):
      • Zur Verwendung einer vorhandenen .passfile-Datei klicken Sie auf die Ellipse [...], navigieren zum Speicherort der .passfile-Datei, und klicken dann auf Öffnen.
      • Wechseln Sie zum Erstellen einer .passfile-Datei zur Zielplattform, auf der der "Platform Assistant" ausgeführt wird, und geben Sie an der Eingabeaufforderung von paserver (Platform Assistant) die Option g (Anmeldepasswortdatei erzeugen) ein.
Lokales Stammverzeichnis

Zeigt das Verzeichnis auf dem lokalen Computer an, in dem die Dateien von dem Remote-Computer zwischengespeichert werden. Der Vorgabewert lautet:

$(BDSPROFILESDIR)\<profile-name>

Der Wert für die Variable $(BDSPROFILESDIR) wird auf der Seite Umgebungsvariablen des Dialogfeldes Tools-Optionen festgelegt.

Bei C++ wird dieses Verzeichnis dem Compiler mit der Option --sysroot mitgeteilt. Den Remote-Pfadangaben wird implizit das lokale Stammverzeichnis vorangestellt.

Klicken Sie auf die Ellipsen-Schaltfläche [...], um das Dialogfeld Ordner suchen anzuzeigen, mit dem Sie das Verzeichnis suchen können.


Sie können die aktuellen Werte als neue Standardwerte durch Klicken auf SavePaths.bmp Pfade als Vorgabe für die ausgewählte Plattform speichern im Bereich Remote-Pfade festlegen. Das lokale Standardstammverzeichnis wird zusammen mit den Standardprofilpfaden in der Datei APPDATA\Embarcadero\BDS\<n.n>.<Plattformname>.defaultprofilepaths gespeichert.

Remote-Pfade

Zeigt die Liste der Pfade auf dem Remote-Computer an, die auf den lokalen Computer übernommen wurden.

Ein Remote-Pfad besteht aus:

  • Verzeichnis. Gibt das Verzeichnis auf der Zielplattform an.
  • Dateifilter. Repräsentiert entweder den Dateinamen (für eine einzelne Datei) oder den Platzhalter * (Sternchen), was allen Dateien in dem angegebenen Verzeichnis entspricht. Beispiel: OpenGL.
  • Unterverzeichnisse. Gibt an, ob Unterverzeichnisse einbezogen werden sollen.

Es gibt vier Kategorien von Remote-Pfaden, und die Kategorie bestimmt folgendermaßen, wie die Pfade/Einträge an den C++-Compiler und -Linker übergeben werden:

  • Include-Pfade werden an den Compiler als Teil des --sysinc-Pfads (der Include-Dateisuchpfad des Systems mit dem vorangestellten Stammverzeichnis) übergeben.
  • Bibliothekspfade werden an den Linker als Teil des --syslib-Pfads (der Bibliothekssuchpfad des Systems mit dem vorangestellten Stammverzeichnis) übergeben.
  • Frameworks werden dem Compiler (mit der Option --framework) und dem Linker (mit der Option --Ff) übergeben.
  • Andere Pfade werden nicht standardmäßig an den Compiler/Linker übergeben, aber auf den lokalen Computer übernommen.

Alle angegebenen Elemente werden auf den lokalen Computer übernommen. Siehe PAClient.

Alle Pfade sollten das für den Ziel-Host-Computer geeignete Format aufweisen. Verwenden Sie beispielsweise Schrägstriche (/) als Trennzeichen für Mac-Hosts. Bestimmte Zeichen, wie z.B. die Tilde (~), werden für Mac erkannt.

Die Schaltflächen im Feld Remote-Pfade werden im Folgenden beschrieben:

Schaltfläche Beschreibung

AddNewPathItem.bmp Neuen Pfadeintrag hinzufügen

Zeigt das Dialogfeld Remote-Pfadeintrag hinzufügen an. Sie können einen neuen Pfadeintrag auch durch Drücken der Taste Einfg in der Liste der Remote-Pfade einfügen.

EditPathItem.bmp Ausgewählten Pfadeintrag bearbeiten

Zeigt das Dialogfeld Remote-Pfadeintrag bearbeiten an.

DeletePathItem.bmp Ausgewählten Pfadeintrag löschen

Zeigt ein Bestätigungsdialogfeld an und löscht nach Bestätigung des Löschens den ausgewählten Pfadeintrag. Sie können einen Pfad auch durch Drücken der Taste Entf bei ausgewähltem Pfadeintrag in der Liste der Remote-Pfade löschen.

ResetPaths.bmp Pfade auf Vorgabe für die ausgewählte Plattform zurücksetzen

Zeigt ein Bestätigungsdialogfeld an und überschreibt nach Bestätigung des Zurücksetzens alle Pfadeinträge mit den Standardwerten des Profils für die ausgewählte Plattform. Bezieht das lokale Stammverzeichnis nur mit ein, wenn es leer ist.

Die wiederhergestellten Werte werden folgendermaßen ermittelt:

  • Wenn Sie die Vorgaben nicht zurückgesetzt haben, entsprechen die Werte denjenigen, die ursprünglich auf der Seite C++-Verzeichnisinformation des Experten angezeigt wurden.
  • Nach dem Zurücksetzen der Standardwerte werden die neuen Werte zu den Standardwerten. Diese werden in der Datei <Plattform>.defaultprofilepaths in Ihrem %APPDATA%\Embarcadero\BDS-Verzeichnis gespeichert. Daher werden durch Klicken auf ResetPaths.bmp die neuen Standardwerte wiederhergestellt.
  • Löschen Sie zum Wiederherstellen der ursprünglichen Werte die Datei .defaultprofilepaths für die Zielplattform. Die ursprünglichen Standardpfade werden nun im Dialogfeld Ein Remote-Profil erstellen angezeigt.

SavePaths.bmp Pfade als Vorgabe für die ausgewählte Plattform speichern

Überschreibt die Standardpfadangaben mit den angegebenen Profilwerten für Pfadeinträge für die ausgewählte Plattform. Nach dem Speichern der Pfade als Standardwerte werden die hier eingegebenen neuen Werte wiederhergestellt, wenn Sie auf ResetPaths.bmp (Pfade auf Vorgabe zurücksetzen) klicken.

Beim Speichern von Standardpfaden wird für die Vorgaben eine Datei erstellt. Der Dateiname ist der Plattformname mit der Erweiterung .defaultprofilepaths.

Zum Beispiel:

Macintosh OS X

OSX32.defaultprofilepaths

Win32

Win32.defaultprofilepaths

Win64

Win64.defaultprofilepaths

Um Ihre Einstellungen zu verwerfen und die ursprünglichen Vorgaben wiederherzustellen, löschen Sie zuerst die Datei .defaultprofilepaths aus dem Verzeichnis, zu dem %APPDATA% erweitert wird (%APPDATA%\Embarcadero\BDS\<n.n>) und klicken dann auf ResetPaths.bmp (Pfade auf Vorgabe zurücksetzen).

UpArrow.bmp Schaltfläche "Nach oben"

Verschiebt den ausgewählten Pfadeintrag in der Pfadgruppe nach oben. Sie können den Eintrag auch durch Drücken der Tastenkombination Strg+Auf in der Liste Remote-Pfade nach oben verschieben.

DownArrow.bmp Schaltfläche "Nach unten"

Verschiebt den ausgewählten Pfadeintrag in der Pfadgruppe nach unten. Sie können den Eintrag auch durch Drücken der Tastenkombination Strg+Ab in der Liste Remote-Pfade nach unten verschieben.

Verbindung testen

Versucht, eine Verbindung zu dem Remote-Computer mit dem Host-Namen, der Port-Nummer und dem Passwort herzustellen. Zeigt eine Meldung darüber an, ob der Versuch erfolgreich war oder nicht. Der Platform Assistant muss dafür auf dem Host-Computer ausgeführt werden.

Lokalen Dateizwischenspeicher aktualisieren

(Nur C++ auf OS X) Übernimmt alle in den aktuellen Profileinstellungen angegebenen Dateien von dem Remote-Zielcomputer auf den lokalen (Entwicklungs-)Computer. Bei der ersten Ausführung dieser Aktualisierung für ein gegebenes Profil werden alle Dateien übernommen. Bei folgenden Aktualisierungen werden nur die Dateien mit abweichender Größe oder Zeitstempel übernommen. Ein Fortschrittsdialogfeld wird während der Übernahme angezeigt, in dem Sie den Vorgang abbrechen können. Zudem wird vor dem Überschreiben von lokalen Dateien eine Bestätigungsmeldung angezeigt. Während der Aktualisierung wird die Meldung "Lokaler Dateizwischenspeicher wird aktualisiert" angezeigt.

Der lokale Dateizwischenspeicher muss vor dem Compilieren, Erzeugen oder Ausführen aktualisiert werden. Wenn Sie diese Schaltfläche nicht für ein bestimmtes Remote-Profil aktiviert haben, oder wenn Sie im Dialogfeld Remote-Profile Änderungen an den Pfaden vorgenommen haben, wird eine automatische Aktualisierung beim Beginn des Compilierens, Erzeugens oder Ausführens aufgerufen.

Hinzufügen

Ruft den Experten Ein Remote-Profil erstellen auf, so dass Sie eine Verbindung zu dem Remote-Ziel herstellen und die Eigenschaften für das Remote-Profil festlegen können. Durch Drücken der Taste Einfg in der Liste Profile wird dieses Dialogfeld ebenfalls geöffnet.

Kopieren

Zeigt ein Dialogfeld zur Eingabe eines neuen Profilnamens an und kopiert die Einstellungen des aktuell ausgewählten Profils in das neue Profil.

Umbenennen

Zeigt ein Dialogfeld zur Eingabe eines neuen Profilnamens an und benennt das aktuell ausgewählte Profil um. Alle Projekte, die das vorhandene Profil verwenden, werden mit dem neuen Profilnamen aktualisiert.

Löschen

Zeigt ein Bestätigungsdialogfeld an, und löscht nach Bestätigung des Löschens das aktuell ausgewählte Profil. Sie können ein Profil auch durch Drücken der Taste Entf in der Liste der Profile löschen.

Exportieren

Zeigt ein Dialogfeld zur Eingabe eines Dateinamens an und speichert das Profil an dieser Position (der Standarddateiname ist "<Profilname>.profile").

Importieren

Zeigt ein Dialogfeld zur Eingabe eines .profile-Dateinamens an und importiert das enthaltene Profil in die IDE.

Siehe auch

Frühere Versionen
In anderen Sprachen