Como configurar o Java e executar arquivos .JAR no Linux corretamente

⚠️ Usamos o brModelo para teste -> https://www.sis4.com/brModelo/download.html

Arquivos .jar são aplicações Java empacotadas que podem rodar em qualquer sistema operacional, desde que o Java esteja corretamente instalado e configurado. Apesar disso, muitos usuários encontram erros comuns ao tentar executar esses arquivos, especialmente quando colocam o .jar diretamente na Área de Trabalho.

Neste artigo, você vai aprender do zero como configurar o ambiente Java no Linux e executar arquivos .jar da forma correta, evitando erros como ClassNotFoundException e Unable to access jarfile.

O que é um arquivo .JAR?

Um arquivo .jar (Java ARchive) é um pacote que contém:

• Código compilado (.class)

• Bibliotecas internas

• Um arquivo MANIFEST.MF que indica qual é a classe principal da aplicação

Ele funciona como um executável Java.

Passo 1 – Instalar o Java corretamente

Antes de tudo, é necessário ter o Java Runtime Environment (JRE) instalado.

Verificar se o Java já está instalado

Abra o terminal e execute:

java -version

Se aparecer a versão, o Java já está disponível.

Instalar Java no Linux (Ubuntu, Debian, Mint)

sudo apt update
sudo apt install default-jre

Para desenvolvimento (opcional):

sudo apt install default-jdk

Passo 2 – Entendendo o erro mais comum

Um erro muito frequente é:

Erro: Não foi possível localizar nem carregar a classe principal brModelo.jar
Causada por: java.lang.ClassNotFoundException: brModelo.jar

Por que esse erro acontece?

Porque o comando foi executado sem o parâmetro -jar.Nesse caso, o Java tenta interpretar brModelo.jar como se fosse o nome de uma classe, e não de um arquivo.

Forma correta de executar um arquivo .JAR

❌ Forma incorreta

java brModelo.jar

✅ Forma correta

java -jar brModelo.jar

O parâmetro -jar informa ao Java que ele deve executar um arquivo JAR, lendo a classe principal definida no manifesto.

Passo 3 – Executando um .JAR que está na Área de Trabalho

Quando o arquivo está na Área de Trabalho, o comando correto é:

cd ~"Área de trabalho"
java -jar brModelo.jar

Ou, usando caminho absoluto (forma mais segura):

java -jar /home/seu_usuario/Área\ de\ Trabalho/brModelo.jar

Dica profissional: sempre use caminho absoluto

Para evitar problemas de permissões, variáveis de ambiente e atalhos gráficos, o ideal é usar:

/usr/bin/java -jar /opt/brModelo/brModelo.jar

Isso garante compatibilidade em qualquer ambiente Linux.

Passo 4 – Tornar o .JAR executável (opcional)

Você pode permitir a execução direta:

chmod +x brModelo.jar

Depois:

./brModelo.jar

⚠️ Isso só funciona se o JAR tiver um Main-Class definido no MANIFEST.MF.

Passo 5 – Executar com duplo clique (interface gráfica)

1. Clique com o botão direito no arquivo .jar

2. Vá em Propriedades

3. Aba Permissões

4. Marque Permitir executar como programa

5. Dê duplo clique e escolha Executar