projeto da solução uip

uip solution project gerencia os projetos listados dentro de um manifesto da solução .uipx — fluxos de trabalho, casos de teste, bibliotecas, agentes, fluxos do Maestro e apps. Três subcomandos estão disponíveis:

Subcomando	Finalidade
add	Registre uma pasta do projeto que já está dentro do diretório da solução.
import	Copie uma pasta de projeto externa no diretório da solução e, em seguida, registre-a.
remove	Cancela o registro de um projeto de .uipx (não exclui arquivos no disco).

Todos os três subcomandos operam apenas em arquivos locais; nenhuma autenticação é necessária.

Resumo

uip solution project add <projectPath> [solutionFile]
uip solution project import --source <path> [--solutionFile <path>]
uip solution project remove <projectPath> [solutionFile]

Cada subcomando honra as opções globais e retorna os códigos de saída padrão.

Comportamento comum

• A pasta do projeto de destino deve conter um descritor project.uiproj ou um project.json legado. O comando detecta automaticamente qual.
• Quando é <solutionFile> , o comando pesquisa para cima do caminho do projeto (ou do diretório atual, para import) para o mais .uipx. Se nenhum for encontrado ou se vários arquivos .uipx estiverem na mesma pasta, o comando falhará com um erro descritivo e sairá com 1.
• Um Id (UUID) exclusivo é gerado para cada entrada de projeto adicionada ao manifesto.

---

adição de projeto da solução uip

Registre uma pasta do projeto que já reside dentro do diretório da solução. O caminho relativo da pasta do projeto é registrado em .uipx, e uma entrada correspondente é provisionada no construtor de recursos interno da solução.

Argumentos

• <projectPath> necessário) — Caminho para a pasta do projeto. Deve conter project.uiproj ou project.json.
• [solutionFile] (opcional) — Caminho para o manifesto da solução .uipx . Se omitido, o .uipx mais próximo será localizado percorrendo a partir de <projectPath>.

Opções

Nenhuma além das opções globais.

Exemplos

Mínimo

uip solution project add ./my-solution/my-project ./my-solution/my-solution.uipx

Detectar automaticamente o .uipx

uip solution project add ./my-solution/my-project

Scripting — adicionar e, em seguida, empacotar em um pipeline

uip solution project add ./my-solution/my-project
uip solution pack ./my-solution ./dist --version 1.0.0

Formato dos dados (--output json)

{
  "Code": "ProjectAdd",
  "Data": {
    "Status": "Added successfully",
    "Project": "my-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Modos de falha

• O projeto está fora da pasta da solução. O comando recusa a adição com um ponteiro para project import, que copia projetos externos.
• O projeto já está registrado. Sai com 1 e uma mensagem nomeando o ProjectRelativePath existente.

---

importação do projeto da solução uip

Copie uma pasta de projeto externa no diretório da solução (preservando o nome de sua pasta) e, em seguida, registre-a .uipx. Use isso quando o projeto que você deseja incluir já não estiver na raiz da solução.

Opções

• --source <path> necessário) — Caminho para a pasta do projeto externo a ser importada. Deve ser um diretório contendo project.uiproj ou project.json.
• --solutionFile <path> (opcional) — Caminho para o manifesto da solução .uipx . O padrão para o .uipx mais próximo encontrado ao caminho do diretório de trabalho atual.

Exemplos

Comum

uip solution project import \
  --source ./external-project \
  --solutionFile ./my-solution/my-solution.uipx

De dentro do diretório da solução (detecção automática .uipx)

cd ./my-solution
uip solution project import --source ../shared-library

Formato dos dados (--output json)

{
  "Code": "ProjectImport",
  "Data": {
    "Status": "Imported successfully",
    "Project": "external-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Modos de falha e reversão

• A pasta de destino já existe. O comando recusa-se a substituir; renomeie primeiro a pasta de origem ou remova o destino existente.
• O projeto já está no manifesto .uipx . Recusado antes que quaisquer arquivos sejam copiados.
• A etapa de cópia, gravação ou construtor falha. O comando reverte — o diretório copiado é removido e .uipx é restaurado para seu conteúdo original.

---

remoção do projeto da solução uip

Cancelar o registro de um projeto do manifesto da solução .uipx e solte sua entrada do construtor de recursos interno. Os arquivos no disco não são excluídos.

Argumentos

• <projectPath> necessário) — Caminho para a pasta do projeto a ser removida. Deve estar registrado no .uipx.
• [solutionFile] (opcional) — Caminho para o manifesto da solução .uipx . O padrão para o .uipx mais próximo encontrado <projectPath>.

Exemplos

Mínimo

uip solution project remove ./my-solution/my-project ./my-solution/my-solution.uipx

Script — remover vários projetos

for p in project-a project-b project-c; do
  uip solution project remove "./my-solution/$p" || true
done

Formato dos dados (--output json)

{
  "Code": "ProjectRemove",
  "Data": {
    "Status": "Removed successfully",
    "Project": "my-project",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Modos de falha

• O projeto está fora da pasta da solução. O caminho relativo não deve começar com ...
• O projeto não está no manifesto. Sai com 1 e o caminho relativo usado na pesquisa.

---

Comandos relacionados

• uip solution new — estruturar a solução antes de adicionar projetos.
• uip solution resource refresh — sincronize novamente recursos após editar as associações do projeto.
• uip solution pack — empacote a solução assim que sua lista de projetos for finalizada.

Veja também

• Seu primeiro pipeline — exemplo de ponta a ponta.
• uip solution visão geral.