Valider le clavier et les méthodes de saisie d’un Mac distant

Après une connexion à distance à un Mac dans le cloud, le problème le plus souvent sous-estimé n’est pas une coupure réseau, mais un clavier qui fonctionne « presque correctement » : Command et Option sont inversées, les symboles de la rangée des chiffres ne correspondent pas, les touches de sélection des candidats sont interceptées par le client, ou les caractères saisis par un script d’automatisation diffèrent de ceux produits manuellement. Si ces anomalies ne sont découvertes qu’après la configuration de la chaîne d’outils, il devient difficile de déterminer si elles proviennent du système local, du client distant ou des sources de saisie de macOS. Il est donc plus fiable de valider la saisie avant d’initialiser l’espace de travail.

Commencer par figer les trois couches de la chaîne de saisie

Chaque frappe traverse successivement la disposition du clavier local, le mappage du client distant et la source de saisie du Mac dans le cloud. Modifier les trois couches en même temps rend le résultat impossible à reproduire. Il faut donc commencer par consigner l’état existant plutôt que de le changer immédiatement.

Côté local, relevez le type de clavier physique et la disposition active, puis vérifiez si le client distant propose des options telles que « transmettre les raccourcis système » ou « permuter Command et Option ». Côté Mac distant, consignez la version du système, les sources de saisie activées et les éventuels remappages de touches propres à l’utilisateur :

sw_vers
defaults read com.apple.HIToolbox AppleEnabledInputSources
defaults read com.apple.HIToolbox AppleCurrentKeyboardLayoutInputSourceID
hidutil property --get "UserKeyMapping"

Si la dernière commande renvoie un tableau vide, aucun mappage utilisateur n’a été ajouté sur l’hôte avec hidutil. Si un mappage existe, sauvegardez d’abord sa sortie, puis vérifiez s’il fait partie de la configuration de référence de l’équipe. N’ajoutez pas une seconde règle de permutation sans connaître l’origine de la première.

Une seule couche doit être chargée de convertir les touches de modification. Si le client les permute déjà, n’appliquez pas le même mappage sur l’hôte.

Localiser les décalages de disposition avec une matrice de caractères

Ne vous contentez pas d’ouvrir un éditeur et de saisir quelques lettres. Effectuez les tests dans une fenêtre de texte brut et dans un ordre fixe afin d’éviter les interférences dues aux raccourcis de l’éditeur, à la complétion de code ou aux remplacements automatiques.

Pour tester les symboles, définissez explicitement la disposition logique adoptée par l’équipe, par exemple ANSI américain, au lieu de vous fier aux inscriptions des touches de chaque membre. Lorsqu’une machine distante sert à des tâches automatisées, une disposition logique commune est plus fiable que la reproduction des habitudes locales de chaque développeur.

Écarter les remplacements automatiques de texte

Si les guillemets droits, les traits d’union ou les espaces consécutives sont automatiquement remplacés, recommencez le test en mode texte brut. Lorsque les caractères sont corrects mais que le résultat diffère dans l’éditeur, le problème relève généralement du traitement de texte de l’application. Il ne faut alors pas continuer à modifier le mappage clavier du système.

Valider séparément les touches de modification et les raccourcis

Les problèmes de touches de modification sont souvent propres à certaines combinaisons. Le bon fonctionnement de Command+C ne garantit pas que Option+chiffre, Control+lettre ou Command+Shift produisent le résultat attendu. Il est recommandé de définir un jeu minimal de raccourcis couvrant la copie, le changement de fenêtre, le déplacement mot par mot, les combinaisons de majuscules et les touches réservées par le client.

Si un mappage incorrect subsiste sur l’hôte, vous pouvez le supprimer pour la session utilisateur en cours :

hidutil property --set '{"UserKeyMapping":[]}'

Après cette réinitialisation, vous devez fermer complètement la session distante, vous reconnecter, puis exécuter de nouveau la matrice de caractères. Si le problème disparaît, intégrez la correction au script d’initialisation de session au lieu de demander aux membres de modifier manuellement les réglages. S’il persiste, restaurez la configuration de référence de l’hôte et examinez les règles de transmission des touches du client.

Détecter les raccourcis interceptés par le client

Lorsqu’une combinaison précise n’atteint jamais le bureau distant alors que les autres fonctionnent, le système local ou le client l’a probablement consommée en premier. Il faut alors utiliser une autre combinaison de test ou modifier les réglages du client, et non tenter de compenser sur l’hôte une frappe qui ne lui a jamais été transmise.

Valider les limites entre méthode de saisie et automatisation

Les tests de méthode de saisie doivent au minimum couvrir le changement de source, la composition continue, le défilement des pages de candidats, la validation avec Entrée, la ponctuation en pleine chasse et en demi-chasse, ainsi que la cohérence entre le terminal et les applications graphiques. Les champs de mot de passe, le mode de saisie sécurisée du terminal et certains clients distants peuvent limiter la composition. Il ne faut donc pas tirer de conclusion à partir d’une seule application.

Les tâches automatisées ne doivent jamais dépendre de la « méthode de saisie active ». Lorsqu’un script génère un fichier de configuration, un numéro de version ou des données de test, il doit écrire directement dans un fichier UTF-8 ou transmettre les valeurs sous forme d’arguments de commande. Les tests qui pilotent une interface graphique doivent eux aussi sélectionner la source de saisie convenue avant de commencer et inscrire son identifiant actuel dans les journaux. Il devient ainsi possible de distinguer un échec fonctionnel d’une dérive de l’environnement de saisie.

Pour les tâches de longue durée sur VMOak, il est recommandé d’intégrer la liste des sources de saisie et les résultats de la matrice de caractères au journal d’initialisation du nœud. Pour une intervention distante de courte durée, conservez au minimum la version du client et la disposition sélectionnée.

Retester après reconnexion et établir une configuration de référence

La validation de la saisie doit obligatoirement inclure une déconnexion complète suivie d’une reconnexion. Fermer uniquement la fenêtre de l’application ne suffit pas : terminez la session distante, reconnectez-vous, puis contrôlez de nouveau la disposition active, les touches de modification et la source de saisie. Si la dérive n’apparaît qu’après la reconnexion, vérifiez en priorité si le client remplace la disposition selon le profil de connexion et si un script de configuration s’exécute à l’ouverture de session.

La configuration de référence finale peut rester très courte :

1. Adopter une seule disposition logique de clavier.
2. Permuter les touches de modification sur une seule couche, soit le client, soit l’hôte.
3. Conserver les sorties de AppleEnabledInputSources et UserKeyMapping.
4. Exécuter toute la matrice de caractères et les cinq groupes de raccourcis.
5. Tester une fois la méthode de saisie dans le terminal et une fois dans une application graphique.
6. Répéter les contrôles essentiels après une déconnexion et une reconnexion.

L’objectif n’est pas de « régler le clavier pour qu’il fonctionne cette fois-ci », mais d’identifier l’unique couche responsable de la conversion et de garantir le même résultat à la connexion suivante. Une fois cette configuration de référence validée, vous pouvez installer les dépendances de développement ou raccorder les tâches automatisées. Les incidents ultérieurs seront alors beaucoup plus faciles à attribuer à leur véritable cause.

Questions fréquentes