Trabajar en tu IDE

Inserta una aplicación codificada creada localmente en Studio Web con UiPath CLI y extrae el último origen enviado a una carpeta local cuando necesites sincronizar.

Debido a que el código fuente de una aplicación codificada se crea localmente, la mayor parte de tu trabajo se realiza en tu propio IDE. La UiPath CLI une ese flujo de trabajo local con el proyecto de Studio Web a través de dos comandos:

• uip codedapp push: carga tu aplicación creada localmente en el proyecto de Studio Web.
• uip codedapp pull: obtiene el último origen enviado desde el proyecto de Studio Web a una carpeta local.

No es necesario extraer antes de su primera inserción. Si ya tienes un proyecto local listo, empújalo directamente. Si no se proporciona ningún ID de proyecto, push solicita de forma interactiva crear un nuevo proyecto de aplicación codificada en Studio Web y guarda el UIPATH_PROJECT_ID resultante en .env para inserciones posteriores.

Requisitos previos

• Node.js 20.x o posterior.
• La UiPath CLI. Instálalo globalmente con npm install -g @uipath/cli.
• Autenticarse en la organización de UiPath de destino: uip login. Esto crea el archivo .env que la CLI lee para UIPATH_ORG_ID, UIPATH_TENANT_ID y UIPATH_ACCESS_TOKEN.
• Un proyecto de aplicación codificada ya inicializado dentro de una solución en Studio Web (o deja que push cree una de forma interactiva). Consulta Inicializar un proyecto de aplicación codificada.

Envío de su aplicación creada localmente

Desde la raíz del proyecto, después de producir la salida de la compilación (por ejemplo, npm run build), ejecuta:

uip codedapp push --project-id <project-id>

El comando carga el directorio de salida de la compilación (el valor predeterminado es dist) en el proyecto de Studio Web.

Si UIPATH_PROJECT_ID se establece en .env, ya sea a partir de una creación automática anterior o manualmente, puedes omitir el marcador:

uip codedapp push

Opciones

Opción	Descripción	Predeterminado
--project-id <id>	ID del proyecto de Studio Web.	Leer desde UIPATH_PROJECT_ID en .env. Se crea automáticamente de forma interactiva si falta.
--build-dir <dir>	Cree el directorio de salida para cargar.	dist
--ignore-resources	Omite la importación de recursos a los que hace referencia la aplicación.	false
--verbose	Mostrar registros de progreso detallados.	false

Al enviar, Studio Web:

• Almacena todos los archivos de la ruta enviada y los muestra en modo de solo lectura en la vista Origen del proyecto.
• bindings_v2.json, si está presente en la raíz del contenido enviado, y registra cada recurso declarado en el panel Recursos del proyecto.

Extraer el último origen enviado

Usa pull cuando necesites traer el último origen enviado a una carpeta local, por ejemplo, después de que un compañero de equipo haya enviado cambios, o para restablecer una copia de trabajo local:

uip codedapp pull --project-id <project-id> --target-dir ./my-coded-app

Opciones

Opción	Descripción	Predeterminado
--project-id <id>	ID del proyecto de Studio Web.	Leer desde UIPATH_PROJECT_ID en .env.
--target-dir <dir>	Directorio local en el que escribir los archivos extraídos.	Directorio actual.
--overwrite	Sobrescribir archivos existentes sin preguntar.	false
--verbose	Mostrar registros de progreso detallados.	false

El comando escribe el último contenido enviado en la carpeta de destino, exactamente como se envió.

Nota:

uip codedapp pull recupera los archivos que se enviaron, no las dependencias almacenadas localmente en caché o las herramientas de compilación. Reinstala las dependencias (por ejemplo, npm install) después de extraer antes de ejecutar la aplicación.

Trabajar con un compañero de equipo en el mismo proyecto

Los proyectos de aplicaciones codificadas no tienen un mecanismo de fusión integrado. Si dos desarrolladores insertan el mismo proyecto en paralelo, la segunda inserción sobrescribe la primera. Para coordinar de forma segura:

• Trata a Git como la fuente de verdad para el código fuente, no como el proyecto de Studio Web.
• Envía a Studio Web desde una confirmación de Git conocida, idealmente como parte de un flujo de lanzamiento controlado.
• Utiliza uip codedapp pull para inspeccionar lo que se inserta en Studio Web antes de sobrescribirlo.

Para obtener la referencia completa de CLI, consulta uip codedapp push y uip codedapp pull.