paquete de soluciones de uip

Sintaxis y opciones para el `paquete de soluciones uip`, que produce un `.zip` implementable desde un directorio de soluciones o un archivo de paquete `.uis`.

uip solution pack produce un paquete .zip implementable a partir de un directorio de soluciones (que contiene un manifiesto .uipx ) o desde un archivo de paquete .uis . El archivo resultante es lo que uip solution publish carga en la fuente del tenant, que uip solution deploy run puede implementar.

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.

Sinopsis

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>]

El comando respeta las opciones globales y devuelve los códigos de salida estándar.

Argumentos

• <solutionPath> (obligatorio) : ruta a un directorio de soluciones (que contiene un manifiesto .uipx ) o un archivo .uis .
• (opcional) : directorio de salida donde se escribirá .zip [outputPath] Obligatorio a menos que se establezca --dry-run : omitirlo sin --dry-run falla con un puntero para añadir uno u otro.

Opciones

Núcleo

Largo	Valor	Predeterminado	Descripción
-n, --name <name>	text	nombre de la carpeta de la solución (o el nombre base del archivo .uis)	Nombre del paquete. El .zip empaquetado se llama <name>_<version>.zip.
-v, --version <version>	text	1.0.0	Versión del paquete. Aparece en el nombre del archivo de salida y es el valor pasado a --package-version el deploy run.
--dry-run	Marca	Desactivado	Ejecuta el proceso de paquete completo (sincronización de recursos, emisión de dependencia de runtime, validación de opciones de empaquetador) en una copia temporal desechable y descarta la salida. Captura los fallos en el tiempo de empaquetado (una dependencia que falta, una vinculación de recursos rota, un tipo de proyecto desempaquetable) sin producir un .zip ni escribir nada en la solución. No inspecciona el contenido del paquete producido, por lo que no puede garantizar que la fuente de la solución acepte el resultado. Hace que [outputPath] sea opcional.
--login-validity <minutes>	minutos	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.

Resolución de dependencias

Largo	Valor	Predeterminado	Descripción
--nuget-sources-config-path <path>	Ruta	—	Ruta a un archivo de configuración de fuentes de NuGet para resolver dependencias del proyecto.
--exclude-configured-sources	Marca	Desactivado	Resuelve las dependencias solo desde las fuentes del tenant y --nuget-sources-config-path. Elimina las fuentes integradas de UiPath y nuget.org: una dependencia que no esté en esas fuentes no se restaurará.
--feed-folder <name>	nombre o ruta	—	Resuelva las dependencias de la fuente de la biblioteca de esta carpeta de Orchestrator en lugar de cada fuente de tenant. Acepta un nombre de carpeta o una ruta completa.

Análisis de gobernanza

--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.

Largo	Valor	Predeterminado	Descripción
--skip-analyze	Marca	Desactivado	Omite el analizador de flujo de trabajo para cada proyecto de RPA. La compilación y la validación se siguen ejecutando: solo se omiten las reglas del analizador.
--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>	Ruta	—	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	—	Analiza cada proyecto de RPA en comparación con la política de gobernanza publicada en AutomationOps para el tenant que ha iniciado sesión. El valor es el producto cuya política se descarga; por ejemplo, StudioWeb, Development, Business.

Un valor vacío para cualquiera de los marcadores de control (--governance-file-path "") se rechaza como un error, no se trata de forma silenciosa como "sin marcador";

Firma de paquetes

La firma de .nupkg de un proyecto ya empaquetado requiere la CLI dotnet en PATH.

Largo	Valor	Predeterminado	Descripción
--signing-certificate-path <path>	Ruta	—	Ruta a un certificado de firma de código .pfx. Cuando se establece, cada proyecto empaquetado .nupkg en la solución se firma antes de incluirse en la solución .zip.
--signing-certificate-password <password>	texto o env.VAR	—	Contraseña del certificado. Pasa env.ENV_NAME para leer desde una variable de entorno en lugar del historial del shell.
--signing-timestamp-server <url>	URL	—	URL del servidor de marca de tiempo para la firma.

Metadatos del paquete (trazabilidad de origen)

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.

Largo	Valor	Predeterminado	Descripción
--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	—	Notas de la versión del paquete.
--project-url <url>	URL	—	URL de la idea de Automation Hub.
--repository-url <url>	URL	—	URL del repositorio de origen.
--repository-commit <sha>	text	—	Hash de confirmación del repositorio de origen.
--repository-branch <branch>	text	—	Rama del repositorio de origen.
--repository-type <type>	text	git (cuando se establece --repository-url)	Tipo de repositorio de origen. Solo se registra cuando --repository-url también está establecido.

Ejemplos

Mínimo

uip solution pack ./my-solution ./dist

Empaqueta la solución en ./my-solution en ./dist/my-solution_1.0.0.zip (versión predeterminada).

Común: nombre de pin y versión para una compilación de CI

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

Escribe ./dist/invoices_1.2.0.zip.

Validar sin empaquetar

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

Ejecuta el proceso de paquete completo en un directorio temporal y descarta la salida: útil como puerta previa a la implementación en CI, ya que detecta errores de vinculación de recursos, referencia de variables y dependencia de runtime sin necesidad de un outputPath.

Marcar metadatos de trazabilidad de origen

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"

Firmar proyectos empaquetados

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

Omitir el analizador de flujo de trabajo

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

La compilación y la validación se siguen ejecutando: solo se omiten las reglas del analizador.

Analizar contra una política de gobernanza de tenant

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.

Creación de scripts: captura la ruta de salida para el paso de publicación

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

Forma de datos (--json de salida)

Paquete real:

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

• Package — identificador de <name>@<version> para la solución empaquetada.
• Packages — lista separada por comas de .zip rutas escritas en <outputPath>. Normalmente, una única ruta.

Ejecución en seco (--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:

Campo	Descripción
Path	The project directory, relative to the solution directory, with forward slashes.
Type	The project type.
Result	Success o 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.

Tipos de proyectos

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

Tipo de proyecto	Pack behavior
Flujo	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.
Reglas empresariales	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.

Modos de fallo

• Falta outputPath sin --dry-run. Falla con un puntero para proporcionar un directorio de salida o pasar --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.
• Ruta de salida dentro de un directorio de proyecto miembro. Rechazado: cualquier cosa escrita allí se empaquetaría en el propio paquete de ese proyecto en el siguiente paquete. Elige una ruta de salida fuera de los directorios del proyecto de la solución (por ejemplo, ./out en la raíz de la solución o un directorio completamente fuera de la solución).
• Tipo de proyecto no empaquetable. Nombra el tipo de proyecto y apunta a uip tools search / uip tools install <tool> para añadir la herramienta de empaquetado que lo gestiona (o uip update primero, si es un tipo recién añadido).

Comandos relacionados

• uip solution publish : carga el .zip empaquetado en la fuente de soluciones del tenant.
• uip solution upload : ruta alternativa que carga la solución a Studio Web para la edición interactiva en lugar de empaquetarla para la implementación.
• uip solution deploy run : implementa un paquete publicado en Orchestrator.

Ver también

• Tu primer proceso : empaquetar → publicar → implementar tutorial de ejecución.
• Información generaluip solution .