Dépannage

Journaux, récupération de configuration, forçage de langue et résolution des problèmes courants.

Journaux

Runyard écrit un journal distinct pour chaque processus, action et commande d'installation sous ~/Library/Logs/Runyard/. Vous pouvez ouvrir directement ce dossier :

~/Library/Logs/Runyard/

Le sous-menu View Logs du menu ouvre ces fichiers directement dans Console.

Un outil refuse de démarrer — où regarder ?

1. Ouvrez le menu de l'outil et choisissez View Logs → {Label}. Faites défiler jusqu'en bas ; la plupart des échecs affichent une trace ou un message d'erreur à la fin.
2. Si l'outil a échoué pendant l'installation, ouvrez {NomOutil}-install.log.
3. Si le processus démarre mais n'atteint jamais l'état « running », la vérification d'état échoue probablement. Consultez le journal pour connaître l'URL interrogée, puis essayez cette URL dans un navigateur ou avec curl pour voir ce qu'elle retourne.

Causes courantes

• Commande introuvable. Le PATH de Runyard est construit à partir du tableau paths de votre configuration — il n'hérite pas du PATH de votre shell. Si npm ou node reste introuvable, ajoutez votre répertoire d'installation Node.js (par exemple ~/.nvm/versions/node/v22.0.0/bin) ou Homebrew (/opt/homebrew/bin) à paths.
• La vérification de démarrage expire. La valeur par défaut est 30 s. Augmentez advanced.startupTimeout globalement, ou définissez un startupRequestTimeout spécifique sur la commande de démarrage pour les points d'accès lents.
• Port non détecté. Certains processus forkent de manière que lsof ne peut pas tracer. Définissez startupFallbackPort sur la commande de démarrage comme indice.
• Boucles d'installation. Si installCommand s'exécute à chaque fois, c'est que markerPath (par défaut node_modules) ne correspond pas à ce que votre installateur crée. Définissez explicitement markerPath sur un fichier ou dossier dont l'existence post-installation est garantie.

Synchroniser entre plusieurs Mac

Vous pouvez déplacer config.json vers iCloud Drive, Dropbox ou tout autre dossier synchronisé afin que tous vos Mac partagent la même configuration. L'interface complète est documentée dans Fenêtre Réglages → Fichiers.

1. Ouvrez Runyard → Settings → General.
2. Sous Files, cliquez sur Change Location….
3. Choisissez un dossier synchronisé. Runyard y copie config.json et recharge depuis ce nouveau chemin.
4. Sur chacun de vos autres Mac, répétez l'opération et choisissez le même dossier.

Le chemin retenu est stocké localement par Mac dans les UserDefaults ; chaque machine doit donc être réglée une fois. Seul le fichier de configuration lui-même est synchronisé par votre service de synchronisation.

Repli lorsque l'emplacement synchronisé est indisponible

Si le dossier choisi est introuvable au lancement de Runyard (service de synchronisation hors ligne, volume démonté, etc.), Runyard :

1. Se replie sur l'emplacement par défaut (~/Library/Application Support/Runyard/config.json).
2. Affiche une notification vous informant du repli.

Une fois le dossier synchronisé de nouveau disponible, Runyard s'y reconnecte au prochain relancement.

Réinitialiser par défaut

Réglages → General → Reset to Default recopie config.json vers l'emplacement par défaut. La copie synchronisée n'est pas supprimée — vous pouvez revenir en arrière par la suite.

Récupérer une configuration cassée

Si config.json contient une erreur de syntaxe, Runyard affiche une alerte au lancement (et au rechargement) pointant vers la ligne fautive. Vous pouvez :

• Corriger sur place. Ouvrez Réglages → General → Open in Editor, ou utilisez Reload Configuration après modification pour vérifier.
• Restaurer la configuration d'exemple. Supprimez ~/Library/Application Support/Runyard/config.json. Au lancement suivant, Runyard écrit un nouvel exemple basé sur le modèle intégré.
• Garder une copie de sauvegarde. Si votre configuration réside dans un dossier synchronisé avec historique (iCloud Drive, Dropbox), revenez à la dernière révision fonctionnelle.

Forçage de langue

Runyard suit la langue système de macOS (Réglages Système → Général → Langue et région). Pour tester une langue précise sans modifier les réglages système, lancez depuis le Terminal :

# Anglais
open /Applications/Runyard.app --args -AppleLanguages "(en)"

# Français
open /Applications/Runyard.app --args -AppleLanguages "(fr)"

Cela n'affecte que le lancement en cours. Quittez Runyard puis rouvrez-le normalement pour revenir à l'état précédent.

Toujours bloqué ?

• Consultez le Guide de la barre de menus pour comprendre le comportement attendu de chaque fonctionnalité.
• Relisez la Référence config.json — la plupart des comportements « étranges » s'expliquent par une valeur par défaut (par exemple showWhen: "running" qui masque une action que vous venez d'ajouter).
• Si vous pensez qu'il s'agit d'un bogue, contactez-nous avec votre config.json anonymisé et l'extrait de journal pertinent :
  • Utilisez Send Feedback dans Réglages → Onglet About — l'e-mail est pré-rempli avec vos informations de version et joint (en option) automatiquement votre config.json.
  • Ou écrivez directement à support@bonevil.ca.