Instalación

Esta guía proporciona instrucciones paso a paso para instalar HarborDB en tu dispositivo macOS.

Métodos de Instalación

Mac App Store (Recomendado)

La forma más fácil de instalar HarborDB es a través de la Mac App Store oficial:

1. Abre la Mac App Store en tu dispositivo macOS
2. Busca "HarborDB" en la barra de búsqueda
3. Haz clic en "Obtener" o en el botón de precio ($19,99) para comprar y descargar
4. Espera la instalación - La aplicación se descargará e instalará automáticamente
5. Inicia HarborDB desde tu carpeta Aplicaciones, Launchpad o Spotlight

Beneficios de la instalación desde Mac App Store:

• Actualizaciones automáticas
• Distribución verificada y segura
• Instalación y eliminación fáciles
• Soporte para Compartir en Familia

Descarga Directa (Alternativa)

Para implementaciones empresariales o propósitos de prueba, puedes descargar HarborDB directamente:

1. Visita nuestra página de descarga en harbordb.com/download
2. Descarga el archivo .dmg más reciente
3. Abre el archivo .dmg haciendo doble clic en él
4. Arrastra HarborDB a tu carpeta Aplicaciones
5. Expulsa la imagen de disco después de copiar

Nota de Seguridad: Al descargar directamente, asegúrate de verificar la autenticidad de la descarga utilizando las sumas de verificación proporcionadas.

Requisitos del Sistema

Antes de instalar, verifica que tu sistema cumple con estos requisitos:

Requisitos Mínimos

• macOS: 12.0 (Monterey) o posterior
• Procesador: Intel Core i5 (8va generación) o Apple Silicon (M1)
• Memoria: 8 GB de RAM
• Almacenamiento: 200 MB de espacio disponible
• Pantalla: Resolución de 1280 × 800

Requisitos Recomendados

• macOS: 13.0 (Ventura) o posterior
• Procesador: Apple Silicon (M2 o más reciente)
• Memoria: 16 GB de RAM o más
• Almacenamiento: 500 MB de espacio disponible (para caché y exportaciones)
• Pantalla: Resolución de 1920 × 1080 o superior

Requisitos del Servidor PostgreSQL

• PostgreSQL: Versión 9.6 o posterior (12+ recomendado)
• Red: Conectividad TCP/IP al servidor PostgreSQL
• Permisos: El usuario debe tener permisos de conexión y consulta

Primer Inicio

Después de la instalación, inicia HarborDB por primera vez:

1. Localiza HarborDB en tu carpeta Aplicaciones o usa Spotlight (⌘ + Espacio, escribe "HarborDB")
2. Haz doble clic para iniciar - Es posible que necesites conceder permiso para que la aplicación se ejecute (solo la primera vez)
3. Revisa los permisos del sistema:
   • Accesibilidad: Requerido para atajos de teclado y mejoras de interfaz (opcional)
   • Red: Requerido para conexiones a bases de datos
   • Keychain: Requerido para almacenamiento seguro de contraseñas

Advertencias de Gatekeeper (Descarga Directa)

Si descargaste HarborDB directamente, es posible que veas una advertencia de seguridad:

"HarborDB" no puede ser abierto porque el desarrollador no puede ser verificado.

Para resolver esto:

1. Ve a Preferencias del Sistema → Seguridad y Privacidad
2. Haz clic en "Abrir de Todas Formas" al lado de la advertencia de HarborDB
3. Confirma que quieres abrir la aplicación

Pasos Posteriores a la Instalación

1. Verificar Instalación

• Verifica que HarborDB aparece en tu carpeta Aplicaciones
• Confirma que la aplicación se inicia sin errores
• Revisa el menú Acerca de (HarborDB → Acerca de HarborDB) para información de versión

2. Verificar Actualizaciones

• Mac App Store: Las actualizaciones son automáticas, pero puedes verificarlas manualmente en la pestaña Actualizaciones de la App Store
• Descarga Directa: Verifica actualizaciones en HarborDB → Buscar Actualizaciones

3. Configurar Preferencias (Opcional)

• Ajusta el tema (Claro/Oscuro/Sistema)
• Configura opciones de conexión predeterminadas
• Configura atajos de teclado

Solución de Problemas de Instalación

Error "La aplicación está dañada"

Si ves "HarborDB.app está dañado y no puede ser abierto":

# Abre Terminal y ejecuta:
sudo xattr -cr /Applications/HarborDB.app

Permisos Insuficientes

Si HarborDB no puede acceder a los recursos requeridos:

1. Ve a Preferencias del Sistema → Seguridad y Privacidad → Privacidad
2. Concede los permisos necesarios (Accesibilidad, Archivos y Carpetas, etc.)
3. Reinicia HarborDB

La Instalación Falló

Si la instalación falla o la aplicación no se inicia:

1. Reinicia tu Mac e inténtalo de nuevo
2. Verifica espacio en disco - Asegúrate de tener al menos 500 MB libres
3. Verifica la versión de macOS - Revisa Acerca de este Mac → versión de macOS
4. Contacta con soporte si los problemas persisten

Desinstalación

Para eliminar HarborDB de tu sistema:

Versión de Mac App Store

1. Abre Finder → Aplicaciones
2. Arrastra HarborDB.app a la Papelera
3. Vacía la Papelera

Versión de Descarga Directa

1. Elimina la aplicación de /Applications

2. Elimina preferencias (opcional):

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

3. Elimina entradas de Keychain (opcional) - Abre Acceso a Keychain y busca "HarborDB"

Próximos Pasos

Ahora que HarborDB está instalado:

1. Crea tu primera conexión - Conéctate a una base de datos PostgreSQL
2. Explora la interfaz - Aprende sobre las características de HarborDB
3. Prueba consultas de ejemplo - Practica con SQL

¿Necesitas ayuda? Consulta nuestro FAQ o contacta con soporte.