Unverified Commit d87faf92 authored by Tong Mu's avatar Tong Mu Committed by GitHub

[Keyboard, iOS] Generate iOS's special key mapping (#106909)

parent cadb264d
...@@ -48,4 +48,9 @@ const std::set<uint32_t> functionKeyCodes = { ...@@ -48,4 +48,9 @@ const std::set<uint32_t> functionKeyCodes = {
@@@IOS_FUNCTION_KEY_SET@@@ @@@IOS_FUNCTION_KEY_SET@@@
}; };
API_AVAILABLE(ios(13.4))
NSDictionary<NSString*, NSNumber*>* specialKeyMapping = [[NSDictionary alloc] initWithDictionary:@{
@@@SPECIAL_KEY_MAPPING@@@
}];
@@@SPECIAL_KEY_CONSTANTS@@@ @@@SPECIAL_KEY_CONSTANTS@@@
...@@ -78,6 +78,15 @@ const Map<int, PhysicalKeyboardKey> kIosToPhysicalKey = <int, PhysicalKeyboardKe ...@@ -78,6 +78,15 @@ const Map<int, PhysicalKeyboardKey> kIosToPhysicalKey = <int, PhysicalKeyboardKe
@@@IOS_SCAN_CODE_MAP@@@ @@@IOS_SCAN_CODE_MAP@@@
}; };
/// Maps iOS specific string values of nonvisible keys to logical keys
///
/// Some unprintable keys on iOS has literal names on their key label, such as
/// "UIKeyInputEscape". See:
/// https://developer.apple.com/documentation/uikit/uikeycommand/input_strings_for_special_keys?language=objc
const Map<String, LogicalKeyboardKey> kIosSpecialLogicalMap = <String, LogicalKeyboardKey>{
@@@IOS_SPECIAL_MAP@@@
};
/// A map of iOS key codes which have printable representations, but appear /// A map of iOS key codes which have printable representations, but appear
/// on the number pad. Used to provide different key objects for keys like /// on the number pad. Used to provide different key objects for keys like
/// KEY_EQUALS and NUMPAD_EQUALS. /// KEY_EQUALS and NUMPAD_EQUALS.
......
// Copyright 2014 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
/// Maps iOS's special key labels to logical key names.
///
/// See https://developer.apple.com/documentation/uikit/uikeycommand/input_strings_for_special_keys?language=objc
const Map<String, String> kIosSpecialKeyMapping = <String, String>{
'UIKeyInputEscape': 'Escape',
'UIKeyInputF1': 'F1',
'UIKeyInputF2': 'F2',
'UIKeyInputF3': 'F3',
'UIKeyInputF4': 'F4',
'UIKeyInputF5': 'F5',
'UIKeyInputF6': 'F6',
'UIKeyInputF7': 'F7',
'UIKeyInputF8': 'F8',
'UIKeyInputF9': 'F9',
'UIKeyInputF10': 'F10',
'UIKeyInputF11': 'F11',
'UIKeyInputF12': 'F12',
'UIKeyInputUpArrow': 'ArrowUp',
'UIKeyInputDownArrow': 'ArrowDown',
'UIKeyInputLeftArrow': 'ArrowLeft',
'UIKeyInputRightArrow': 'ArrowRight',
'UIKeyInputHome': 'Home',
'UIKeyInputEnd': 'Enter',
'UIKeyInputPageUp': 'PageUp',
'UIKeyInputPageDown': 'PageDown',
};
...@@ -6,6 +6,7 @@ import 'package:path/path.dart' as path; ...@@ -6,6 +6,7 @@ import 'package:path/path.dart' as path;
import 'base_code_gen.dart'; import 'base_code_gen.dart';
import 'constants.dart'; import 'constants.dart';
import 'data.dart';
import 'logical_key_data.dart'; import 'logical_key_data.dart';
import 'physical_key_data.dart'; import 'physical_key_data.dart';
import 'utils.dart'; import 'utils.dart';
...@@ -105,6 +106,15 @@ class IOSCodeGenerator extends PlatformCodeGenerator { ...@@ -105,6 +106,15 @@ class IOSCodeGenerator extends PlatformCodeGenerator {
return modifierKeyMap.toString().trimRight(); return modifierKeyMap.toString().trimRight();
} }
String get _specialKeyMapping {
final OutputLines<int> lines = OutputLines<int>('iOS special key mapping');
kIosSpecialKeyMapping.forEach((String key, String logicalName) {
final int value = logicalData.entryByName(logicalName).value;
lines.add(value, ' @"$key" : @(${toHex(value)}),');
});
return lines.join().trimRight();
}
/// This generates some keys that needs special attention. /// This generates some keys that needs special attention.
String get _specialKeyConstants { String get _specialKeyConstants {
final StringBuffer specialKeyConstants = StringBuffer(); final StringBuffer specialKeyConstants = StringBuffer();
...@@ -137,6 +147,7 @@ class IOSCodeGenerator extends PlatformCodeGenerator { ...@@ -137,6 +147,7 @@ class IOSCodeGenerator extends PlatformCodeGenerator {
'KEYCODE_TO_MODIFIER_FLAG_MAP': _keyToModifierFlagMap, 'KEYCODE_TO_MODIFIER_FLAG_MAP': _keyToModifierFlagMap,
'MODIFIER_FLAG_TO_KEYCODE_MAP': _modifierFlagToKeyMap, 'MODIFIER_FLAG_TO_KEYCODE_MAP': _modifierFlagToKeyMap,
'SPECIAL_KEY_CONSTANTS': _specialKeyConstants, 'SPECIAL_KEY_CONSTANTS': _specialKeyConstants,
'SPECIAL_KEY_MAPPING': _specialKeyMapping,
}; };
} }
} }
...@@ -7,6 +7,7 @@ import 'dart:io'; ...@@ -7,6 +7,7 @@ import 'dart:io';
import 'package:path/path.dart' as path; import 'package:path/path.dart' as path;
import 'base_code_gen.dart'; import 'base_code_gen.dart';
import 'data.dart';
import 'logical_key_data.dart'; import 'logical_key_data.dart';
import 'physical_key_data.dart'; import 'physical_key_data.dart';
import 'utils.dart'; import 'utils.dart';
...@@ -246,6 +247,16 @@ class KeyboardMapsCodeGenerator extends BaseCodeGenerator { ...@@ -246,6 +247,16 @@ class KeyboardMapsCodeGenerator extends BaseCodeGenerator {
return lines.sortedJoin().trimRight(); return lines.sortedJoin().trimRight();
} }
/// This generates the map of iOS key label to logical keys for special keys.
String get _iOSSpecialMap {
final OutputLines<int> lines = OutputLines<int>('iOS special key mapping');
kIosSpecialKeyMapping.forEach((String key, String logicalName) {
final LogicalKeyEntry entry = logicalData.entryByName(logicalName);
lines.add(entry.value, " '$key': LogicalKeyboardKey.${entry.constantName},");
});
return lines.join().trimRight();
}
/// This generates the map of iOS number pad key codes to logical keys. /// This generates the map of iOS number pad key codes to logical keys.
String get _iOSNumpadMap { String get _iOSNumpadMap {
final OutputLines<int> lines = OutputLines<int>('iOS numpad map'); final OutputLines<int> lines = OutputLines<int>('iOS numpad map');
...@@ -353,6 +364,7 @@ class KeyboardMapsCodeGenerator extends BaseCodeGenerator { ...@@ -353,6 +364,7 @@ class KeyboardMapsCodeGenerator extends BaseCodeGenerator {
'MACOS_FUNCTION_KEY_MAP': _macOSFunctionKeyMap, 'MACOS_FUNCTION_KEY_MAP': _macOSFunctionKeyMap,
'MACOS_KEY_CODE_MAP': _macOSKeyCodeMap, 'MACOS_KEY_CODE_MAP': _macOSKeyCodeMap,
'IOS_SCAN_CODE_MAP': _iOSScanCodeMap, 'IOS_SCAN_CODE_MAP': _iOSScanCodeMap,
'IOS_SPECIAL_MAP': _iOSSpecialMap,
'IOS_NUMPAD_MAP': _iOSNumpadMap, 'IOS_NUMPAD_MAP': _iOSNumpadMap,
'IOS_KEY_CODE_MAP': _iOSKeyCodeMap, 'IOS_KEY_CODE_MAP': _iOSKeyCodeMap,
'GLFW_KEY_CODE_MAP': _glfwKeyCodeMap, 'GLFW_KEY_CODE_MAP': _glfwKeyCodeMap,
......
...@@ -1468,6 +1468,35 @@ const Map<int, PhysicalKeyboardKey> kIosToPhysicalKey = <int, PhysicalKeyboardKe ...@@ -1468,6 +1468,35 @@ const Map<int, PhysicalKeyboardKey> kIosToPhysicalKey = <int, PhysicalKeyboardKe
0x000000e7: PhysicalKeyboardKey.metaRight, 0x000000e7: PhysicalKeyboardKey.metaRight,
}; };
/// Maps iOS specific string values of nonvisible keys to logical keys
///
/// Some unprintable keys on iOS has literal names on their key label, such as
/// "UIKeyInputEscape". See:
/// https://developer.apple.com/documentation/uikit/uikeycommand/input_strings_for_special_keys?language=objc
const Map<String, LogicalKeyboardKey> kIosSpecialLogicalMap = <String, LogicalKeyboardKey>{
'UIKeyInputEscape': LogicalKeyboardKey.escape,
'UIKeyInputF1': LogicalKeyboardKey.f1,
'UIKeyInputF2': LogicalKeyboardKey.f2,
'UIKeyInputF3': LogicalKeyboardKey.f3,
'UIKeyInputF4': LogicalKeyboardKey.f4,
'UIKeyInputF5': LogicalKeyboardKey.f5,
'UIKeyInputF6': LogicalKeyboardKey.f6,
'UIKeyInputF7': LogicalKeyboardKey.f7,
'UIKeyInputF8': LogicalKeyboardKey.f8,
'UIKeyInputF9': LogicalKeyboardKey.f9,
'UIKeyInputF10': LogicalKeyboardKey.f10,
'UIKeyInputF11': LogicalKeyboardKey.f11,
'UIKeyInputF12': LogicalKeyboardKey.f12,
'UIKeyInputUpArrow': LogicalKeyboardKey.arrowUp,
'UIKeyInputDownArrow': LogicalKeyboardKey.arrowDown,
'UIKeyInputLeftArrow': LogicalKeyboardKey.arrowLeft,
'UIKeyInputRightArrow': LogicalKeyboardKey.arrowRight,
'UIKeyInputHome': LogicalKeyboardKey.home,
'UIKeyInputEnd': LogicalKeyboardKey.enter,
'UIKeyInputPageUp': LogicalKeyboardKey.pageUp,
'UIKeyInputPageDown': LogicalKeyboardKey.pageDown,
};
/// A map of iOS key codes which have printable representations, but appear /// A map of iOS key codes which have printable representations, but appear
/// on the number pad. Used to provide different key objects for keys like /// on the number pad. Used to provide different key objects for keys like
/// KEY_EQUALS and NUMPAD_EQUALS. /// KEY_EQUALS and NUMPAD_EQUALS.
......
...@@ -12,32 +12,6 @@ export 'package:flutter/foundation.dart' show DiagnosticPropertiesBuilder; ...@@ -12,32 +12,6 @@ export 'package:flutter/foundation.dart' show DiagnosticPropertiesBuilder;
export 'keyboard_key.g.dart' show LogicalKeyboardKey, PhysicalKeyboardKey; export 'keyboard_key.g.dart' show LogicalKeyboardKey, PhysicalKeyboardKey;
export 'raw_keyboard.dart' show KeyboardSide, ModifierKey; export 'raw_keyboard.dart' show KeyboardSide, ModifierKey;
/// Maps iOS specific string values of nonvisible keys to logical keys
///
/// See: https://developer.apple.com/documentation/uikit/uikeycommand/input_strings_for_special_keys?language=objc
const Map<String, LogicalKeyboardKey> _kIosToLogicalMap = <String, LogicalKeyboardKey>{
'UIKeyInputEscape': LogicalKeyboardKey.escape,
'UIKeyInputF1': LogicalKeyboardKey.f1,
'UIKeyInputF2': LogicalKeyboardKey.f2,
'UIKeyInputF3': LogicalKeyboardKey.f3,
'UIKeyInputF4': LogicalKeyboardKey.f4,
'UIKeyInputF5': LogicalKeyboardKey.f5,
'UIKeyInputF6': LogicalKeyboardKey.f6,
'UIKeyInputF7': LogicalKeyboardKey.f7,
'UIKeyInputF8': LogicalKeyboardKey.f8,
'UIKeyInputF9': LogicalKeyboardKey.f9,
'UIKeyInputF10': LogicalKeyboardKey.f10,
'UIKeyInputF11': LogicalKeyboardKey.f11,
'UIKeyInputF12': LogicalKeyboardKey.f12,
'UIKeyInputUpArrow': LogicalKeyboardKey.arrowUp,
'UIKeyInputDownArrow': LogicalKeyboardKey.arrowDown,
'UIKeyInputLeftArrow': LogicalKeyboardKey.arrowLeft,
'UIKeyInputRightArrow': LogicalKeyboardKey.arrowRight,
'UIKeyInputHome': LogicalKeyboardKey.home,
'UIKeyInputEnd': LogicalKeyboardKey.enter,
'UIKeyInputPageUp': LogicalKeyboardKey.pageUp,
'UIKeyInputPageDown': LogicalKeyboardKey.pageDown,
};
/// Platform-specific key event data for iOS. /// Platform-specific key event data for iOS.
/// ///
/// This object contains information about key events obtained from iOS' /// This object contains information about key events obtained from iOS'
...@@ -107,9 +81,9 @@ class RawKeyEventDataIos extends RawKeyEventData { ...@@ -107,9 +81,9 @@ class RawKeyEventDataIos extends RawKeyEventData {
} }
// Look to see if the [keyLabel] is one we know about and have a mapping for. // Look to see if the [keyLabel] is one we know about and have a mapping for.
final LogicalKeyboardKey? newKey = _kIosToLogicalMap[keyLabel]; final LogicalKeyboardKey? specialKey = kIosSpecialLogicalMap[keyLabel];
if (newKey != null) { if (specialKey != null) {
return newKey; return specialKey;
} }
// Keys that can't be derived with characterIgnoringModifiers will be // Keys that can't be derived with characterIgnoringModifiers will be
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment