Outdated project. Going to recode with another framework.

Conversor de Unidades

Este projeto é uma aplicação Java que usa o framework Java Swing para criar a interface gráfica e o Maven para gerenciar as dependências e facilitar a build do projeto. Ele funciona como um conversor de valores para diferentes unidades, incluindo moedas. A conversão de moedas é feita em tempo real com dados da API https://api.invertexto.com/.

Interface da aplicação

Pré-requisitos

Essas instruções serão necessárias para rodar o programa ou modificá-lo.

• Comece instalando O JDK. É necessario a Java 8 (ou superior) instalada na maquina.
  No meu caso, uso Windows, então as configurações estarão focadas para Windows.
  Para mais referências sobre a instalação do Java, você pode acessar este Link.

• Após a instalação, abra o prompt de comando e digite os seguintes comandos:

java --version
javac --version

Isso verifica se a máquina consegue reconhecer o java instalado.

⚠ Se não ocorrer nenhum erro, você pode ignorar os próximos passos, pois a instalação do JDK foi realizada com sucesso.

• Definirmos uma varivel de ambiente dentro do sistema com o nome JAVA_HOME, usando o caminho da pasta onde foi instalado o JDK como valor.

setx -m JAVA_HOME "C:\<Caminho>\<do>\<nome-da-pasta-da-jdk>"

< Exemplo >
setx -m JAVA_HOME "C:\Program Files\Java\jdk-20"

• Por fim, adicionamos o diretório "bin" da pasta da JDK ao PATH do sistema, usando a variável criada anteriormente

setx -m PATH "%PATH%;%JAVA_HOME%\bin"

Instalação

1. Acesse a página de Releases do projeto no GitHub ou cliquei aqui.
2. NÃO remova o arquivo .env durante o processo de extração, pois ele vai armazenar variáveis de ambiente necessárias para o funcionamento correto da biblioteca dotenv. Sem ele o programa não abre!
3. Se for solicitado, forneça as permissões de execução para o arquivo .jar antes de tentar executar ele.

Configurando o conversor de moedas

Como mencionado anteriormente, o conversor de moedas utiliza uma API. Você precisará gerar um token aqui.
O programa em si não depende disso para funcionar!

Para gerar a token:

1. Crie uma conta no site mencionado.
2. Você será direcionado à tela de tokens. Clique no botão "criar token".
3. Você pode seguir a seguinte configuração:

4. O token vai ser gerado. Copie este token para usar no programa.

5. Selecione a unidade "Moeda" e clique no botão "Token" e insira a token gerada.

Contribuição

O projeto é de código aberto e as contribuições são bem-vindas! Se você deseja contribuir para o projeto, siga os passos abaixo:

1. Faça um fork do repositório.
2. Crie uma branch para a sua nova funcionalidade ou correção de bug.
3. Envie uma solicitação de pull para o repositório original.

Observação

Este projeto foi desenvolvido como parte do desafio proposto pela Alura em parceria com a Oracle, por meio do Programa ONE. Inicialmente, o conversor tinha o foco exclusivo na conversão de moedas. Por esse motivo, eu criei duas versões: a versão principal, que segue o modelo do desafio proposto, e a versão alternativa (alt), que foi documentada neste repositório.

A diferença da versão original é a seguinte:

1. Apenas duas opções de conversão disponíveis: Moeda e temperatura.
2. Valor de conversão de moedas é fixo.
3. Interface simplificada.

A versão original foi feita para atender aos requisitos do desafio proposto pela Alura e Oracle. Embora a versão original tenha menos funcionalidades, ela mantém a capacidade de realizar conversões monetárias.

Interface da aplicação