01 Ajouter votre premier dépôt
Préparez un clone local.
Clonez le dépôt avec votre outil Git habituel et vérifiez que son dépôt distant est accessible. Les versions de développement utilisent Git installé sur votre Mac. La version du store en bac à sable intègre Git et demande l’accès au dépôt via le sélecteur de dossiers du système.
Ouvrez la barre des menus et choisissez « Ajouter un suivi ».
Sélectionnez le dépôt local, puis cochez une ou plusieurs branches distantes. Chaque branche suit les changements indépendamment ; les branches d’un même dépôt partagent une carte. Modifiez le dépôt ultérieurement pour ajouter ou retirer des branches.
Attendez la première vérification réussie.
La première vérification établit une référence sans signaler les commits existants. Les changements suivants produisent une notification et un son par branche et par lot.
02 Voir qui a changé quoi
Les cartes repliées affichent le dernier commit de chaque branche, avec son auteur et sa date. Dépliez un dépôt pour unifier l’historique de toutes les branches surveillées. Les commits communs apparaissent une seule fois avec leurs branches, du plus récent au plus ancien selon la date du commit.
Le nombre d’entrées est de 10 par défaut. Les Réglages acceptent de 5 à 20 entrées, comptées après regroupement, déduplication et filtrage des auteurs. Le corps des longs messages défile dans l’historique.
Le menu de la carte permet d’épingler, modifier, suspendre, reprendre ou confirmer la suppression. La barre des menus distingue les états inactif, vérification en cours et mises à jour non lues. Ouvrir le panneau marque toutes les mises à jour comme lues ; le fermer laisse la surveillance active.
Les dates proviennent des commits Git, et non de l’heure du push ou de la détection. Git Knock vérifie périodiquement au lieu de recevoir des événements push instantanés.
04 Choisir votre signal
Ouvrez les Réglages avec le bouton en forme d’engrenage. Tous les dépôts partagent le même intervalle : 1 minute par défaut, réglable de 1 à 60 minutes entières.
Choisir un son
Choisissez parmi 14 sons système macOS ou désactivez les sons automatiques. Pour importer un son personnel, choisissez un fichier MP3, WAV ou AIFF d’une durée supérieure à zéro et de 15 secondes maximum. Écoutez-le avec le bouton de lecture.
L’app enregistre une copie locale. Un fichier invalide ou un échec d’importation conserve le choix précédent. Un son personnalisé illisible ou impossible à lire est remplacé par le son par défaut. Utilisez des enregistrements ou des sons que vous avez le droit d’utiliser ; aucun extrait vocal de jeu n’est fourni.
Langue et barre des menus
Suivez la langue du système ou choisissez le chinois, l’anglais, le coréen, le japonais, l’espagnol, le portugais, le français ou l’allemand. Les langues système non prises en charge utilisent l’anglais. Les noms des dépôts et les messages de commit conservent leur langue d’origine.
Activez l’affichage du dernier commit dans la barre des menus pour obtenir deux lignes de contexte. Choisissez séparément le dépôt, la branche, l’auteur et l’heure, et affichez le dernier segment ou le nom complet de la branche. Désactivez tous les champs pour ne garder que l’icône ; l’infobulle conserve les détails complets.
Ouverture de session et fermeture de l’app
Le lancement à l’ouverture de session peut nécessiter une autorisation dans les Réglages Système de macOS. Fermer le panneau le masque. « Quitter Git Knock », au bas des Réglages, arrête la surveillance et ferme l’app.
05 Aucun signal ?
Essayez une notification et un son de test.
Envoyez une notification de test depuis les Réglages. Vérifiez l’autorisation de notification macOS, le style d’alerte et le mode Concentration. Un test ne représente pas un commit et ne joue pas le son de mise à jour. Écoutez le son séparément et vérifiez le volume et les appareils de sortie.
Accès SSH dans la version du store
Pour les dépôts distants SSH, autorisez le dossier de configuration SSH existant, généralement .ssh, dans Réglages → Configuration SSH. Il doit déjà contenir un fichier non vide nommé known_hosts . L’accès est en lecture seule : l’app ne copie pas les clés privées et ne fait pas automatiquement confiance aux nouveaux hôtes. Les dépôts distants HTTPS et locaux n’ont pas besoin de cette autorisation SSH. Les clés externes, les proxys et les assistants d’identification doivent rester accessibles dans le bac à sable.
Vérifiez la surveillance et la connexion distante.
Vérifiez que le suivi est actif et que sa référence a été établie. Attendez un intervalle de vérification. Si la connexion distante échoue, exécutez git ls-remote --heads origin dans le même dépôt ; remplacez origin si nécessaire. Les problèmes de SSH, de proxy et d’identification peuvent affecter la découverte des branches comme les vérifications.
Consultez Assistance pour obtenir de l’aide, en indiquant la version de l’app, celle de macOS et quelques étapes de reproduction.
06 Que se passe-t-il dans le dépôt ?
Git Knock récupère les cibles sélectionnées dans des références Git propres à l’app. Il n’effectue ni pull, ni changement de branche, ni fusion, ni modification des fichiers de travail ou des références ordinaires de suivi distant et des tags. Vous décidez quand intégrer le code.
Il signale des changements de code, pas l’achèvement de tâches, de tests ou de déploiements. Un historique poussé puis entièrement supprimé entre deux vérifications peut passer inaperçu.