Lokale GetIt-Package-Aktionsdaten - Index

Nach oben zu GetIt-Anleitung für lokale Dateien - Index

Für jedes GetIt-Element ist eine Liste mit Aktionen definiert, die Benutzer mit der RAD Studio-IDE ausführen können. Jede Aktion enthält den numerischen Wert, den Namen, eine zusammenfassende Beschreibung und eine Liste der erforderlichen und optionalen Parameter.

Rollen

Im Folgenden finden Sie die Beschreibungen für jede Rolle:

• Id: eindeutiger Bezeichner der Aktion. Muss sich von allen anderen Aktionen im selben GetIt-Package unterscheiden. Der numerische Wert bestimmt auch die Ausführungsreihenfolge der Aktionen, die im selben Ereignis zugeordnet sind (siehe Type unten). Alle Aktionen nach "Download" werden in der Reihenfolge der numerischen ID ausgeführt.
• ActionId: gibt die Nummer der aktuellen auszuführenden Aktion an. Die relevanten Aktionen und ihre IDs sind weiter unten in diesem Artikel aufgeführt. Sie müssen auf sie anhand der Nummer in der JSON-Konfigurationsdatei verweisen.
• Type: gibt das Ereignis (mit einem numerischen Wert) an, dem die Aktion zugeordnet ist, d. h., wenn sich die Aktion in dem Prozess befindet, wird sie ausgelöst. Dies muss eine Zahl von 1 bis 6 sein, die an Ereignisse wie "After Download" oder "Before Uninstall" gebunden ist.
• RequireElevation: gibt an, ob die jeweilige Aktionen Benutzerkontensteuerung erfordern. Dies arbeitet in Verbindung mit derselben Einstellung bei der Package-Konfiguration (beide müssen festgelegt sein).
• Parameter: zeigt eine Liste mit einem oder mehrerer Positionsparametern an. Die Rolle eines Parameters hängt genau von der ausgeführten Aktion ab (jede Aktion hat eine andere Anzahl von Parametern und einen unterschiedlichen Wert und eine unterschiedliche Rolle).
• ActionName: ist die optionale Beschreibung der Aktion und sollte mit dem numerischen ActionId-Wert übereinstimmen, damit die JSON-Konfigurationsdatei lesbar bleibt.
• Description: ist eine Beschreibung der Aktion (wird von der GetIt-UI im Fortschrittsdialogfeld angezeigt und in einer Datei zusammen mit ActionId und ActionName protokolliert).

Das folgende Beispiel enthält die oben beschriebenen Elemente:

"Actions": [
{
    “Id": "1",
    …
  }
]

Eine einzelne Aktionsdefinition hat Felder wie die folgenden:

{
  "Id": "1",
  “ActionId": "6",
  "Type": "2",
  "RequireElevation": "0",
  "Parameter": [
    { "Parameter": "packages\\Sydney\\Delphi\\AbbreviaD.dproj" },
    { "Parameter": "Win32" },
    { "Parameter": "Release" }
  ],
  "ActionName": "CompileProject",
  "Description": "Compile AbbreviaD.dproj"
}

Hinweis: Das Beispiel unten verwendet eine "Code-Notation", wie AddOptionPath("source\", "cPasLibraryPath", "Delphi.Personality", "Win32" und nicht die in der Datei verwendete JSON-Notation.

Ereignisse

Standardmäßig extrahiert das System die ZIP-Datei des GetIt-Package in den Katalog-Repository-Ordner. Sie können Aktionen definieren, die bei der Installation (oder Deinstallation) ausgeführt werden sollen. Jede Aktion eines Package wird einem Ereignis zugeordnet.

Sie können die folgenden Ereignisse verwenden (die Nummer wird als "Typ" der Aktion angegeben, siehe oben Type=2 für "After Download"):

1. Before Download: Tritt vor dem Herunterladen des Katalogelements ein und kann keines der Elemente der Download-Dateien verwenden. Die Aktion wird ignoriert, wenn sich das Element bereits im Zwischenspeicher befindet.
2. After Download: Wird nach dem Herunterladen und Extrahieren eines Katalogelements ausgeführt. Wird ignoriert, wenn sich das Element bereits im Zwischenspeicher befindet.
3. Before Install: Wird vor der Installation eines Katalogelements ausgeführt.
4. After Install: Wird nach der Installation eines Katalogelements ausgeführt.
5. Before Uninstall: Wird vor der Deinstallation eines Katalogelements ausgeführt und entfernt es aus dem Zwischenspeicher.
6. After Uninstall: Wird nach der Deinstallation eines Katalogelements ausgeführt und kann keines der Elemente der Download-Dateien verwenden, da diese bereits gelöscht wurden.

In den Abschnitten unten wird jeder, nach seiner Nummer aufgeführte Aktionstyp (oder Ereignistyp) beschrieben.

Verfügbare Aktionen

ActionName	ActionID
AddOptionPath	1
RemoveOptionPath	2
ExecuteProgram	3
InstallCHM	4
UninstallCHM	5
CompileProject	6
CleanProject	29
InstallPackage	7
UninstallPackage	8
UninstallProgram	11
ExecuteCommand	12
WarmNeededIDERestart	16
InstallIDEPackage	17
UninstallIDEPackage	18
CopyFile	19
UnzipFile	20
RestartIDE	21
AddValueToRegistry	24
DeleteValueFromRegistry	25
DeleteFile	32
AddEnvironmentVariable	33
RemoveEnvironmentVariable	34
AddTemporalVariable	35
RemoveTemporalVariable	36
MoveFile	37
ReplaceStrFromFile	38
CreateShortcut	39
CopyFolder	40
OpenCloseProject	41
MoveFolder	42
Vordefinierte temporäre Variablen

Siehe auch

• Beispiel-Code