UIP-Lösungspaket

Syntax und Optionen für „UIP Solution Pack“, das eine bereitstellte „.zip“-Datei aus einem Lösungsverzeichnis oder eine „.uis“-Paketdatei erzeugt.

uip solution pack erzeugt ein bereitstellungsfähiges .zip -Paket aus einem Lösungsverzeichnis (mit einem .uipx -Manifest) oder aus einer .uis -Paketdatei. Das resultierende Archiv wird von uip solution publish in den Mandantenfeed hochgeladen, den uip solution deploy run dann bereitstellen kann.

Packen ist ein Offlinevorgang – er kontaktiert Orchestrator nur, um NuGet-Abhängigkeiten aus Mandantenfeeds (oder dem Bibliotheksfeed eines Orchestrator-Ordners über --feed-folder) aufzulösen – daher ist es sicher, innerhalb von Buildschritten auszuführen, die noch nicht über vollständige Anmeldeinformationen verfügen, wie z. B solange die Auflösung der Abhängigkeiten abgedeckt ist.

Zusammenfassung

uip solution pack <solutionPath> [outputPath] \
  [--name <name>] [--version <version>] \
  [--dry-run] \
  [--skip-analyze] [--governance-file-path <path> | --automation-ops-profile <profile>] \
  [--nuget-sources-config-path <path>] [--exclude-configured-sources] [--feed-folder <name>] \
  [--signing-certificate-path <path>] [--signing-certificate-password <password>] [--signing-timestamp-server <url>] \
  [--author <text>] [--description <text>] [--release-notes <text>] [--project-url <url>] \
  [--repository-url <url>] [--repository-commit <sha>] [--repository-branch <branch>] [--repository-type <type>] \
  [--login-validity <minutes>]

Der Befehl berücksichtigt die globalen Optionen und gibt die Standardaustrittscodes zurück.

Argumente

• <solutionPath> (erforderlich) – Pfad zu einem Lösungsverzeichnis (mit einem .uipx -Manifest) oder einer .uis -Datei.
• [outputPath] (optional) – Ausgabeverzeichnis, in das das .zip -Paket geschrieben wird. Erforderlich, es sei denn, --dry-run ist festgelegt – das Auslassen ohne --dry-run schlägt mit einem Verweis auf das Hinzufügen des einen oder anderen fehl.

Optionen

Core

Long	Wert	Standard	Beschreibung
-n, --name <name>	text	Name des Lösungsordners (oder Basisname der .uis -Datei)	Paketname. Das verpackte .zip hat den Namen <name>_<version>.zip.
-v, --version <version>	text	1.0.0	Paketversion Erscheint im Namen der Ausgabedatei und ist der Wert, der bei --package-version an deploy run übergeben wird.
--dry-run	Markieren	aus	Führen Sie die vollständige Pipeline des Pakets (Ressourcensynchronisierung, Ausgabe der Runtime-Abhängigkeit, Validierung der Paketoption) für eine verfügbare temporäre Kopie aus und verwerfen Sie die Ausgabe. Erfasst Packzeitfehler – eine fehlende Abhängigkeit, eine fehlerhafte Ressourcenbindung, einen nicht packbaren Projekttyp – ohne ein .zip zu erzeugen oder etwas zurück in die Lösung zu schreiben. Der Inhalt des erstellten Pakets wird nicht überprüft, daher kann nicht garantiert werden, dass der Lösungsfeed das Ergebnis akzeptiert. Macht [outputPath] optional.
--login-validity <minutes>	Minuten	10	Mindestens Minuten vor dem Tokenablauf, um eine Aktualisierung auszulösen. Nur relevant, wenn die Abhängigkeitsauflösung einen Mandantenfeed erfordert.

Auflösung der Abhängigkeiten

Long	Wert	Standard	Beschreibung
--nuget-sources-config-path <path>	Pfad	–	Pfad zu einer Konfigurationsdatei für NuGet-Quellen zum Auflösen von Projektabhängigkeiten.
--exclude-configured-sources	Markieren	aus	Lösen Sie Abhängigkeiten nur aus Mandantenfeeds und --nuget-sources-config-path auf. Löscht die integrierten Feeds UiPath und nuget.org – eine Abhängigkeit, die nicht von diesen Feeds abhängt, kann nicht wiederhergestellt werden.
--feed-folder <name>	Namen oder Pfad	–	Lösen Sie Abhängigkeiten aus dem Bibliotheksfeed dieses Orchestrator-Ordners anstelle von jedem Mandantenfeed auf. Akzeptiert einen Ordnernamen oder einen vollqualifizierten Pfad.

Governance-Analyse

--skip-analyze, --governance-file-path und --automation-ops-profile steuern die Workflow-Analyse, die für jedes RPA-Projekt in der Lösung ausgeführt wird. --governance-file-path und --automation-ops-profile schließen sich gegenseitig aus.

Long	Wert	Standard	Beschreibung
--skip-analyze	Markieren	aus	Überspringen Sie die Workflow-Analyse für jedes RPA-Projekt. Kompilierung und Validierung werden weiterhin ausgeführt – nur die Analyseregeln werden übersprungen.
--governance-file-path <path>	Pfad	–	Analysieren Sie jedes RPA-Projekt anhand dieser lokalen Governance-Richtliniendatei anstelle der mit dem WorkflowCompiler gelieferten Analyseregeln.
--automation-ops-profile <profile>	text	–	Analysieren Sie jedes RPA-Projekt anhand der Governance-Richtlinie, die in AutomationOps für den angemeldeten Mandanten veröffentlicht wurde. Der Wert ist das Produkt , dessen Richtlinie heruntergeladen wird – z. B. StudioWeb, Development, Business.

Ein leerer Wert für eines der Governance-Flags (--governance-file-path "") wird als Fehler abgelehnt und nicht im Hintergrund als „kein Flag“ behandelt.

Paketsignierung

Das Signieren der .nupkg eines bereits gepackten Projekts erfordert die dotnet -CLI auf PATH.

Long	Wert	Standard	Beschreibung
--signing-certificate-path <path>	Pfad	–	Pfad zu einem .pfx -Codesignaturzertifikat. Wenn diese Option festgelegt wird, wird jedes gepackte Projekt .nupkg in der Lösung signiert, bevor es in die Lösung .zip gebündelt wird.
--signing-certificate-password <password>	Text oder env.VAR	–	Zertifikatkennwort. Übergeben Sie env.ENV_NAME, um aus einer Umgebungsvariablen anstelle des Shell-Verlaufs zu lesen.
--signing-timestamp-server <url>	URL	–	Zeitstempelserver-URL für die Signatur.

Paketmetadaten (Rückverfolgbarkeit von Quellen)

Diese Flags stempeln Metadaten zur Rückverfolgbarkeit in eine package.metadata.json -Datei im Archivstamm und in die .nuspec jedes Projekts. Keine sind erforderlich – lassen Sie sie alle weg und das Paket enthält nur den Namen, die Version und die beiden für den WorkflowCompiler erforderlichen Standardwerte (author: "UiPath", description: "Created by UiPath", wenn sie nicht überschrieben werden).

Long	Wert	Standard	Beschreibung
--author <text>	text	UiPath	Paketautor.
--description <text>	text	Created by UiPath	Paketbeschreibung.
--release-notes <text>	text	–	Versionshinweise für das Paket.
--project-url <url>	URL	–	URL der Automation Hub-Idee.
--repository-url <url>	URL	–	Quell-Repository-URL.
--repository-commit <sha>	text	–	Quell-Repository-Commit-Hash.
--repository-branch <branch>	text	–	Verzweigung des Quell-Repositorys.
--repository-type <type>	text	git (wenn --repository-url festgelegt ist)	Typ des Quell-Repositorys. Wird nur aufgezeichnet, wenn --repository-url auch festgelegt ist.

Beispiele

Minimal

uip solution pack ./my-solution ./dist

Packt die Lösung bei ./my-solution in ./dist/my-solution_1.0.0.zip (Standardversion).

Allgemein – Pin-Name und Version für einen CI-Build

uip solution pack ./my-solution ./dist --name invoices --version 1.2.0

Schreibt ./dist/invoices_1.2.0.zip.

Validieren ohne Packen

uip solution pack ./my-solution --dry-run

Führt die vollständige Pipeline des Pakets in einem temporären Verzeichnis aus und verwirft die Ausgabe – nützlich als Gateway vor der Bereitstellung in CI, da es Fehler bei der Ressourcenbindung, bei Variablenreferenzen und Laufzeitabhängigkeiten erkennt, ohne dass ein outputPath erforderlich ist.

Metadaten zur Rückverfolgbarkeit der Stempelquelle

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --repository-url https://github.com/acme/repo \
  --repository-commit abc123 \
  --repository-branch main \
  --release-notes "v1.2.0"

Signieren von gepackten Projekten

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --signing-certificate-path ./cert.pfx \
  --signing-certificate-password env.UIPATH_SIGNING_CERTIFICATE_PASSWORD \
  --signing-timestamp-server http://timestamp.digicert.com

Überspringen Sie die Workflow-Analyse

uip solution pack ./my-solution ./dist --version 1.2.0 --skip-analyze

Kompilierung und Validierung werden weiterhin ausgeführt – nur die Analyseregeln werden übersprungen.

Analysieren Sie anhand einer Mandanten-Governance-Richtlinie

uip solution pack ./my-solution ./dist --version 1.2.0 --automation-ops-profile Development

Skripting – Erfassen Sie den Ausgabepfad für den Veröffentlichungsschritt

PKG=$(uip solution pack ./my-solution ./dist --version 1.2.0 --output-filter "Data.Packages" --output plain)
uip solution publish "$PKG"

Datenform (--output json)

Echtes Paket:

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.2.0",
    "Packages": "./dist/my-solution_1.2.0.zip"
  }
}

• Package – <name>@<version> -Bezeichner für die gepackte Lösung.
• Packages – eine durch Komma getrennte Liste von .zip Pfad(en), die in <outputPath> geschrieben wurden. In der Regel ein einzelner Pfad.

Schreibtischtest (--dry-run):

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.0.0",
    "DryRun": true,
    "Status": "Valid"
  }
}

Fehlermodi

• outputPath ohne --dry-run fehlt. Fehler mit einem Anzeiger zum Bereitstellen eines Ausgabeverzeichnisses oder zum Übergeben von --dry-run.
• Konflikt-Governance-Flags. --governance-file-path und --automation-ops-profile schließen sich gegenseitig aus; Ein leerer Wert für entweder wird abgelehnt.
• Ausgabepfad innerhalb eines Mitgliedsprojektverzeichnisses. Abgelehnt – alles, was dort geschrieben wird, wird im nächsten Paket in das eigene Paket dieses Projekts gepackt. Wählen Sie einen Ausgabepfad außerhalb der Projektverzeichnisse der Lösung (z. B. ./out am Lösungsstamm oder ein Verzeichnis vollständig außerhalb der Lösung).
• Entpackbarer Projekttyp. Benennt den Projekttyp und verweist auf uip tools search / uip tools install <tool>, um das Pakettool hinzuzufügen, das ihn verarbeitet (oder uip update zuerst, wenn es sich um einen neu hinzugefügten Typ handelt).

Zugehörige Befehle

• uip solution publish – Lädt das gepackte .zip in den Lösungsfeed des Mandanten hoch.
• uip solution upload – alternativer Pfad, der die Lösung zur interaktiven Bearbeitung in Studio Web hochlädt, anstatt sie für die Bereitstellung zu packen.
• uip solution deploy run – stellt ein veröffentlichtes Paket in Orchestrator bereit.

Siehe auch

• Ihre erste Pipeline – Packen → Veröffentlichen → Bereitstellen.
• uip solution Übersicht.