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.

Instalar com o Homebrew

O Version Tracker está disponível a partir do seu próprio tap do Homebrew.

brew tap version-tracker/tap
brew install --cask version-tracker/tap/version-tracker

Já instalou o Version Tracker à mão? Acrescente --force para que o Homebrew assuma a cópia que já tem:

brew install --cask --force version-tracker/tap/version-tracker

O Version Tracker mantém-se atualizado sozinho, por isso o brew upgrade não vai entrar em conflito com o atualizador da própria app.

🗃️ Fontes suportadas

O Version Tracker deteta atualizações para:

Definições → Fontes lista as 51 fontes, cada uma com dois interruptores:

• Ativa: a fonte é analisada. Desativá-la oculta os seus elementos e encurta a análise.
• Agrupada: a fonte participa em Atualizar tudo, Processar tudo e Transferir tudo. Desative-a para manter uma fonte visível e analisada, mas fora dos botões grandes. As suas linhas continuam a poder ser atualizadas uma a uma.

Agrupada fica a cinzento enquanto Ativa estiver desligada: uma fonte que não é analisada nada tem para dar a um lote.

Nota: o Adobe Camera Raw é um plug-in e não uma app, mas é listado e atualizado com os restantes produtos Creative Cloud.

🖥️ 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 quantos elementos contém, e a cor indica quais são (ver o que significam as cores dos contadores).

• 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, Adiadas (ver adiar uma atualização)…
• 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…)

A pesquisa abrange tanto aplicações como pacotes, incluindo gems, crates, pacotes yarn e ferramentas uv. Escrever filtra de imediato, por maior que seja o seu inventário. Escolher um resultado abre a categoria certa, seleciona a linha e desloca-a para a vista; uma app cuja única linha é o seu cask Homebrew aterra nessa linha.

As colunas memorizam cada largura que definir, incluindo a do nome, e cada tabela ajusta as suas colunas ao espaço disponível quando redimensiona a janela.

Cada lista indica quando foi feita, incluindo as listas de pacotes, Adotáveis e Ignoradas. Uma lista vazia explica porquê, em vez de não mostrar nada.

Barra lateral direita (Detalhes)

Detalhes do elemento selecionado, distribuídos por quatro separadores: descrição, versões, notas de versão, fonte, caminho no disco e as verificações de segurança.

• Os botões Atualizar e Transferir também estão aqui, não só na linha. Uma transferência mostra a sua barra de progresso e passa depois a Mostrar no Finder.
• Copiar relatório coloca na área de transferência, com um clique, tudo o que os quatro separadores sabem sobre o elemento.
• Mais ações → Comunicar uma deteção incorreta abre um formulário já preenchido com o que o Version Tracker viu: basta dizer o que está errado.
• O painel reabre no separador que usou e, durante um lote, passa diretamente de uma app para a seguinte em vez de ficar em branco entre as duas.
• Os seus botões ficam a cinzento durante uma análise, um lote ou uma transferência, tal como as linhas já ficavam.

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).

Também pode selecionar várias linhas e atualizar apenas essa seleção, a partir do menu.

Um lote só leva as fontes cujo interruptor Agrupada esteja ligado (ver Fontes suportadas). Quatro regras decidem o que fica de fora além disso:

• As apps em execução e as atualizações principais são excluídas pelo filtro de segurança (Definições → Atualizações). Pode continuar a atualizá-las uma a uma.
• As atualizações que exigem um macOS mais recente do que o seu são excluídas, e a linha indica a versão necessária.
• Uma atualização sem qualquer assinatura é anunciada com um aviso antes de instalar seja o que for. Uma atualização cuja assinatura falha a verificação fica bloqueada, sem exceção.
• Num Mac Intel, as fórmulas Homebrew que possam ter de ser compiladas a partir do código-fonte ficam fora de um lote global, e o relatório diz quais e porquê. Atualize-as individualmente se quiser prosseguir: o Version Tracker concede então até oito horas por fórmula e pode cancelar a qualquer momento.

Se uma linha falhar quando o seu ficheiro já tinha sido transferido, a transferência é-lhe entregue em vez de ser deitada fora: a linha oferece Mostrar no Finder.

Adiar uma atualização

Uma atualização que não queira já pode ser adiada em vez de ignorada. Clique com o botão direito na linha, escolha Adiar e depois a duração: 1 dia, 3 dias, 1 semana, 2 semanas, 1 mês ou Indefinidamente.

A linha passa para a categoria Adiadas na barra lateral, que reúne todas as apps, pacotes e extensões cuja atualização foi saltada ou adiada. Sai das listas de atualizações e dos contadores, portanto deixa de insistir, mas nunca se perde: Cancelar adiamento traz–a de volta de imediato.

Adiadas não é Ignoradas. Ignoradas reúne os elementos com que o Version Tracker nada pode fazer. Adiadas é a sua própria decisão, com uma data associada, e a linha regressa sozinha quando o prazo termina.

Transferência manual (« Transferir »)

Algumas apps não têm um mecanismo automático mas expõem um URL de transferência direto (PKG, DMG, ZIP). Para estas:

• Aparece o botão laranja « Transferir »
• O ficheiro é transferido para a sua pasta de transferências (por predefinição ~/Downloads, personalizável nas Definições)
• Depois de transferido, o botão passa a « Mostrar no Finder » para concluir a instalação à mão

O botão « Transferir tudo » inicia as transferências em lote para todas as apps elegíveis.

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:

Pastas analisadas

Por predefinição o Version Tracker procura onde o macOS coloca as aplicações. Definições → Fontes → Pastas analisadas permite mudar isso:

• Pastas a analisar também: acrescente uma pasta, um segundo disco por exemplo, para que as suas apps aí também sejam encontradas.
• Pastas a deixar de lado: o Version Tracker não olha lá dentro.

Se a mesma pasta estiver nas duas listas, deixá-la de lado ganha. Retirar uma pasta de uma lista tira-a da lista e não toca em nada do que ela contém.

Dicas

Aponte para um botão ou uma definição e uma frase explica o que ele faz, tanto na janela como no painel da barra de menus.

As dicas estão desativadas por predefinição na versão 1.3. Ative-as em Definições → Aparência → Dicas. O interruptor governa toda a aplicação, e não um ecrã em cada dois.

Ocultar o ícone da barra de menus

Definições → Geral → Ocultar o ícone da barra de menus retira o ícone por completo, esteja a janela aberta ou fechada. Fechar a janela passa então simplesmente a ocultá-la, e volta a abri-la a partir da Dock ou com ⌘+Tab.

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 (Mono, Solo ou Family): 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.

Um lugar pertence a uma conta de utilizador, não a um Mac. A sua chave fica no porta-chaves de sessão, que o macOS mantém separado para cada conta. Uma segunda conta no mesmo Mac começa sem licença e ocupa um lugar próprio quando a ativa aí. Conte um lugar por cada conta de utilizador que vai usar o Version Tracker.

Perdeu a chave de licença ou precisa de uma fatura? Abra My Orders e inicie sessão com o seu e-mail de compra. Sem palavra-passe, apenas um link mágico. Lá encontra cada encomenda, a sua chave de licença e os ficheiros de download. Para gerir a sua subscrição (método de pagamento, dados de IVA, mudança de plano), use antes o portal de subscrição.

🖱️ 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
• 🇮🇹 Italiano
• 🇳🇱 Neerlandês

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

O melhor sítio para reportar um bug ou pedir uma funcionalidade é o gestor público de problemas no GitHub. Cada reporte é visível para todos: pode verificar se o seu problema já foi reportado, acrescentar os seus próprios detalhes e acompanhar o progresso até à correção.

• Bugs e pedidos de funcionalidades: abra um issue em github.com/Version-Tracker/feedback
• Licença, faturação ou questões privadas: contact@version-tracker.app
• Feedback rápido: o botão Feedback diretamente na app

Vai reportar um bug? Indique a sua versão do macOS, a sua versão do Version Tracker e a app ou fonte afetada. Como o gestor é público, nunca cole a sua chave de licença nem dados pessoais num issue: envie-os antes por e-mail.