Ce guide fournit des instructions étape par étape pour installer HarborDB sur votre appareil macOS.

Méthodes d'installation

Mac App Store (Recommandé)

Le moyen le plus simple d'installer HarborDB est via le Mac App Store officiel :

Ouvrez le Mac App Store sur votre appareil macOS
Recherchez "HarborDB" dans la barre de recherche
Cliquez sur "Obtenir" ou le bouton de prix (19,99 $) pour acheter et télécharger
Attendez l'installation - L'application se téléchargera et s'installera automatiquement
Lancez HarborDB depuis votre dossier Applications, Launchpad ou Spotlight

Avantages de l'installation via le Mac App Store :

Mises à jour automatiques
Distribution vérifiée et sécurisée
Installation et désinstallation faciles
Prise en charge du Partage familial

Téléchargement direct (Alternative)

Pour les déploiements d'entreprise ou à des fins de test, vous pouvez télécharger HarborDB directement :

Visitez notre page de téléchargement à l'adresse harbordb.com/download
Téléchargez le dernier fichier .dmg
Ouvrez le fichier .dmg en double-cliquant dessus
Glissez HarborDB dans votre dossier Applications
Éjectez l'image disque après la copie

Note de sécurité : Lors d'un téléchargement direct, assurez-vous de vérifier l'authenticité du téléchargement en utilisant les sommes de contrôle fournies.

Exigences système

Avant d'installer, vérifiez que votre système répond à ces exigences :

Exigences minimales

macOS : 12.0 (Monterey) ou version ultérieure
Processeur : Intel Core i5 (8ᵉ génération) ou Apple Silicon (M1)
Mémoire : 8 Go de RAM
Stockage : 200 Mo d'espace disponible
Écran : Résolution 1280 × 800

Exigences recommandées

macOS : 13.0 (Ventura) ou version ultérieure
Processeur : Apple Silicon (M2 ou plus récent)
Mémoire : 16 Go de RAM ou plus
Stockage : 500 Mo d'espace disponible (pour le cache et les exportations)
Écran : Résolution 1920 × 1080 ou supérieure

Exigences du serveur PostgreSQL

PostgreSQL : Version 9.6 ou ultérieure (12+ recommandé)
Réseau : Connectivité TCP/IP au serveur PostgreSQL
Permissions : L'utilisateur doit avoir les permissions de connexion et de requête

Premier lancement

Après l'installation, lancez HarborDB pour la première fois :

Localisez HarborDB dans votre dossier Applications ou utilisez Spotlight (⌘ + Espace, tapez "HarborDB")
Double-cliquez pour lancer - Vous devrez peut-être accorder l'autorisation pour l'exécution de l'application (première fois seulement)
Examinez les permissions système :
- Accessibilité : Requise pour les raccourcis clavier et les améliorations de l'interface utilisateur (optionnelle)
- Réseau : Requise pour les connexions à la base de données
- Trousseau : Requise pour le stockage sécurisé des mots de passe

Avertissements Gatekeeper (Téléchargement direct)

Si vous avez téléchargé HarborDB directement, vous pourriez voir un avertissement de sécurité :

"HarborDB" ne peut pas être ouvert car le développeur n'est pas vérifié.

Pour résoudre ce problème :

Allez dans Préférences Système → Sécurité et confidentialité
Cliquez sur "Ouvrir quand même" à côté de l'avertissement HarborDB
Confirmez que vous voulez ouvrir l'application

Étapes post-installation

1. Vérifier l'installation

Vérifiez que HarborDB apparaît dans votre dossier Applications
Vérifiez que l'application se lance sans erreurs
Consultez le menu À propos (HarborDB → À propos de HarborDB) pour les informations de version

2. Vérifier les mises à jour

Mac App Store : Les mises à jour sont automatiques, mais vous pouvez vérifier manuellement dans l'onglet Mises à jour de l'App Store
Téléchargement direct : Vérifiez les mises à jour dans HarborDB → Vérifier les mises à jour

3. Configurer les préférences (Optionnel)

Ajustez le thème (Clair/Sombre/Système)
Configurez les paramètres de connexion par défaut
Configurez les raccourcis clavier

Dépannage des problèmes d'installation

Erreur "L'application est endommagée"

Si vous voyez "HarborDB.app est endommagé et ne peut pas être ouvert" :

# Ouvrez le Terminal et exécutez :
sudo xattr -cr /Applications/HarborDB.app

Permissions insuffisantes

Si HarborDB ne peut pas accéder aux ressources nécessaires :

Allez dans Préférences Système → Sécurité et confidentialité → Confidentialité
Accordez les permissions nécessaires (Accessibilité, Fichiers et dossiers, etc.)
Redémarrez HarborDB

L'installation échoue

Si l'installation échoue ou que l'application ne se lance pas :

Redémarrez votre Mac et réessayez
Vérifiez l'espace disque - Assurez-vous d'avoir au moins 500 Mo de libre
Vérifiez la version de macOS - Consultez À propos de ce Mac → Version de macOS
Contactez le support si les problèmes persistent

Désinstallation

Pour supprimer HarborDB de votre système :

Version Mac App Store

Ouvrez Finder → Applications
Glissez HarborDB.app vers la Corbeille
Videz la Corbeille

Version téléchargement direct

Supprimez l'application de /Applications

Supprimez les préférences (optionnel) :

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

Supprimez les entrées du Trousseau (optionnel) - Ouvrez Accès au trousseau et recherchez "HarborDB"

Prochaines étapes

Maintenant que HarborDB est installé :

Créez votre première connexion - Connectez-vous à une base de données PostgreSQL
Explorez l'interface - Découvrez les fonctionnalités de HarborDB
Essayez des requêtes d'exemple - Pratiquez avec SQL

Besoin d'aide ? Consultez notre FAQ ou contactez le support.

Installation