Criação e implantação de aplicativos codificados

Crie e implante um aplicativo codificado no UiPath: o que você precisa antes de começar, como o aplicativo é criado em um IDE e como publicá-lo e implantá-lo em uma pasta do Orchestrator.

Um aplicativo codificado começa como um aplicativo da Web que um desenvolvedor escreve em seu próprio IDE e termina como um aplicativo que seus usuários abrem a partir de um URL da UiPath. Esta página descreve essa jornada e as etapas de implantação que ocorrem no UiPath.

O processo inclui quatro etapas:

1. Definição da lógica do aplicativo em um IDE.
2. Estabelecendo uma conexão segura com a UiPath.
3. Implantando o aplicativo no Orchestrator.
4. Acessando o aplicativo dentro do ecossistema da UiPath.

Antes de começar

Importante:

No Automation Cloud Dedicado e Test Cloud Dedicado, use a versão 1.202.0 da UiPath CLI para as etapas pack, publish, deploy e push até que seu ambiente de produção Dedicado seja atualizado para a versão Apps datada de 24 de setembro de 2026. Versões posteriores da CLI contêm alterações importantes que são incompatíveis com a versão do Apps atualmente executada em ambientes dedicados. Depois que seu Ambiente de produção dedicado for atualizado para a versão do Apps de 24 de setembro de 2026, você poderá usar versões mais recentes do UiPath CLI.

Para solucionar problemas, consulte Por que os comandos uip codedapp falham no Automation Cloud Dedicado?.

Certifique-se de que o seguinte esteja implementado:

• Um ambiente de desenvolvimento local com Node.js 20.x ou mais recente e npm, usado para criar o aplicativo e instalar as ferramentas da UiPath. Baixe o instalador do nodejs.org, que inclui o npm. Para verificar o que já está instalado, execute node -v e npm -v.
• O UiPath CLI, com a ferramenta codedapp instalada. Para obter instruções de instalação, consulte o guia do UiPath CLI .
• Um ID de aplicativo externo de um aplicativo externo registrado em sua organização. O aplicativo o usa para fazer login dos usuários e chamar os serviços da UiPath em nome deles. Um aplicativo codificado é executado no navegador e não pode armazenar um segredo do aplicativo; portanto, registre-o como um aplicativo não confidencial com escopos de usuário. Para registrar um, consulte Adicionando um aplicativo externo na guia de administrador do Automation Cloud.
• Permissão para publicar pacotes e implantar aplicativos na pasta do Orchestrator que você está segmentando.

Crie o aplicativo

O desenvolvedor cria o aplicativo da mesma forma que construiria qualquer aplicativo da Web, na estrutura de sua escolha, como React, Vue ou Angular. A UiPath adiciona duas coisas a esse fluxo de trabalho:

• Uma conexão com sua organização. Um arquivo de configuração na raiz do projeto identifica sua organização, tenant e ID do aplicativo externo. O UiPath TypeScript SDK lê essa configuração, para que o aplicativo possa chamar serviços da UiPath, como Orchestrator, ativos, buckets de armazenamento e processos.
• Uma configuração de desenvolvimento local. Um plug-in da UiPath para a ferramenta de compilação do projeto fornece a mesma configuração enquanto o aplicativo é executado na máquina do desenvolvedor, para que o aplicativo possa ser testado em um tenant real antes de ser implantado.

Ambos são uma configuração única por projeto. Para obter a configuração completa do desenvolvedor, incluindo o arquivo de configuração, o plug-in da ferramenta de compilação e os ajustes de que o aplicativo precisa antes de ser empacotado, consulte Introdução ao Apps codificados na documentação do SDK.

Implantar o aplicativo

A implantação acontece em duas partes: o desenvolvedor empacota e publica o aplicativo e, em seguida, você implanta esse pacote para uma pasta do Orchestrator.

Empacotar e publicar o aplicativo

Um aplicativo codificado é publicado no Orchestrator como um pacote .nupkg , o mesmo formato de pacote usado para automações.

1. Crie o aplicativo:

   npm run build
   

2. Empacote a saída da compilação:

   uip codedapp pack dist -n <appName> --version 1.0.0
   

3. Faça login em sua organização do UiPath:

   uip login
   

4. Publique o pacote em um feed de tenant ou em um feed de espaço de trabalho pessoal:

   uip codedapp publish
   

5. Implante o aplicativo:

   uip codedapp deploy
   

Para obter a lista completa de argumentos de cada comando, consulte uip codedapp no guia da UiPath CLI.

Implantar o aplicativo do Orchestrator

Se o pacote já tiver sido publicado ou se você preferir não usar a linha de comando, implante o aplicativo a partir do Orchestrator.

1. No Orchestrator, acesse Tenant > Pacotes.
2. Selecione Carregar e carregue o arquivo .nupkg criado por uip codedapp pack. Para obter o procedimento detalhado, consulte Gerenciamento de pacotes.
3. Acesse a pasta na qual você deseja implantar o aplicativo e acesse Automações > Apps.
4. Selecione Implantar aplicativo e, em seguida, selecione seu aplicativo e sua versão. Para obter o procedimento detalhado, consulte Gerenciamento de aplicativos.

Implantar o aplicativo do Studio Web

Se o aplicativo for criado como um projeto de aplicativo codificado dentro de uma solução do Studio Web, ele será empacotado e implantado junto com essa solução, em vez de sozinho. A versão do aplicativo codificado permanece em dia com os fluxos de trabalho, agentes e recursos dos quais ele depende.

1. Crie o aplicativo localmente e, em seguida, envie-o para o projeto do Studio Web:

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

2. No Studio Web, abra a solução e selecione Implantar.

3. Defina a versão do pacote, escolha se deseja empacotar em seu espaço de trabalho pessoal ou em um compartilhado, nomeie a implantação, selecione a pasta e selecione Implantar.

Para obter o conjunto completo de opções no painel de implantação, consulte Publicação e implantação de soluções no guia do usuário do Studio Web.

Seu aplicativo agora está disponível em https://<orgName>.uipath.host/<appName>.