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.

Pack is an offline operation — it does not contact Orchestrator except to resolve NuGet dependencies from tenant feeds (or an Orchestrator folder's library feed via --feed-folder), and does not contact AutomationOps except when a governance flag or --ignored-rules is passed while you are signed in — so it is safe to run inside build steps that do not yet have full credentials, as long as dependency resolution is covered.

Zusammenfassung

uip solution pack <solutionPath> [outputPath] \
  [--name <name>] [--version <version>] \
  [--dry-run] \
  [--skip-analyze] [--ignored-rules <rules>] [--governance-file-path <path>] [--governance-product <product>] \
  [--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	Minimum minutes before token expiration to trigger a refresh. Only relevant when dependency resolution needs a tenant feed, or when the tenant's governance policy is checked.

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, --ignored-rules, --governance-file-path, and --governance-product control the workflow analyzer that runs against every RPA project in the solution. The flags can be combined.

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.
--ignored-rules <rules>	comma-separated rule IDs	–	Analyzer rule IDs whose findings are ignored for every RPA project, for example ST-USG-034,ST-MRD-002. Repeat the flag to add more. The rules still run, but their findings are not reported and do not fail the pack. Applies on top of --governance-file-path or the shipped rules. When the signed-in tenant publishes an AutomationOps policy, the list is not applied and a warning says so.
--governance-file-path <path>	Pfad	–	Analyze every RPA project against this local governance policy file instead of the analyzer rules shipped with the WorkflowCompiler. Accepts a policy exported from AutomationOps or a Studio rules-configuration file. When you are signed in, the tenant is asked first (about StudioWeb, unless --governance-product names another product). When the tenant publishes a policy of its own, that policy is used, this file is ignored with a warning, and the pack continues. When the tenant publishes no policy, when it cannot be asked, or when its policy service does not answer, this file is used. The file is read before the tenant is asked, so an unreadable or non-JSON file fails the pack in every case.
--governance-product <product>	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)

These flags stamp traceability metadata into a package.metadata.json file at the archive root and into each project's .nuspec. None are required. When --author or --description is omitted, each member project keeps the value its own project file declares, and falls back to UiPath / Created by UiPath when it declares none.

Long	Wert	Standard	Beschreibung
--author <text>	text	each project's own author, else UiPath	Package author. When set, applies to every member project.
--description <text>	text	each project's own description, else Created by UiPath	Package description. When set, applies to every member project.
--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 --governance-product Development

Ignore specific analyzer rules

uip solution pack ./my-solution ./dist --version 1.2.0 --ignored-rules ST-USG-034,ST-MRD-002

The rules still run, but their findings do not fail the pack. The list is not applied when the tenant publishes an AutomationOps policy.

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

PKG=$(uip solution pack ./my-solution ./dist --version 1.2.0 --output-filter "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"
  }
}

When the pack fails and the packager reports per-project results, the failure envelope carries Data.Projects, one entry per member project:

Feld	Beschreibung
Path	The project directory, relative to the solution directory, with forward slashes.
Type	The project type.
Result	Success oder Failure.
Message	The project's result message, when it has one.
Findings	The project's findings. Each finding can carry Level, Source (Other, Analyzer, Validator, or Compiler), ErrorCode, RuleName, Description, FilePath, ActivityIdRef, and DocumentationLink.

Data.Projects is omitted when the failure belongs to no project.

Projekttypen

Pack hands each member project to the packager tool for its project type. Some project types have their own pack behavior:

Projekttyp	Pack behavior
Flow	The .flow file is checked against the Maestro designer's validation rules. A flow with errors fails the pack. Every issue, warnings included, is reported as a finding, with ActivityIdRef naming the node.
Geschäftsregeln	Packed as a .uirule archive named <rule-name>-<version>.uirule, holding the rule's .dmn files and an entry-points.json derived from them.
Data Fabric entities	Validated only: pack checks that every entity definition is intact and its schema is valid. The entity definition resources are the deployable payload, so no separate package is produced for the project.

Fehlermodi

• outputPath ohne --dry-run fehlt. Fehler mit einem Anzeiger zum Bereitstellen eines Ausgabeverzeichnisses oder zum Übergeben von --dry-run.
• Empty governance flag value. An empty value for --governance-file-path or --governance-product is rejected.
• Unusable governance policy file. A --governance-file-path file that cannot be read or is not JSON fails the pack. So does a file that holds only the inner policy of an AutomationOps export; pass the exported file as-is.
• Member package ID collision. A member's package ID is composed as <solution>.<project-type>.<member-folder>, capped at 100 characters, and must be unique across the solution. Spaces and dots collapse to a single dot, and IDs are compared case-insensitively. When two members compose the same ID, the pack fails with ErrorCode: invalid_argument, naming the ID and the folders that produced it. The <solution> part is the .uipx file's own name; --name renames the archive only and does not change member IDs. Rename the member folder or the .uipx, then pack again.
• Project failure. A project that fails compilation, validation, or analysis fails the pack. Data.Projects names the project and its findings.
• 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.