Um template é um projeto modelo para não iniciar do zero e ter pelo menos uma estrutura básica onde se apoiar.
Antes de começar a desenvolver com este template é necessário ter instalado o Java Software Development Kit (JDK), o editor Visual Studio Code (VSCode) e o utilitário de controle de versão de código Git.
É necessário instalar o JDK a partir da versão 8, porém é recomendada versão 11-LTS (Long Term Support - suporte de longo prazo).
Para o Sistema Operacional (SO) Windows, ele pode ser obtido aqui https://adoptopenjdk.net/. Siga as instruções de instalação e não esqueça de selecionar os opcionais durante o processo, especialmente a parte
Para Sistemas Operacionais Linux/Debian, como Ubuntu, Pop OS, Mint, Elementary, etc, execute no terminal o comando sudo apt install openjdk-11-jdk
, que a mágica vai acontecer.
Para testar a instalação, seja no Windows ou Linux, abra o Prompt de Comando (cmd) ou o Terminal e execute o compilador Java com javac -version
. A saída deve ser algo com javac 11.0.9.1
, ou outra versão.
O VSCode pode ser obtido aqui: https://code.visualstudio.com/download. A instalação é semelhante nos Sistemas Operacionais Windows e Linux.
No Windows, abra o instalador e não esqueça de selecionar todos os opcionais, como adicionar code ao path e adicionar "abrir com code" ao menu, por exemplo.
No Linux, abra o arquivo .deb
baixado no gerenciador de pacotes e instale normalmente conforme instruções de seu sistema operacional.
Este template possui uma pasta .vscode com as extensões necessárias em extensions.json e as configurações recomendadas em settings.json para um ambiente de ensino (config didática). Fique a vontade para alterá-los como achar melhor.
A única extensão obrigatória é a "vscjava.vscode-java-pack".
A extensão "EditorConfig" é bastante recomendada. Ela funciona junto com o arquivo .editorconfig presente neste template para padronizar a formatação dos códigos-fonte.
Finalmente, se preferes o editor em Português, instale a extensão Portuguese (Brazil) Language Pack for Visual Studio Code.
O Git para Windows pode ser obtido neste link: https://git-scm.com/download/win. A instalação é simples e intuitiva. Como sempre, não esqueça dos opcionais, principalmente a opção adicionar o git ao path!
Para Linux, o comando sudo apt install git
no terminal faz tudo.
Para verificar a instalação abra o prompt ou um terminal e execute git --version
. Se não acusou "comando não encontrado" é porque está tudo funcionando perfeitamente.
Com tudo isto pronto deve ser possível abrir o arquivo App.java e clicar em run
para executar o projeto, conforme imagem a seguir:
Se quiser compilar e executar manualmente, abra um prompt/terminal, pode ser o terminal embutido do VSCode, e na pasta raiz do projeto execute os comandos javac -cp bin -d bin src/App.java; java -cp bin App
, conforme imagem a seguir:
Este template é open source licenciado sob a GPL, assim como todos os projetos derivados dele. Mais detalhes em LICENÇA.md.