Tastaturbelegung und Eingabemethoden am Remote-Mac prüfen

Nach dem Remote-Zugriff auf einen Cloud-Mac werden nicht Verbindungsabbrüche am häufigsten unterschätzt, sondern Tastaturprobleme, bei denen die Eingabe zwar grundsätzlich funktioniert, aber nicht vollständig korrekt ist: Command und Option sind vertauscht, die Sonderzeichen der Ziffernreihe liegen auf den falschen Tasten, Tasten für die chinesische Kandidatenauswahl werden vom Client abgefangen oder Automatisierungsskripte erzeugen andere Zeichen als bei manueller Eingabe. Werden solche Fehler erst nach der Einrichtung der Toolchain entdeckt, lässt sich nur schwer feststellen, ob die Ursache im lokalen System, im Remote-Client oder in den macOS-Eingabequellen liegt. Zuverlässiger ist es, die Eingabe vor der Initialisierung des Arbeitsbereichs zu prüfen.

Zuerst die drei Ebenen der Eingabekette festlegen

Jeder Tastendruck durchläuft nacheinander das lokale Tastaturlayout, die Zuordnung des Remote-Clients und die Eingabequelle des Cloud-Macs. Werden alle drei Ebenen gleichzeitig angepasst, sind die Ergebnisse nicht reproduzierbar. Deshalb sollten die Einstellungen zunächst dokumentiert und nicht sofort geändert werden.

Auf dem lokalen System müssen der physische Tastaturtyp, das aktuell verwendete Layout und Optionen des Remote-Clients wie „Systemtastenkürzel senden“ oder „Command und Option vertauschen“ geprüft werden. Auf dem Cloud-Mac werden dagegen die Systemversion, die aktivierten Eingabequellen und benutzerspezifische Tastenzuordnungen erfasst:

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

Gibt der letzte Befehl ein leeres Array zurück, wurde auf dem Host keine zusätzliche Benutzerzuordnung über hidutil eingerichtet. Sind Zuordnungen vorhanden, sollte die Ausgabe zunächst gespeichert und anschließend geprüft werden, ob sie zur Team-Baseline gehört. Solange ihre Herkunft unbekannt ist, darf keine zweite Regel zum Vertauschen von Tasten ergänzt werden.

Die Umwandlung von Modifikatortasten darf immer nur auf einer Ebene erfolgen. Wenn der Client die Tasten bereits vertauscht, darf dieselbe Zuordnung nicht noch einmal auf dem Host eingerichtet werden.

Layout-Abweichungen mit einer Zeichenmatrix ermitteln

Es reicht nicht, in einem Editor lediglich einige Buchstaben einzugeben. Der Test sollte in einem reinen Textfenster und in einer festgelegten Reihenfolge erfolgen, damit Tastenkürzel, Codevervollständigung oder automatische Ersetzungen des Editors das Ergebnis nicht verfälschen.

Beim Testen von Sonderzeichen muss festgelegt sein, welches logische Layout das Team verwendet, beispielsweise US-ANSI. Maßgeblich darf nicht die individuelle Tastenbeschriftung der einzelnen Teammitglieder sein. Wenn ein Remote-Rechner Automatisierungsaufgaben ausführt, ist ein einheitliches logisches Layout zuverlässiger als die Übernahme der lokalen Gewohnheiten jedes Entwicklers.

Störungen durch Textersetzungen ausschließen

Werden gerade Anführungszeichen, Bindestriche oder aufeinanderfolgende Leerzeichen automatisch ersetzt, sollte der Test zunächst im Nur-Text-Modus wiederholt werden. Sind die Zeichen selbst korrekt, unterscheiden sich aber die Ergebnisse im Editor, liegt die Ursache normalerweise in der Textverarbeitung der Anwendung. In diesem Fall sollten die systemweiten Tastaturzuordnungen nicht weiter verändert werden.

Modifikatortasten und Tastenkürzel separat prüfen

Fehler bei Modifikatortasten treten häufig nur bei bestimmten Kombinationen auf: Wenn Command+C funktioniert, bedeutet das nicht, dass auch Option+Ziffer, Control+Buchstabe oder Command+Shift korrekt verarbeitet werden. Empfehlenswert ist ein minimaler Satz von Tastenkürzeln, der Kopieren, Fensterwechsel, wortweises Navigieren, Kombinationen mit Groß- und Kleinschreibung sowie vom Client reservierte Tasten abdeckt.

Wenn bestätigt ist, dass auf dem Host eine fehlerhafte Zuordnung verblieben ist, kann sie für die aktuelle Anmeldesitzung gelöscht werden:

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

Nach dem Löschen muss die Remote-Sitzung getrennt und neu aufgebaut werden, bevor die Zeichenmatrix erneut ausgeführt wird. Verschwindet das Problem, sollte die Korrektur in das Skript zur Sitzungsinitialisierung aufgenommen werden, anstatt die Teammitglieder Einstellungen manuell ändern zu lassen. Besteht das Problem weiterhin, muss die Host-Baseline wiederhergestellt und die Untersuchung auf die Regeln zur Tastenweiterleitung des Clients verlagert werden.

Vom Client abgefangene Tastenkombinationen erkennen

Erreicht eine bestimmte Tastenkombination den Remote-Desktop überhaupt nicht, während andere Kombinationen normal funktionieren, wurde sie meist bereits vom lokalen System oder vom Client verarbeitet. In diesem Fall sollte eine andere Testkombination verwendet oder die Client-Einstellung angepasst werden. Eine Taste, die nie an den Host übertragen wurde, darf nicht durch eine hostseitige Neuzuordnung kompensiert werden.

Grenzen von Eingabemethoden und Automatisierung prüfen

Der Test einer Eingabemethode muss mindestens den Wechsel der Eingabequelle, die fortlaufende Wortbildung, das Blättern durch Kandidaten, die Bestätigung mit der Eingabetaste, Satzzeichen in voller und halber Breite sowie die Konsistenz zwischen Terminal und grafischen Anwendungen abdecken. Passwortfelder, der sichere Eingabemodus des Terminals und einige Remote-Clients können zusammengesetzte Eingaben einschränken. Deshalb darf aus einem Test in nur einer Anwendung keine allgemeine Schlussfolgerung gezogen werden.

Automatisierungsaufgaben dürfen nicht von der „aktuell ausgewählten Eingabemethode“ abhängen. Wenn ein Skript Konfigurationsdateien, Versionsnummern oder Testdaten erzeugt, sollte es direkt UTF-8-Dateien schreiben oder Werte über Befehlsparameter übergeben. Auch Tests, die eine grafische Benutzeroberfläche steuern, müssen vor dem Start zur vereinbarten Eingabequelle wechseln und deren aktuelle Kennung protokollieren. So lassen sich Fehler in den eigentlichen Tests von Abweichungen der Eingabeumgebung trennen.

Für langfristige Aufgaben auf VMOak empfiehlt es sich, die Liste der Eingabequellen und die Ergebnisse der Zeichenmatrix in die Initialisierungsdokumentation des Knotens aufzunehmen. Bei kurzen Remote-Einsätzen sollten mindestens die Client-Version und das ausgewählte Layout festgehalten werden.

Nach der Wiederverbindung erneut prüfen und eine Baseline erstellen

Die Eingabeprüfung muss eine vollständige Trennung und Wiederverbindung umfassen. Es reicht nicht, lediglich das Anwendungsfenster zu schließen. Die Remote-Sitzung muss beendet und neu aufgebaut werden; anschließend sind das aktuelle Layout, die Modifikatortasten und die Eingabequelle erneut zu prüfen. Treten Abweichungen erst nach der Wiederverbindung auf, ist besonders zu kontrollieren, ob der Client das Layout anhand des Verbindungsprofils überschreibt und ob bei der Anmeldung ein Konfigurationsskript ausgeführt wird.

Die endgültige Baseline kann sehr kurz gehalten werden:

1. Ein logisches Tastaturlayout verbindlich festlegen.
2. Modifikatortasten entweder im Client oder auf dem Host vertauschen, niemals auf beiden Ebenen.
3. Die Ausgaben von AppleEnabledInputSources und UserKeyMapping speichern.
4. Die vollständige Zeichenmatrix und fünf Gruppen von Tastenkürzeln testen.
5. Die Eingabemethode jeweils einmal im Terminal und in einer grafischen Anwendung prüfen.
6. Nach dem Trennen und Wiederverbinden die wichtigsten Prüfpunkte wiederholen.

Bei Eingabeproblemen geht es nicht darum, die Konfiguration so lange anzupassen, bis sie dieses eine Mal funktioniert. Stattdessen muss genau eine Ebene für die Umwandlung verantwortlich sein, damit die nächste Verbindung dasselbe Ergebnis liefert. Erst nach Abschluss dieser Baseline sollten Entwicklungsabhängigkeiten installiert oder Automatisierungsaufgaben eingebunden werden. Spätere Fehler lassen sich dann wesentlich leichter einer Ursache zuordnen.

Häufig gestellte Fragen