Trabalhando em seu IDE

Envie um aplicativo codificado criado localmente para o Studio Web com a UiPath CLI, e traga a última origem enviada de volta para uma pasta local quando precisar sincronizar.

Como o código-fonte de um aplicativo codificado é criado localmente, a maior parte do seu trabalho acontece em seu próprio IDE. A UiPath CLI une esse fluxo de trabalho local com o projeto do Studio Web por meio de dois comandos:

• uip codedapp push — carregue seu aplicativo criado localmente para o projeto do Studio Web.
• uip codedapp pull — buscar a última origem enviada do projeto do Studio Web para uma pasta local.

Você não precisa puxar antes de seu primeiro push. Se você já tiver um projeto local pronto, envie-o diretamente. Se nenhuma ID do projeto for fornecida, push solicitará interativamente a criação de um novo projeto de aplicativo codificado no Studio Web e salvará o UIPATH_PROJECT_ID resultante em .env para push posterior.

Pré-requisitos

• Node.js 20.x ou mais recente.
• A UiPath CLI. Instale-o globalmente com npm install -g @uipath/cli.
• Autenticar na organização da UiPath de destino: uip login. Isso cria o arquivo .env que a CLI lê para UIPATH_ORG_ID, UIPATH_TENANT_ID e UIPATH_ACCESS_TOKEN.
• Um projeto de aplicativo codificado já foi inicializado dentro de uma solução no Studio Web (ou deixe push criar um interativamente). Consulte Inicialização de um projeto de aplicativo codificado.

Envio de seu aplicativo criado localmente

Na raiz do projeto, após produzir a saída da compilação (por exemplo, npm run build), execute:

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

O comando carrega o diretório de saída de compilação (padrão para dist) para o projeto do Studio Web.

Se UIPATH_PROJECT_ID estiver definido em .env — a partir de uma criação automática anterior ou manualmente — você poderá omitir o sinalizador:

uip codedapp push

Opções

Opção	Description	Padrão
--project-id <id>	ID do projeto do Studio Web.	Leia de UIPATH_PROJECT_ID em .env. Criado automaticamente de forma interativa se ausente.
--build-dir <dir>	Crie um diretório de saída para carregar.	dist
--ignore-resources	Ignore a importação de recursos referenciados pelo aplicativo.	false
--verbose	Mostre logs de progresso detalhados.	false

Ao enviar por push, o Studio Web:

• Armazena todos os arquivos no caminho enviado e os exibe em modo somente leitura na visualização Origem do projeto.
• Lê bindings_v2.json, se presente na raiz do conteúdo enviado e registra cada recurso declarado no painel Recursos do projeto.

Extraindo a última origem enviada

Use pull quando você precisar trazer a última origem enviada de volta para uma pasta local — por exemplo, depois que um colega de equipe enviou alterações ou para redefinir uma cópia de trabalho local:

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

Opções

Opção	Description	Padrão
--project-id <id>	ID do projeto do Studio Web.	Leia de UIPATH_PROJECT_ID em .env.
--target-dir <dir>	Diretório local no qual gravar arquivos extraídos.	Diretório atual.
--overwrite	Substitua arquivos existentes sem solicitar.	false
--verbose	Mostre logs de progresso detalhados.	false

O comando grava o último conteúdo enviado na pasta de destino, exatamente como foi enviado.

Observação:

uip codedapp pull recupera os arquivos que foram enviados, não quaisquer dependências armazenadas em cache localmente ou ferramentas de compilação. Reinstale dependências (por exemplo, npm install) após extrair antes de executar o aplicativo.

Trabalhando com um colega de equipe no mesmo projeto

Os projetos de aplicativos codificados não têm um mecanismo de mesclagem integrado. Se dois desenvolvedores enviarem para o mesmo projeto em paralelo, o segundo push substituirá o primeiro. Para coordenar com segurança:

• Trate o Git como a fonte da verdade para o código-fonte, não o projeto do Studio Web.
• Envie para o Studio Web a partir de uma confirmação do Git conhecida, idealmente como parte de um fluxo de versão controlado.
• Use uip codedapp pull para inspecionar o que é enviado no Studio Web antes de substituí-lo.

Para obter a referência completa da CLI, consulte uip codedapp push e uip codedapp pull.