Manual de utilização

🚀 Início rápido

1. Inicie o Version Tracker. No primeiro arranque, um assistente de configuração guia-o: autorização de Acesso total ao disco (necessário para analisar as suas aplicações) e, opcionalmente, a instalação dos gestores de pacotes que pretende acompanhar. Tudo pode ser alterado mais tarde nas Definições.
2. Aproveite o teste gratuito. Um teste de 7 dias da versão completa inicia-se automaticamente — sem cartão de crédito. No fim, a app regressa à versão gratuita (a análise continua sempre disponível).
3. Aguarde pela primeira análise. Consoante o número de apps instaladas e fontes ativas, a análise inicial dura entre 10 e 60 segundos.
4. Consulte o separador « Todas ». É aqui que se concentram todas as atualizações disponíveis.
5. Clique em « Atualizar tudo » para iniciar todas as atualizações de uma só vez, ou utilize os botões individuais.

🗃️ Fontes suportadas

O Version Tracker deteta atualizações para:

Cada fonte pode ser ativada ou desativada individualmente nas Definições.

🖥️ A interface

O ecrã principal divide-se em três colunas, encimadas por uma barra de ferramentas:

Barra lateral esquerda

A navegação está organizada em secções dobráveis, que pode reordenar por arrastar e largar. O contador junto a cada categoria indica o número de atualizações disponíveis.

• RESUMO — Painel (visão geral, atividade recente, último instantâneo) e Instantâneos
• ATUALIZAÇÕES — Todas (todas as atualizações numa só lista), Aplicações, Pacotes, Homebrew, Atualizações do Sistema, Apple Developer Tools…
• Depois, secções por domínio (APLICAÇÕES, SISTEMA, IA, JavaScript, Python, Rust, editores…): só aparecem as que correspondem ao que está realmente instalado no seu Mac.

Barra de ferramentas

• Analisar — relança uma análise completa (o botão também permite cancelar uma análise em curso)
• Definições e Feedback — acesso direto às preferências e ao formulário de comentários
• Dois botões para mostrar/ocultar a barra lateral e o painel de Detalhes

Zona central

A lista dos elementos da categoria selecionada, com um campo de pesquisa. Cada linha mostra:

• O ícone e o nome da app ou do pacote
• A versão atual e a versão disponível
• Um botão de ação contextual (Atualizar, Transferir, Abrir, Mostrar no Finder…)

Barra lateral direita (Detalhes)

Detalhes do elemento selecionado: descrição, versões, notas de versão, fonte, caminho no disco.

Nota: a largura da janela é memorizada entre sessões. O tamanho mínimo foi concebido para mostrar confortavelmente as três colunas.

🔄 Atualizar aplicações

Atualização individual

Clique no botão verde « Atualizar » de uma linha (requer uma licença ativa ou o teste — ver Licença e teste). Consoante a fonte:

• Mac App Store — usa CommerceKit (atualização silenciosa em segundo plano)
• Homebrew Cask/Formula — lança brew upgrade (com autenticação de administrador se necessário — ver abaixo). Se o brew recusar a atualização no local, o Version Tracker aplica automaticamente a reinstalação forçada que o brew recomenda.
• Sparkle — descarrega o DMG/ZIP, desmonta o antigo e instala o novo
• GitHub — descarrega e instala o binário mais recente
• Download direto — o botão laranja « Transferir » guarda o ficheiro na sua pasta de downloads; depois torna-se « Mostrar no Finder » para concluir a instalação manualmente. « Transferir tudo » lança a transferência em lote.

Cópia de segurança automática: com o helper privilegiado ativado, a versão anterior da app é guardada antes de cada atualização. Se algo correr mal, restaure-a em Definições → Cópias de segurança (período de conservação e número de cópias ajustáveis).

Atualização em lote

O botão « Atualizar tudo » lança, após uma confirmação que recapitula o número de atualizações, todas as atualizações automatizáveis em sequência. Pode sair da vista: a operação continua em segundo plano e um resumo é apresentado no fim (incluindo as atualizações adiadas).

Em caso de erro (HTTP 403, ficheiro não encontrado, etc.), o botão muda para « Abrir »: o Version Tracker abre a app instalada para que ela própria trate da sua atualização.

📸 Instantâneos

A vista Instantâneos (secção RESUMO) fotografa o estado completo do software do seu Mac: aplicações, pacotes, ferramentas, versões instaladas e atualizações conhecidas.

• Criar instantâneo (⇧+⌘+N) — captura o inventário atual. Depois pode renomeá-lo ou fixá-lo.
• Comparar — selecione dois instantâneos para ver tudo o que mudou entre eles: elementos instalados, removidos ou atualizados, com filtros por tipo de alteração.
• Exportar… — exporta um instantâneo ou uma comparação em JSON, CSV ou Markdown. Dois perfis de privacidade: Completo (mantém caminhos e nome da máquina — para uso local) ou Partilhável (caminhos absolutos, nome de utilizador e da máquina mascarados).

Casos de uso típicos: documentar um Mac antes de uma migração ou reinstalação, saber o que uma sessão de atualizações mudou realmente, ou partilhar um inventário limpo.

Instantâneos automáticos

Duas opções em Definições → Atualizações:

• Instantâneos automáticos antes/depois de « Atualizar tudo » — cria um instantâneo do inventário antes e depois de cada atualização em lote, para comparar e documentar as alterações.
• Instantâneo após cada análise agendada — no fim de cada análise automática, cria um instantâneo — apenas se algo tiver mudado desde o último.

📋 A barra de menus

O Version Tracker oferece um ícone na barra de menus com o número de atualizações pendentes. O ícone anima-se enquanto decorre uma análise ou uma atualização.

O painel

Um clique no ícone abre um painel com as atualizações disponíveis (a sua versão → nova versão), com:

• Ações por linha: Atualizar, Transferir ou Abrir consoante a fonte
• Os botões Analisar, Atualizar tudo e Transferir tudo
• Um rodapé com a data da última análise e o número de elementos acompanhados
• Uma seta no cabeçalho para recolher ou expandir a lista (« Ocultar a lista » / « Mostrar a lista »): recolhido, o painel reduz-se ao cabeçalho e ao rodapé

Autónomo, mesmo com a app fechada

• Abrir ao iniciar sessão (Definições → Geral) — lança apenas o ícone da barra de menus no arranque da sessão, sem abrir a janela principal.
• As atualizações lançadas a partir do painel executam-se num processo em segundo plano, sem abrir a janela principal nem o ícone da Dock.
• Com a Verificação em segundo plano (Definições → Automatização), as análises agendadas — por intervalo ou a hora fixa diária — continuam a correr mesmo com a app fechada: o distintivo e as notificações mantêm-se atualizados.

⚙️ Definições

As Definições estão organizadas em painéis:

Fecho da janela

• Fechar a janela principal (⌘+W ou o botão vermelho) oculta a janela: a app continua ativa em segundo plano.
• A opção « Fechar a janela mantém apenas a barra de menus » (Definições → Geral) encerra a app principal ao fechar e mantém apenas o ícone da barra de menus.
• ⌘+Q encerra realmente a aplicação (um alerta avisa se houver uma atualização em curso).

🔐 Autenticação administrador

Algumas atualizações requerem privilégios de administrador. O Version Tracker oferece dois mecanismos:

1. Helper privilegiado (recomendado) — um pequeno daemon assinado, ativado uma única vez em Definições → Geral → Helper privilegiado → Ativar.
2. Autenticação pontual — sem o helper, um diálogo do sistema pede a sua palavra-passe de administrador em cada operação.

O que o helper traz:

• Fim dos pedidos de palavra-passe em cada atualização
• Instalação atómica (a app nunca fica substituída a meio)
• Verificação de assinatura e de Team ID do lado root
• Cópia de segurança automática da versão anterior antes de cada atualização

O helper não responde? Após uma atualização da app, use o botão « Reparar » do painel Helper privilegiado: volta a registar o daemon sem pedir novamente a sua palavra-passe.

🔑 Licença e teste

O Version Tracker segue um modelo freemium:

• Versão gratuita — a análise e o inventário completos continuam sempre disponíveis: vê tudo o que está desatualizado, em todas as fontes.
• Licença (Solo, Family ou Pro) — desbloqueia a instalação de atualizações com um clique, as atualizações em lote e as atualizações a partir da barra de menus. Ver planos e preços.
• Teste gratuito de 7 dias — inicia-se automaticamente no primeiro arranque, sem cartão de crédito. No fim do teste, a app regressa automaticamente à versão gratuita.

Ativar uma licença: abra Definições → Licença e cole a chave recebida por e-mail após a compra. Pode desativar a licença num Mac para libertar um lugar e ativá-la noutro.

🖱️ Atalhos de teclado

Para relançar uma análise completa, use o botão Analisar da barra de ferramentas ou o botão Analisar do painel da barra de menus.

🌍 Idiomas

O Version Tracker está disponível em:

• 🇵🇹 Português (Portugal)
• 🇬🇧 Inglês
• 🇫🇷 Francês
• 🇩🇪 Alemão
• 🇪🇸 Espanhol

O idioma segue automaticamente as definições do sistema macOS e pode ser alterado em Definições → Geral → Idioma.

🗑️ Desinstalar o Version Tracker

Arrastar a app para o Lixo chega na grande maioria dos casos. Eis o procedimento completo se não quiser deixar qualquer rasto.

Método simples (recomendado)

• Abra as Definições e desative Geral → Abrir ao iniciar sessão e Automatização → Verificação em segundo plano.
• Feche o Version Tracker e o seu ícone da barra de menus (clique no ícone → Sair).
• Arraste Version Tracker.app de /Applications para o Lixo e esvazie-o.

Sem pressa : mesmo sem este passo, quaisquer rastos remanescentes são inertes — nada está em execução, nada corre como root, nada consome recursos.

Para uma remoção completa (facultativo)

O Version Tracker instala três pequenos componentes, todos aprovados por si na instalação : um assistente privilegiado e um ícone da barra de menus (ambos dentro da app — desaparecem com ela), e uma tarefa de análise agendada (um ficheiro separado). Se saltou o passo acima, remova-a manualmente :

launchctl unload ~/Library/LaunchAgents/com.jpflorencio.VersionTracker.agent.plist 2>/dev/null
rm -f ~/Library/LaunchAgents/com.jpflorencio.VersionTracker.agent.plist

Para também remover as suas cópias de segurança de apps e os seus instantâneos de inventário (irreversível) :

rm -rf ~/Library/Application\ Support/Version\ Tracker
defaults delete com.jpflorencio.VersionTracker

Por fim, se o Version Tracker ainda constar em Definições do Sistema → Geral → Itens de início e extensões, remova a entrada (desaparece por si só pouco depois).

Vai reinstalar ou mudar de Mac?

• Reinstalação no mesmo Mac : não mexa em nada — a sua chave de licença permanece no chaveiro e ativa-se automaticamente.
• Mudança para outro Mac : liberte primeiro o seu lugar de ativação em Definições → Licença → Desativar, antes de remover a app.

O assistente privilegiado recusa-se a reinstalar? Em Definições do Sistema → Geral → Itens de início e extensões, desative o Version Tracker e volte a ativá-lo (o ciclo completo ressincroniza o estado — ativar sozinho não basta). Se o problema persistir, esvazie o Lixo e reinicie.

🗑️ Desinstalar os gestores de pacotes

Antes de começar

• Abra a aplicação Terminal (Aplicações → Utilitários). O ficheiro de configuração da shell mencionado abaixo é o ~/.zshrc (predefinição no macOS).
• Remova apenas as ferramentas que instalou para o Version Tracker. Se outro software ou projeto depender delas, mantenha-as.
• Desinstale primeiro as ferramentas individuais e o Homebrew em último lugar: desinstalá-lo remove todos os pacotes instalados com ele.
• Após a desinstalação, o Version Tracker deixará simplesmente de acompanhar essa origem. Pode reinstalar qualquer ferramenta a qualquer momento a partir do onboarding ou das Definições.

1. Ferramentas instaladas diretamente pelo Version Tracker (via Homebrew)

O Homebrew recusará a desinstalação se outras fórmulas dependerem dela — é uma proteção, não um erro.

Homebrew (no fim) — ⚠️ remove o Homebrew e todos os pacotes instalados com ele:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

O script indica no fim as pastas residuais (normalmente /opt/homebrew em Apple Silicon, /usr/local/Homebrew em Intel).

2. Ferramentas externas (instaladas através dos guias oficiais)

Se instalou alguma destas ferramentas com o Homebrew em vez do instalador oficial, use simplesmente brew uninstall <fórmula>.

Verificação

Para cada ferramenta desinstalada: command -v <ferramenta> não deve mostrar nada (abra antes uma nova janela do Terminal).

❓ Perguntas frequentes

📩 Contacto

Para reportar um bug, sugerir uma melhoria ou simplesmente partilhar feedback: contact@version-tracker.app — ou use o botão Feedback diretamente na app.