Este guia fornece instruções passo a passo para instalar o HarborDB no seu dispositivo macOS.

Métodos de Instalação

Mac App Store (Recomendado)

A maneira mais fácil de instalar o HarborDB é através da Mac App Store oficial:

Abra a Mac App Store no seu dispositivo macOS
Procure por "HarborDB" na barra de pesquisa
Clique em "Obter" ou no botão de preço ($19,99) para comprar e baixar
Aguarde a instalação - O aplicativo será baixado e instalado automaticamente
Inicie o HarborDB da sua pasta Aplicativos, Launchpad ou Spotlight

Benefícios da instalação pela Mac App Store:

Atualizações automáticas
Distribuição verificada e segura
Instalação e remoção fácil
Suporte a Compartilhamento Familiar

Download Direto (Alternativa)

Para implantações empresariais ou fins de teste, você pode baixar o HarborDB diretamente:

Visite nossa página de download em harbordb.com/download
Baixe o arquivo .dmg mais recente
Abra o arquivo .dmg clicando duas vezes nele
Arraste o HarborDB para sua pasta Aplicativos
Ejete a imagem de disco após a cópia

Nota de Segurança: Ao baixar diretamente, certifique-se de verificar a autenticidade do download usando os checksums fornecidos.

Requisitos do Sistema

Antes de instalar, verifique se seu sistema atende a estes requisitos:

Requisitos Mínimos

macOS: 12.0 (Monterey) ou posterior
Processador: Intel Core i5 (8ª geração) ou Apple Silicon (M1)
Memória: 8 GB de RAM
Armazenamento: 200 MB de espaço disponível
Exibição: Resolução 1280 × 800

Requisitos Recomendados

macOS: 13.0 (Ventura) ou posterior
Processador: Apple Silicon (M2 ou mais recente)
Memória: 16 GB de RAM ou mais
Armazenamento: 500 MB de espaço disponível (para cache e exportações)
Exibição: Resolução 1920 × 1080 ou superior

Requisitos do Servidor PostgreSQL

PostgreSQL: Versão 9.6 ou posterior (12+ recomendado)
Rede: Conectividade TCP/IP com o servidor PostgreSQL
Permissões: O usuário deve ter permissões de conexão e consulta

Primeira Inicialização

Após a instalação, inicie o HarborDB pela primeira vez:

Localize o HarborDB na sua pasta Aplicativos ou use o Spotlight (⌘ + Espaço, digite "HarborDB")
Clique duas vezes para iniciar - Você pode precisar conceder permissão para o aplicativo executar (somente na primeira vez)
Revise as permissões do sistema:
- Acessibilidade: Necessária para atalhos de teclado e melhorias de interface (opcional)
- Rede: Necessária para conexões com banco de dados
- Keychain: Necessária para armazenamento seguro de senhas

Avisos do Gatekeeper (Download Direto)

Se você baixou o HarborDB diretamente, poderá ver um aviso de segurança:

"HarborDB" não pode ser aberto porque o desenvolvedor não pode ser verificado.

Para resolver isso:

Vá para Preferências do Sistema → Segurança e Privacidade
Clique em "Abrir mesmo assim" ao lado do aviso do HarborDB
Confirme que deseja abrir o aplicativo

Etapas Pós-Instalação

1. Verifique a Instalação

Verifique se o HarborDB aparece na sua pasta Aplicativos
Confirme que o aplicativo inicia sem erros
Verifique o menu Sobre (HarborDB → Sobre o HarborDB) para informações da versão

2. Verifique Atualizações

Mac App Store: As atualizações são automáticas, mas você pode verificar manualmente na aba Atualizações da App Store
Download Direto: Verifique atualizações em HarborDB → Verificar Atualizações

3. Configure Preferências (Opcional)

Ajuste o tema (Claro/Escuro/Sistema)
Configure as configurações padrão de conexão
Configure atalhos de teclado

Solução de Problemas de Instalação

Erro "Aplicativo está Danificado"

Se você vir "HarborDB.app está danificado e não pode ser aberto":

# Abra o Terminal e execute:
sudo xattr -cr /Applications/HarborDB.app

Permissões Insuficientes

Se o HarborDB não conseguir acessar recursos necessários:

Vá para Preferências do Sistema → Segurança e Privacidade → Privacidade
Conceda as permissões necessárias (Acessibilidade, Arquivos e Pastas, etc.)
Reinicie o HarborDB

Falha na Instalação

Se a instalação falhar ou o aplicativo não iniciar:

Reinicie seu Mac e tente novamente
Verifique espaço em disco - Certifique-se de ter pelo menos 500 MB livres
Verifique a versão do macOS - Verifique Sobre Este Mac → Versão do macOS
Entre em contato com o suporte se os problemas persistirem

Desinstalação

Para remover o HarborDB do seu sistema:

Versão da Mac App Store

Abra Finder → Aplicativos
Arraste HarborDB.app para a Lixeira
Esvazie a Lixeira

Versão de Download Direto

Remova o aplicativo de /Aplicativos

Remova as preferências (opcional):

rm -rf ~/Library/Preferences/com.harbordb.HarborDB.plist
rm -rf ~/Library/Application\ Support/HarborDB

Remova as entradas do Keychain (opcional) - Abra o Acesso ao Keychain e procure por "HarborDB"

Próximos Passos

Agora que o HarborDB está instalado:

Crie sua primeira conexão - Conecte-se a um banco de dados PostgreSQL
Explore a interface - Conheça os recursos do HarborDB
Experimente consultas de exemplo - Pratique com SQL

Precisa de ajuda? Consulte nosso FAQ ou entre em contato com o suporte.

Instalação