As ferramentas, versões e acessos de rede que o teu computador precisa antes de instalar o IGRP Studio, e como confirmar cada um.
Antes de instalar o Studio, confirma que o teu computador tem estas ferramentas. Não precisas de verificar tudo à mão: no primeiro arranque o Doctor do Studio analisa o ambiente e mostra o que está instalado, o que falta e o link de download de cada ferramenta.
No fim desta página
Tens o Node.js, os gestores de pacotes, o JDK 26, o Docker a correr e o Git — e sabes confirmar cada um no terminal.
Ferramentas
| Ferramenta | Versão | Para quê | |
|---|---|---|---|
| Node.js | Obrigatório | 22.13+ ou 24+ | Studio, CLI e projetos frontend |
| yarn | Obrigatório | — | Gestor de pacotes que o Doctor do Studio exige |
| pnpm | Obrigatório | — | Gestor de pacotes que o igrp doctor (CLI) exige |
| Java (JDK) | Obrigatório | 26 | Projetos backend (Spring Boot) — o pom.xml gerado compila para Java 26 |
| Docker | Obrigatório | Compose v2 | Serviços do workspace (docker compose); o daemon tem de estar a correr |
| Git | Obrigatório | — | Controlo de versões |
@igrp/cli | Obrigatório | — | Instala-se no primeiro arranque, não agora |
| npm | Incluído | — | Vem com o Node.js; é com ele que se instala o CLI |
| Python + MarkItDown | Opcional | 3.10+ | Conversor de documentos para Markdown do Studio |
Não precisas de instalar o Maven: os projetos backend gerados trazem o Maven Wrapper (mvnw), que descarrega a versão certa na primeira compilação.
Confirmar no terminal
O Doctor usa estes mesmos comandos. Se algum falhar no terminal, também falha no Studio.
node -v # v22.13 ou superior (ou v24+)
yarn -v
pnpm -v
java --version # 26
docker info # sem erro = daemon a correr
docker compose version
git --version
python3 --version # opcional — 3.10 ou superiorAbre um terminal novo depois de instalar
O Studio e o terminal só veem uma ferramenta acabada de instalar depois de reabertos (o PATH é lido no arranque). Se o Doctor continuar a dar uma ferramenta como em falta, fecha e volta a abrir o Studio.
Notas por ferramenta
22.13+ (ou 24+) satisfaz o Studio e o CLI (@igrp/cli exige 22+). Evita 22.12 ou anterior: o Studio em modo de desenvolvimento recusa-a. Um gestor de versões (nvm, nvm-windows) facilita ter a versão certa e trocar entre projetos.
O Doctor do Studio exige o yarn e o igrp doctor exige o pnpm; com os dois instalados, ambas as verificações passam. Com o Node.js já instalado:
npm install -g yarn pnpmOs projetos gerados usam Spring Boot 3.5 e compilam para Java 26. Instala o JDK 26 (não chega o JRE) e confirma que java --version mostra 26 — se tiveres várias versões, o JAVA_HOME e o PATH têm de apontar para o 26. Não uses ainda o JDK 27: o Lombok incluído no Spring Boot 3.5 não compila nele.
O Studio levanta os serviços do workspace com docker compose (Compose v2, o plugin — não o antigo docker-compose). Não basta estar instalado: o Doctor corre docker info, que só responde com o Docker Desktop (Windows e macOS) ou o serviço do Docker Engine (Linux) a correr.
Só é preciso para o conversor de Markdown do Studio. Com o Python 3.10+ instalado (comando python3):
pip install "markitdown[all]"Acesso à rede
O Studio e os projetos gerados descarregam pacotes e templates dos repositórios da plataforma. O teu computador tem de chegar a:
| Endereço | Para quê |
|---|---|
sonatype.nosi.cv | Pacotes @igrp (npm), o CLI, templates do workspace e dependências Maven do framework |
storage-api.nosi.cv | Atualizações automáticas do Studio |
repo.maven.apache.org | Maven, descarregado pelo mvnw na primeira compilação |
Não precisas de credenciais para nenhum destes endereços. Se estiveres atrás de um proxy, configura-o no npm e no Maven antes de continuar — o Studio não tem configuração de proxy própria.
Por sistema operativo
Requisitos de hardware
Node.js
Instalação recomendada através do nvm-windows para gestão de versões.
Gestores de pacotes
Java Development Kit (JDK 26)
Docker
Com as ferramentas instaladas, instala o IGRP Studio.
Última atualização: