Documentação / Primeiros passos
Seu primeiro projeto
Abra uma pasta, deixe o Yuli indexá-la, decida a confiança e execute a aplicação pela primeira vez.
Este guia leva você de um IDE recém-instalado até a sua aplicação rodando, em cinco passos.
1. Abra o projeto
No menu Arquivo:
| Opção | Quando |
|---|---|
| Abrir projeto… | O projeto está no seu computador. |
| Abrir pasta… | Você quer abrir qualquer pasta. |
| Clonar repositório… | O projeto está no GitHub, GitLab ou em outro remoto. |
| Projetos recentes | Você já o abriu antes (Alt+3). |
| Novo projeto a partir de modelo… | Você está começando um novo. |
Cada projeto abre em sua própria aba, abaixo da barra de título. Você pode ter vários abertos e ver dois ao mesmo tempo com Visão dividida: ver dois projetos ao mesmo tempo.
2. Decida a confiança
Na primeira vez, o Yuli pergunta “Você confia neste projeto?”.
| Opção | O que faz | Quando escolher |
|---|---|---|
| Confiar | Executa o Lombok e o Maven/Gradle do projeto para uma análise completa. | Projetos seus ou da sua equipe. |
| Modo restrito | Não executa código do repositório. Analisa com o que consegue ler. | Código que você não conhece. |
Você pode mudar isso depois em Opções globais → Segurança → Projetos confiáveis.
3. Deixe indexar
O Yuli analisa o projeto em segundo plano. Uma barra fina na parte superior do editor mostra o progresso:
- “Preparando inteligência de código…”
- “Indexando o projeto…”
- “Resolvendo dependências e analisando…”
Você pode continuar editando enquanto isso. Referências, navegação e diagramas estarão completos ao terminar.
O Yuli detecta o tipo de projeto: Maven, Gradle, Ant, Eclipse, npm ou Cargo. Se faltar um JDK, Maven ou Gradle, ele oferece o download.
4. Conheça a interface
| Zona | O que há |
|---|---|
| Esquerda | O projeto: arquivos, Git e a configuração do agente. |
| Centro | O chat com a IA. |
| Direita | O editor e suas abas. |
| Embaixo | Terminal, Execução, Problemas, Testes e Qualidade. |
Detalhes em As três zonas.
5. Execute
Você tem três caminhos:
- Na tela inicial, Executar e testar.
Shift+F10executa a última configuração;Shift+F9a depura.- Peça ao agente: “Inicie a aplicação e me diga em qual porta ela ficou”.
A saída aparece no painel Execução. As linhas de stack trace do projeto e cada Archivo.java:42 levam ao arquivo e à linha.
Para criar ou ajustar configurações (variáveis de ambiente, perfis do Spring, opções da JVM), use Projeto → Build, execução e depuração…. Veja Executar e depurar.
Testes
Ctrl+Shift+F10executa todos os testes.Ctrl+Shift+F11os executa com cobertura.Ctrl+F9compila o projeto.
Os resultados aparecem em Testes e a cobertura, na margem do editor.
Próximo passo
Conecte uma IA e peça sua primeira tarefa. Um bom primeiro teste:
“Explique a arquitetura deste projeto e onde está a principal lógica de negócio.”