UIP-Lösungsprojekt

uip solution project verwaltet die in einem .uipx -Lösungsmanifest aufgeführten Projekte – Workflows, Testfälle, Bibliotheken, Agents, Maestro-Flows und Apps. Drei Unterbefehle sind verfügbar:

Unterbefehl	Zweck
add	Registrieren Sie einen Projektordner, der sich bereits im Lösungsverzeichnis befindet.
import	Kopieren Sie einen externen Projektordner in das Lösungsverzeichnis und registrieren Sie ihn dann.
remove	Die Registrierung eines Projekts bei .uipx aufheben (löscht keine Dateien auf der Festplatte).

Alle drei Unterbefehle funktionieren nur mit lokalen Dateien; ist keine Authentifizierung erforderlich.

Zusammenfassung

uip solution project add <projectPath> [solutionFile]
uip solution project import --source <path> [--solutionFile <path>]
uip solution project remove <projectPath> [solutionFile]

Jeder Unterbefehl berücksichtigt die globalen Optionen und gibt die Standardaustrittscodes zurück.

Allgemeines Verhalten

• Der Zielprojektordner muss entweder einen project.uiproj oder einen Legacy- project.json -Deskriptor enthalten. Der Befehl erkennt automatisch, welcher.
• Wenn <solutionFile> weggelassen wird, sucht der Befehl vom Projektpfad (oder dem aktuellen Verzeichnis nach import) nach oben für das nächste .uipx. Wenn keine gefunden wird oder wenn sich mehrere .uipx -Dateien im selben Ordner befinden, schlägt der Befehl mit einem beschreibenden Fehler fehl und wird mit 1 beendet.
• Für jeden Projekteintrag, der dem Manifest hinzugefügt wird, wird eine eindeutige Id (UUID) generiert.

---

UIP-Lösungsprojekt hinzufügen

Registrieren Sie einen Projektordner, der sich bereits im Lösungsverzeichnis befindet . Der relative Pfad des Projektordners wird in .uipx aufgezeichnet, und ein übereinstimmender Eintrag wird im internen Ressourcengenerator der Lösung bereitgestellt.

Argumente

• <projectPath> (erforderlich) – Der Pfad zum Projektordner. Muss project.uiproj oder project.json enthalten.
• [solutionFile] (optional) – Der Pfad zum .uipx -Lösungsmanifest. Wenn keine Angabe erfolgt, müssen Sie den nächsten .uipx zu Beginn von <projectPath> nach oben finden.

Optionen

Keine über die globalen Optionen hinaus.

Beispiele

Minimal

uip solution project add ./my-solution/my-project ./my-solution/my-solution.uipx

Die automatische Erkennung .uipx

uip solution project add ./my-solution/my-project

Skripting – Fügen Sie eine Pipeline hinzu und packen Sie sie dann in eine Pipeline

uip solution project add ./my-solution/my-project
uip solution pack ./my-solution ./dist --version 1.0.0

Datenform (--output json)

{
  "Code": "ProjectAdd",
  "Data": {
    "Status": "Added successfully",
    "Project": "my-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Fehlermodi

• Das Projekt befindet sich außerhalb des Lösungsordners. Der Befehl verweigert das Hinzufügen mit einem Verweis auf project import, wodurch externe Projekte in kopiert werden.
• Projekt ist bereits registriert. Wird mit 1 und einer Nachricht beendet, die das vorhandene ProjectRelativePath benennt.

---

Import des UIP-Lösungsprojekts

Kopieren Sie einen externen Projektordner in das Lösungsverzeichnis (unter Beibehaltung des Ordnernamens) und registrieren Sie ihn dann im .uipx. Verwenden Sie dies, wenn sich das Projekt, das Sie einschließen möchten, noch nicht unter dem Lösungsstamm befindet.

Optionen

• --source <path> (erforderlich) – Der Pfad zum externen Projektordner, der importiert werden soll. Muss ein Verzeichnis sein, das project.uiproj oder project.json enthält.
• --solutionFile <path> (optional) – Der Pfad zum .uipx -Lösungsmanifest. Standardmäßig wird der nächste .uipx verwendet, der beim Gehen vom aktuellen Arbeitsverzeichnis nach oben gefunden wird.

Beispiele

Allgemein

uip solution project import \
  --source ./external-project \
  --solutionFile ./my-solution/my-solution.uipx

Aus dem Lösungsverzeichnis (automatische Erkennung .uipx)

cd ./my-solution
uip solution project import --source ../shared-library

Datenform (--output json)

{
  "Code": "ProjectImport",
  "Data": {
    "Status": "Imported successfully",
    "Project": "external-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Fehlermodi und Rollback

• Zielordner ist bereits vorhanden. Der Befehl kann nicht überschrieben werden; Benennen Sie den Quellordner um oder entfernen Sie zuerst das vorhandene Ziel.
• Projekt bereits im .uipx -Manifest. Abgelehnt, bevor Dateien kopiert werden.
• Kopier-, Schreib- oder Erstellungsschritt schlägt fehl. Der Befehl läuft zurück – das kopierte Verzeichnis wird entfernt und der .uipx wird in seinem ursprünglichen Inhalt wiederhergestellt.

---

UIP-Lösungsprojekt entfernen

Heben Sie die Registrierung eines Projekts beim .uipx -Lösungsmanifest auf und legen Sie seinen Eintrag aus dem internen Ressourcengenerator ab. Dateien auf der Festplatte werden nicht gelöscht.

Argumente

• <projectPath> (erforderlich) – Der Pfad zum zu entfernenden Projektordner. Muss derzeit in .uipx registriert sein.
• [solutionFile] (optional) – Der Pfad zum .uipx -Lösungsmanifest. Standardmäßig wird der nächste .uipx verwendet, der gefunden wird, wenn Sie von <projectPath> nach oben gehen.

Beispiele

Minimal

uip solution project remove ./my-solution/my-project ./my-solution/my-solution.uipx

Scripting – Entfernen Sie mehrere Projekte

for p in project-a project-b project-c; do
  uip solution project remove "./my-solution/$p" || true
done

Datenform (--output json)

{
  "Code": "ProjectRemove",
  "Data": {
    "Status": "Removed successfully",
    "Project": "my-project",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Fehlermodi

• Das Projekt befindet sich außerhalb des Lösungsordners. Der relative Pfad darf nicht mit .. beginnen.
• Das Projekt befindet sich nicht im Manifest. Beendet mit 1 und dem relativen Pfad, der für die Suche verwendet wird.

---

Zugehörige Befehle

• uip solution new – Erstellen Sie ein Gerüst für die Lösung, bevor Sie Projekte hinzufügen.
• uip solution resource refresh – Synchronisierung von Ressourcen nach der Bearbeitung von Projektbindungen erneut.
• uip solution pack – Verpacken der Lösung, sobald ihre Projektliste finalisiert ist.

Siehe auch

• Ihre erste Pipeline – End-to-End-Beispiel.
• uip solution Übersicht.