Inicialização de um projeto de aplicativo codificado

Inicialize um projeto de aplicativo codificado dentro de uma solução do Studio Web, crie o aplicativo em seu próprio projeto local e envie-o por push para o Studio Web com a UiPath CLI.

Como o código-fonte do aplicativo codificado é criado em seu IDE local, trabalhar em um projeto de aplicativo codificado no Studio Web segue duas etapas distintas: inicializar o projeto dentro de uma solução no Studio Web e, em seguida, criar e enviar seu código-fonte a partir do seu próprio projeto local.

Inicialização de um projeto de aplicativo codificado no Studio Web

Inicialize o projeto da mesma forma que você cria qualquer outro projeto do Studio Web:

1. Vá para a página Espaço de trabalho na nuvem ou Espaço de trabalho local no Studio Web.

2. No lado superior direito da página, selecione Criar novo.

3. Na caixa de diálogo Começar a criar , em Construção de blocos, selecione App.

   

4. Na tela Novo aplicativo , em Criar do zero, selecione Aplicativo codificado.

   

O Studio Web cria o projeto com um nome padrão (App, App 1, App 2 e assim por diante). Você pode renomeá-lo para algo mais significativo ou deixar o padrão inalterado.

Neste ponto, o projeto de aplicativo codificado contém um único arquivo, webAppManifest.json, que descreve o tipo e a configuração do projeto. Ainda não há código-fonte, modelo ou estrutura de suporte — você os traz de seu próprio projeto local.

Revisando o projeto no Studio Web

Após a inicialização, o Studio Web mostra o projeto de aplicativo codificado na lista de projetos da solução. Abri-la exibe a página de configuração com links para a documentação do SDK e os comandos de CLI necessários para sincronizar o código da sua IDE:

Nessa tela, você pode acessar:

• Visão geral do projeto — Nome, versão atual e a solução a que ela pertence.
• Origem — depois de enviar o código, o Studio Web mostra a última origem enviada aqui no modo somente leitura. O Studio Web não fornece um editor de código no navegador; use seu IDE local para todas as edições.
• Recursos — Depois de enviar o código que inclui um arquivo bindings_v2.json , o Studio Web mostra os recursos registrados aqui e permite que você mapeie cada recurso declarado para uma entidade do Orchestrator. Consulte Ligações e recursos de runtime.

Criação do aplicativo localmente

Para desenvolver o código-fonte do aplicativo:

1. Crie um projeto local em seu IDE usando a estrutura de sua escolha (React, Vue, Angular ou qualquer estrutura que produza ativos de navegador estáticos).
2. Crie o aplicativo com a cadeia de ferramentas da sua estrutura (por exemplo, npm run build), que produz os artefatos implantáveis que seu aplicativo servirá no runtime.

Se o aplicativo chamar recursos da UiPath no runtime, adicione um arquivo bindings_v2.json ao lado dos artefatos criados para declarar cada recurso. Consulte Ligações e recursos de runtime.

Dica:

Se você usar um agente de codificação da UiPath, invoque a habilidade uipath-coded-apps — ele estrutura o projeto, gera bindings_v2.json e o mantém em sincronização com os recursos que seu código faz referência.

Enviando o aplicativo para o Studio Web

Quando sua compilação local estiver pronta, envie-a para o projeto do Studio Web com a UiPath CLI:

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

O comando carrega o diretório de saída de compilação (padrão: dist) para o Studio Web. Substitua o diretório por --build-dir <dir> se sua estrutura for criada em outro lugar.

Se você ainda não inicializou um projeto, push solicita interativamente a criação de um para você e salva o UIPATH_PROJECT_ID resultante em .env para envios subsequentes.

Ao enviar por push, o Studio Web:

• Armazena os arquivos enviados e os mostra na visualização Origem do projeto (somente leitura).
• Lê bindings_v2.json, se presente na raiz do conteúdo enviado e registra cada recurso declarado no painel Recursos do projeto.

Para obter a referência completa da CLI e os comandos de ida e volta, consulte Trabalhando em seu IDE.