IDE-Befehlszeilenoptionen

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu IDE-Referenz und Hilfsprogramme


Beschreibung der Optionen für den Start der IDE von der Befehlszeile aus.

IDE-Befehlszeilenoptionen

Im Folgenden sind die Optionen beschrieben, die Sie beim Start der IDE von der Befehlszeile aus angeben können.

Allen Optionen muss entweder ein Bindestrich (-) oder ein Schrägstrich (/) vorangestellt werden (falls nicht anders angegeben). Da zwischen Groß- und Kleinschreibung nicht unterschieden wird, sind folgende Optionen identisch:

-d /d -D /D

Verwenden Sie die IDE-Befehlszeilenoptionen mit dem Startbefehl für die IDE:

bds.exe

Beispiele mit BDS.EXE

Code Ergebnis
bds.exe -ns

Startet die RAD Studio-IDE ohne Startbildschirm.

bds.exe -sd c:\test\source -d c:\test\myprog.exe \mbox{-}td
  • Startet die RAD Studio-IDE.
  • Lädt c:\test\myprog.exe in den Debugger.
  • Verwendet c:\test\source als Verzeichnis für den Quellcode beim Debuggen.

Die Option -td und alle anderen Argumente nach der Debugger-Option (-d ExeName) werden als Argumente an c:\test\myprog.exe übergeben.

bds.exe /ProductInfo:

Ermöglicht die Abfrage der installierten SKUs, Plattformen, Personalities und Testversionen. Geben Sie die folgenden Befehle ein:

  • bds.exe /ProductInfo:Trial: Gibt True zurück, wenn das Produkt eine Testversion ist. Andernfalls wird False zurückgegeben.
  • bds.exe /ProductInfo:Platforms: Gibt die installierten Plattformen zurück: WinNX32, OSX64, Android64, OSXARM64, Android, Win32, Win64, Linux64, iOSDevice64, iOSSimARM64, WinIoT32 und/oder WinARM32.
  • bds.exe /ProductInfo:SKU: Gibt den SKU-Namen des Produkts zurück (z. B. Enterprise, Architect, Community).
  • bds.exe /ProductInfo:Personalities: Gibt die installierten Personalities zurück: CPlusPlusBuilder.Personality und/oder Delphi.Personality.
Hinweis: Verwenden Sie die ToolsAPI.IOTAPersonalityServices, um Details der jeweiligen Personality zu erhalten.

Allgemeine Optionen für BDS.EXE

Option Beschreibung
?

Ruft die IDE auf und zeigt die Online-Hilfe für die IDE-Befehlszeilenoptionen an.

-- (zwei Bindestriche)

Ignoriert den Rest der Befehlszeile.

ns

Kein Startbildschirm. Startet die IDE ohne Startbildschirm.

np

Keine Willkommensseite. Zeigt die Willkommensseite nach dem Start der IDE nicht an.

p Personality

Startet die angegebene Personality der RAD Studio-IDE. Die folgenden Werte sind für Personality möglich:

  • Delphi
  • CBuilder
r regkey

Alternativer Registrierungsschlüssel. Ermöglicht die Angabe eines anderen Basis-Registrierungsschlüssels, sodass die Ausführung zweier Instanzen der IDE mit unterschiedlichen Konfigurationen möglich ist. Komponentenentwickler können dann zum Debuggen einer Komponente während des Entwurfs die IDE als Hostanwendung verwenden, ohne dass die Debug-IDE durch das Laden des Komponenten-Package Konflikte verursacht.

cleanregistryide

Bereinigen der Registrierungseinträge für die IDE. Löscht die BDS-Dateien und den BDS-Registrierungsschlüssel des aktuellen Benutzers, die sich im BDS-Verzeichnis unter appdata befinden. Achtung: Dabei gehen alle Ihre im BDS-Verzeichnis befindlichen Projekte verloren. Deshalb sollen Sie sie sichern, bevor Sie BDS mit dieser Option starten. Dies sollte nicht Ihre erste Wahl bei der Fehlerbehebung in der IDE sein, sondern als letztes Mittel verwendet werden.

highdpi:VALUE

DPI-Unterstützung. Standardmäßig wird die IDE mit DPI-Unterstützung über perMonitorv2 ausgeführt. Um zu erzwingen, dass die IDE ohne DPI-Unterstützung ausgeführt wird, legen Sie VALUE auf unaware fest. Um die IDE mit aktiviertem High DPI auszuführen, verwenden Sie diesen Parameter entweder nicht, oder ändern Sie VALUE in permonitorv2.

Hinweis: Standardmäßig wird die IDE mit High DPI ausgeführt.

Mögliche Werte für diesen Parameter sind:

  • unaware: Die IDE wird ohne High DPI-Unterstützung ausgeführt. Verwenden Sie dies nur zu Kompatibilitätszwecken.
  • systemaware: Dieser Wert wird nicht unterstützt.
  • permonitor: Dieser Wert wird nicht unterstützt.
  • permonitorv2: Die IDE wird mit derselbe High DPI-Unterstützung ausgeführt, die die VCL unterstützt. Das ist der Vorgabewert.
  • unawaregdiscaling: Dieser Wert wird nicht unterstützt.

Debugger-Optionen

Option Beschreibung

attach:%1;%2

Nimmt eine Debug-Zuordnung vor. Verwendet %1 als Prozess-ID und %2 als Ereignis-ID für diesen Prozess. Obwohl die Option attach auch manuell verwendet werden kann, wird sie meistens beim Just-in-Time-Debugging eingesetzt.

ExeName       

Lädt die angegebene ausführbare Datei (ExeName) in den Debugger. Alle nach "ExeName" angegebenen Parameter werden als Parameter für das zu debuggende Programm verwendet und von der IDE ignoriert. Zwischen dem -d und "ExeName" kann ein Leerzeichen angegeben werden.


Die folgenden Optionen können nur zusammen mit der Option -d verwendet werden:

Option Beschreibung

debugger=borwin32 debugger=embwin32 debugger=embwin64 debugger=embmacosx debugger=embios debugger=embandroid

Legt fest, welcher Debugger verwendet werden soll. Wird diese Option weggelassen, wird der Debugger verwendet, der zuerst bei der IDE registriert wurde.

  • borwin32 und embwin32 rufen den Win32-Debugger, den in der IDE eingebetteten Standard-Debugger für 32-Bit-Windows, auf.
  • embwin64 ruft den Win64-Debugger auf (zum Debuggen von 64-Bit-Windows-Anwendungen).
  • embmacosx ruft den macOS-Debugger auf (zum Debuggen von macOS-Apps).
  • embios ruft den iOS-Debugger auf (zum Debuggen von Apps auf dem iOS-Gerät).
  • embandroid ruft den Android-Debugger auf (zum Debuggen von Apps auf dem Android-Gerät).

l

(Kleines L) Assembler-Start. Führt den Startcode nicht aus. Muss zusammen mit der Option -d verwendet werden. Normalerweise versucht der Debugger bei Angabe der Option -d, den Prozess bis zur Funktion "main" oder "WinMain" auszuführen. Mit der Option -l wird der Prozess lediglich geladen, aber kein Startcode ausgeführt.

sd directories

Quellverzeichnisse. Muss zusammen mit der Option -d verwendet werden. Das Argument ist entweder ein einzelnes Verzeichnis oder eine durch Semikolon getrennte Liste von Verzeichnissen, die für die Einstellung Debug-Quellpfad verwendet werden (kann auch auf der Seite Projekt > Optionen > Debugger festgelegt werden). Zwischen "sd" und dem Verzeichnislistenargument muss ein Leerzeichen stehen.

hostname

Host-Name des Remote-Debuggers. Muss zusammen mit der Option -d verwendet werden. Eine Remote-Debug-Sitzung wird gestartet, wobei der Host-Name den Host angibt, auf dem das Debuggen ausgeführt wird. Das Remote-Debug-Server-Programm muss auf dem Remote-Host ausgeführt werden.

workingdirectory

Legt das Arbeitsverzeichnis für Ihre Debug-Sitzung fest. Entspricht der Einstellung "Arbeitsverzeichnis" im Dialogfeld Prozess laden. Zwischen -t und dem Verzeichnislistenargument darf kein Leerzeichen stehen.

Projektoptionen

Option Beschreibung

filename

(Ohne vorangestellten Bindestrich) Lädt die angegebene Datei in die IDE. Dies kann ein Projekt, eine Projektgruppe oder eine einzelne Datei sein.

b

AutoBuild. Muss zusammen mit der Option Dateiname verwendet werden. Wenn die Option -b angegeben ist, wird das Projekt bzw. die Projektgruppe beim Start der IDE automatisch erzeugt. Die dabei generierten Hinweise, Fehler und Warnungen werden in einer Datei gespeichert. Danach wird die IDE geschlossen. Auf diese Weise können Anwendungen im Stapelmodus mithilfe einer Stapeldatei erzeugt werden. Die Fehlerstufe ist 0 bei erfolgreicher Erstellung und 1 im Fehlerfall. Standardmäßig hat die Ausgabedatei denselben Namen wie der angegebene Dateiname mit der Dateierweiterung .err. Dieses Verhalten kann mit der Option -o überschrieben werden.

m

AutoMake. Entspricht "AutoBuild", führt aber anstelle einer vollständigen Erzeugung nur eine Compilierung der aktualisierten Dateien durch.

ooutputfile

Ausgabedatei. Muss zusammen mit der Option -b oder -m verwendet werden. Wenn die Option -o angegeben ist, werden Hinweise, Warnungen und Fehlermeldungen in die angegebene anstatt in die Standarddatei ausgegeben. Verwenden Sie kein Leerzeichen zwischen -o und dem Dateinamen.