Documentação do Aplicativo de Previsão do Tempo (v1.6.0)
Bem-vindo à documentação do Aplicativo de Previsão do Tempo! Este aplicativo fornece informações meteorológicas em tempo real e previsões de vários provedores de dados meteorológicos.
Recursos
- 🌦️ Condições climáticas atuais com métricas detalhadas
- 📅 Previsão do tempo para 7 dias com detalhamento por hora
- 📖 Visualizador de documentação Markdown integrado
- 📊 Visualizador de logs do aplicativo para diagnóstico
- 🌍 Múltiplos provedores de dados meteorológicos
- 🌐 Suporte a vários idiomas
- ⭐ Localizações favoritas com histórico aprimorado
- ⚙️ Configurações e temas personalizáveis
Atualizações Recentes
Para uma lista detalhada de alterações, consulte o arquivo CHANGELOG.md.
Primeiros Passos
- Guia de Instalação - Como instalar e configurar o aplicativo
- Guia do Usuário - Como usar o aplicativo
- Configuração - Como configurar o aplicativo
Tópicos Avançados
Suporte
Para suporte, por favor abra uma issue em nosso repositório no GitHub.
Licença
Este projeto está licenciado sob a Licença GPLv3 - consulte o arquivo LICENÇA para obter detalhes.
Guia do Usuário
Primeiros Passos
- Iniciando o Aplicativo
- Dê um duplo clique no ícone do aplicativo ou execute pelo terminal
- A janela principal será aberta mostrando o tempo da localização padrão
- Na primeira execução, você será guiado pela configuração inicial
- Procurando por uma Localização
- Digite o nome de uma cidade na caixa de pesquisa
- Pressione Enter ou clique no botão de pesquisa (🔍)
- Para resultados mais precisos, inclua o código do país (ex: “São Paulo, BR”)
- Clique com o botão direito no mapa para selecionar uma localização
Interface Principal
Exibição do Tempo
- Tempo Atual: Mostra temperatura, condições e detalhes adicionais
- Clique em qualquer métrica para alternar entre unidades (ex: °C/°F, km/h/mph)
- Passe o mouse sobre os ícones para obter mais informações
- Previsão para 7 Dias: Mostra a previsão do tempo para os próximos 7 dias
- Clique em um dia para ver a previsão horária
- Probabilidade de precipitação codificada por cores
- Inclui variações de temperatura e condições climáticas para cada dia
- Detalhes do Tempo: Inclui:
- Sensação térmica
- Umidade e ponto de orvalho
- Velocidade e direção do vento
- Pressão e visibilidade
- Índice UV e qualidade do ar
- Horários do nascer e pôr do sol
Navegação
Mapas e Radar Meteorológico
O recurso de Mapas e Radar Meteorológico fornece visualizações interativas de padrões e condições climáticas.
Acessando os Mapas Meteorológicos
- Clique em Visualizar na barra de menu
- Selecione Mapas e Radar Meteorológico
- O diálogo de Mapas Meteorológicos será aberto com várias abas
Recursos
Aba Radar
- Tipo de Mapa: Alterne entre diferentes mapas base (OpenStreetMap, OpenTopoMap, Stamen Terrain)
- Camada: Ative/desative sobreposições de radar e satélite
- Pesquisar: Encontre localizações por nome ou coordenadas
Aba Temperatura
- Visualize as variações de temperatura entre as regiões
- Alterne entre Celsius e Fahrenheit
- Ajuste a opacidade da sobreposição de temperatura
Aba Precipitação
- Veja a precipitação atual e prevista
- Ative/desative diferentes camadas de precipitação
- Visualize chuva, neve e outros tipos de precipitação
Aba Vento
- Visualize a velocidade e direção do vento
- Ative/desative setas ou linhas de fluxo
- Ajuste as unidades de velocidade do vento (km/h, m/s, mph, nós)
Usando o Mapa
- Zoom: Use a roda do mouse ou os botões +/-
- Mover: Clique e arraste o mapa
- Pesquisar: Digite um local na caixa de pesquisa e pressione Enter
- Camadas: Ative/desative diferentes camadas meteorológicas usando os controles
- Tela Cheia: Clique no botão de tela cheia para uma visualização maior
Dicas
- O mapa centralizará automaticamente em sua localização atual se os serviços de localização estiverem ativados
- Clique no mapa para obter informações meteorológicas detalhadas daquele local
- Use os controles de linha do tempo para visualizar dados de previsão para horários diferentes
- Clique com o botão direito no mapa para definir um marcador ou obter coordenadas
Recursos
Favoritos
Configurações
- Clique no ícone de engrenagem (⚙️) ou vá para Menu > Configurações
- Configure opções como:
- Geral: Idioma, tema, unidades
- Tempo: Configurações do provedor, frequência de atualização
- Exibição: Layout, animações, tamanho da fonte
- Notificações: Alertas meteorológicos, alertas de chuva
- Avançado: Cache, registro, opções de desenvolvedor
- Clique em “Salvar” para aplicar as alterações
Interface de Linha de Comando
# Uso básico
weather-app [localização] [opções]
# Exemplos
weather-app "Rio de Janeiro, BR"
weather-app --provider openweathermap --units metric
weather-app --config ~/.config/weather/config.ini
# Opções
-h, --help Mostrar mensagem de ajuda e sair
-v, --version Mostrar informações de versão
-c, --config ARQUIVO Especificar arquivo de configuração
-d, --debug Ativar modo de depuração
--provider PROVEDOR Definir provedor meteorológico
--units {metric,imperial}
Definir sistema de unidades
--lang IDIOMA Definir código de idioma
--tema {claro,escuro,sistema}
Definir esquema de cores
--sem-interface Executar em modo console
Atalhos de Teclado
Atalhos Globais
| Atalho |
Ação |
Ctrl + F |
Focar na barra de pesquisa |
Ctrl + , |
Abrir Configurações |
Ctrl + Q |
Sair do Aplicativo |
F1 |
Mostrar Ajuda |
Esc |
Fechar diálogos ou limpar pesquisa |
F5 |
Atualizar dados meteorológicos |
Ctrl + R |
Atualizar todos os dados |
Ctrl + W |
Fechar janela atual |
Ctrl + N |
Nova janela |
Atalhos de Navegação
| Atalho |
Ação |
Ctrl + Tab |
Alternar entre localizações |
Ctrl + F |
Alternar favoritos |
Ctrl + L |
Alternar lista de localizações |
Ctrl + M |
Alternar visualização do mapa |
Dicas e Truques
- Clique com o botão direito em qualquer card do tempo para ações rápidas
- Duplo clique na temperatura para alternar entre Celsius e Fahrenheit
- Clique do meio no mapa para definir uma localização personalizada
- Use a roda do mouse na previsão para rolar pelas horas
- Arraste e solte para reordenar os locais favoritos
- Fixar a janela para mantê-la sobre outras aplicações
- Use o ícone na bandeja do sistema para acesso rápido
Visualizador de Documentação
- Acesse a documentação Markdown integrada no menu Ajuda
- Navegue por documentação abrangente
- Funcionalidade de busca para encontrar tópicos específicos
- Zoom para melhor legibilidade
- Sumário para navegação fácil
Visualizador de Logs
- Visualize os logs do aplicativo no menu Ajuda
- Filtre logs por nível (Depuração, Informação, Aviso, Erro)
- Pesquise em mensagens de log
- Copie logs para a área de transferência para solução de problemas
Mapas Meteorológicos
- Acesse mapas meteorológicos no menu Visualizar
- Mapa interativo com várias camadas:
- Temperatura
- Precipitação
- Velocidade do vento
- Cobertura de nuvens
- Navegue e aplique zoom para explorar diferentes regiões
- Clique no mapa para obter informações meteorológicas daquele local
Solução de Problemas
Se encontrar algum problema:
- Verifique sua conexão com a internet
- Verifique suas chaves de API nas Configurações
- Tente mudar para um provedor meteorológico diferente
- Verifique os logs do aplicativo em busca de erros
- Reinicie o aplicativo
- Redefina as configurações, se necessário
Para obter ajuda adicional, visite nosso repositório no GitHub ou consulte o Guia de Solução de Problemas.
Feedback
Agradecemos seu feedback! Por favor, nos informe:
- Quais recursos você gostaria de ver
- Quaisquer problemas que encontrar
- Sua experiência com o aplicativo
Você pode enviar feedback pelo aplicativo (Ajuda > Enviar Feedback) ou em nossa página de Issues do GitHub.