/clock-desktop-javafx

Clock | Desktop | JavaFX

Primary LanguageJavaMIT LicenseMIT

Clock para Desktop em JavaFX

Um projeto de relógio para desktop desenvolvido em JavaFX, projetado para fins de aprendizado e prática com o biblioteca gráfica JavaFX. O aplicativo oferece duas visões de relógio: digital e analógico, com uma interface gráfica simples e interativa. O projeto utiliza o Maven para gerenciamento de dependências e facilitar a compilação e execução.

Funcionalidades

  • Modo Digital: Exibe a hora atual em formato digital.
  • Modo Analógico: Exibe a hora atual em formato analógico com ponteiros para horas, minutos e segundos.
  • Alternância de Modos: Permite alternar entre a visualização digital e analógica do relógio.
  • Atualização em Tempo Real: Atualiza os ponteiros do relógio analógico e a visualização digital em tempo real.

Instalação e Execução

Neste guia foi utilizado a IDE Intellij no sistema operacional Windows.

  1. Clonando o Repositório
git clone https://github.com/jmsmarcelo/clock-desktop-javafx.git
  1. Abrindo o Projeto com o Intellij

    No Intellij vá em Menu > File > Open, e seleciona a pasta do Projeto que foi clonado.

  2. Compilando o Projeto

    Mostrarei duas maneiras de compilar o Projeto.

    1. Compilando com o Jlink

      Jlink é uma ferramente que permite criar uma imagem de tempo de execução personalizada contendo apenas os módulos Java necessários para a sua aplicação. A desvantagem é que somente é possível utilizar no tipo de sistema em que foi compilado.

      Com o Projeto aberto no Intellij:

       Maven > clock-desktop-javafx > Plugins > javafx > javafx:jlink
      

      Screenshot 2024-09-18 000452

      Isso irá gerar uma pasta contendo um executável .bat ou .sh dependendo do sistema operacional.

    2. Compilando com o Jar

      O arquivo .jar é um formato de arquivo compactado que contém todos os recursos necessários para executar uma aplicação Java. No entanto, para executar um arquivo .jar de JavaFX, você precisará baixar o SDK do JavaFX

      Com o Projeto aberto no Intellij:

       Maven > clock-desktop-javafx > Plugins > jar > jar:jar
      

      Screenshot 2024-09-18 000515

  3. Executando o arquivo compilado

    Cada tipo de compilação têm maneiras diferentes de serem executadas

    1. Arquivo compilado com o Jlink

      É gerado uma pasta, basta apenas dá um click duplo no arquivo app.bat

       [pastaDoProjeto] > target > app > app.bat
      
    2. Arquivo .Jar

      Para executar o arquivo jar de JavaFX é necessário primeiro fazer o download do JavaFX.

      Após o download e descompactação, execute os seguintes comandos no CMD na pasta do projeto (substitua caminho\completo\da\pasta\JavaFX\lib pelo caminho completo da pasta lib do JavaFX):

      java --module-path caminho\completo\da\pasta\JavaFX\lib --add-modules javafx.controls,javafx.fxml -jar target\clock-desktop-javafx-1.0-SNAPSHOT.jar

Capturas de Tela

Relógio Analógico

Screenshot 2024-09-18 213911

Relógio Digital

Screenshot 2024-09-18 213924

Requisitos

  • Java 21 ou superior
  • JavaFX 21
  • Maven

Licença

Este projeto está licenciado sob a MIT License.