android增加按键

开发过程中免不得需要增加或减少按键码值，在android2.3系统事件处理部分，主要向上层提供统一的按键码（KeyCode），这个按键码是一个整数，在上层的JAVA程序中主要通过这个值来判断系统的实现。
      

  1、键扫描码ScanCode是由linux的Input驱动框架定义的整数类型，可参考input.h头文件 

         在步骤一中将其值转换成表示按键的字符串

        键盘布局文件(*.kl)将完成第一步的转换，放在/system/usr/keylayout/下面

        举例如下：

        input.h 中字母键定义：

        #define KEY_Q 16

#define KEY_W 17

#define KEY_E 18

#define KEY_R 19

#define KEY_T 20

#define KEY_Y 21

#define KEY_U 22

#define KEY_I 23

#define KEY_O 24

#define KEY_P 25        

       而qwert.kl中定义如下：

       ScanCode + 字符串值       

      key 16    Q

key 17    W

key 18    E

key 19    R

key 20    T

key 21    Y

key 22    U

key 23    I

key 24    O

key 25    P     

   2、通过查找KEYCODES数组，将literal字符串转换成value的整型值，即转换到KeyCode值了

       片段如下,右边的值是android系统中使用的KeyCode值：（文件路径：frameworks/base/include/ui/KeycodeLabels.h）

static const KeycodeLabel KEYCODES[] = {

    ...

    { "A", 29 },

    { "B", 30 },

    { "C", 31 },

    { "D", 32 },

    { "E", 33 },

    { "F", 34 },

    { "G", 35 },

    { "H", 36 },

    { "I", 37 },

    { "J", 38 },

    { "K", 39 },

    { "L", 40 },

    { "M", 41 },

    { "N", 42 },

    { "O", 43 },

    { "P", 44 },

    { "Q", 45 },

    { "R", 46 },

    { "S", 47 },

    { "T", 48 },

    { "U", 49 },

    { "V", 50 },

    { "W", 51 },

    { "X", 52 },

    { "Y", 53 },

    { "Z", 54 },

    ...

};

   右边的值在android中定义如下：（文件路径：frameworks/base/include/android/keycodes.h）

  /*

 * Key codes.

 */

enum {

     AKEYCODE_A               = 29,

    AKEYCODE_B               = 30,

    AKEYCODE_C               = 31,

    AKEYCODE_D               = 32,

    AKEYCODE_E               = 33,

    AKEYCODE_F               = 34,

    AKEYCODE_G               = 35,

    AKEYCODE_H               = 36,

    AKEYCODE_I               = 37,

    AKEYCODE_J               = 38,

    AKEYCODE_K               = 39,

    AKEYCODE_L               = 40,

    AKEYCODE_M               = 41,

    AKEYCODE_N               = 42,

    AKEYCODE_O               = 43,

    AKEYCODE_P               = 44,

    AKEYCODE_Q               = 45,

    AKEYCODE_R               = 46,

    AKEYCODE_S               = 47,

    AKEYCODE_T               = 48,

    AKEYCODE_U               = 49,

    AKEYCODE_V               = 50,

    AKEYCODE_W               = 51,

    AKEYCODE_X               = 52,

    AKEYCODE_Y               = 53,

    AKEYCODE_Z               = 54,

   ..

};

   这里的键值与KeyEvent.java中的值是对应的：（文件路径：frameworks/base/core/java/android/view/KeyEvent.java）

      /** Key code constant: 'A' key. */

    public static final int KEYCODE_A               = 29;

    /** Key code constant: 'B' key. */

    public static final int KEYCODE_B               = 30;

    /** Key code constant: 'C' key. */

    public static final int KEYCODE_C               = 31;

    /** Key code constant: 'D' key. */

    public static final int KEYCODE_D               = 32;

    /** Key code constant: 'E' key. */

    public static final int KEYCODE_E               = 33;

    /** Key code constant: 'F' key. */

    public static final int KEYCODE_F               = 34;

    /** Key code constant: 'G' key. */

    public static final int KEYCODE_G               = 35;

    /** Key code constant: 'H' key. */

    public static final int KEYCODE_H               = 36;

    /** Key code constant: 'I' key. */

    public static final int KEYCODE_I               = 37;

    /** Key code constant: 'J' key. */

    public static final int KEYCODE_J               = 38;

    /** Key code constant: 'K' key. */

    public static final int KEYCODE_K               = 39;

    /** Key code constant: 'L' key. */

    public static final int KEYCODE_L               = 40;

    /** Key code constant: 'M' key. */

    public static final int KEYCODE_M               = 41;

    /** Key code constant: 'N' key. */

    public static final int KEYCODE_N               = 42;

    /** Key code constant: 'O' key. */

    public static final int KEYCODE_O               = 43;

    /** Key code constant: 'P' key. */

    public static final int KEYCODE_P               = 44;

    /** Key code constant: 'Q' key. */

    public static final int KEYCODE_Q               = 45;

    /** Key code constant: 'R' key. */

    public static final int KEYCODE_R               = 46;

    /** Key code constant: 'S' key. */

    public static final int KEYCODE_S               = 47;

    /** Key code constant: 'T' key. */

    public static final int KEYCODE_T               = 48;

    /** Key code constant: 'U' key. */

    public static final int KEYCODE_U               = 49;

    /** Key code constant: 'V' key. */

    public static final int KEYCODE_V               = 50;

    /** Key code constant: 'W' key. */

    public static final int KEYCODE_W               = 51;

    /** Key code constant: 'X' key. */

    public static final int KEYCODE_X               = 52;

    /** Key code constant: 'Y' key. */

    public static final int KEYCODE_Y               = 53;

    /** Key code constant: 'Z' key. */

    public static final int KEYCODE_Z               = 54;

    ...

      如果改动了这里，影响到API则需要调用make update-api

ok,理清楚了以上的转换关系，下面就说一下如何增加按键,以增加gamekey为例：

1 、键盘布局文件中增加键，一般是qwery.kl （一定是以*.kl结尾的文件）：

  key 304 BUTTON_A 

  key 305 BUTTON_B

  key 306 BUTTON_C

  key 307 BUTTON_X

  key 308
BUTTON_Y

  key 309
BUTTON_Z

  key
315 BUTTON_START

  key
316 BUTTON_MODE

2、在frameworks/base/include/ui/KeycodeLabels.h中增加KeycodeLabel类型的Code数组

  
 { "BUTTON_A", 96 },

    { "BUTTON_B", 97 },

    { "BUTTON_C", 98 },

    { "BUTTON_X", 99 },

    { "BUTTON_Y", 100 },

    { "BUTTON_Z", 101 },

    { "BUTTON_START", 108 },

  
 { "BUTTON_MODE", 110 },      

  
 目前的2.3系统已经添加

  3、在frameworks/base/include/android/keycodes.h中增加KeyCode的枚举值

  
 AKEYCODE_BUTTON_A        = 96,

    AKEYCODE_BUTTON_B        = 97,

    AKEYCODE_BUTTON_C        = 98,

    AKEYCODE_BUTTON_X        = 99,

    AKEYCODE_BUTTON_Y        = 100,

    AKEYCODE_BUTTON_Z        = 101,

  
 AKEYCODE_BUTTON_START    = 108,

    AKEYCODE_BUTTON_MODE     = 110,   

  
  目前的2.3系统已经添加

4、JAVA层的keyEvent.java中增加用于java应用程序使用

  
  略，目前的2.3系统已经添加

5、在frameworks\base\core\res\res\values\attrs.xml中增加表示属性的资源文件，添加相应用name="keycode"的attr

        

        

        

        

        

        

        

  
     

ok,完成以上步骤应该就可以使用了。

查找key是否有没有被过滤掉重点确认的地方：
1、EventHub.cpp 文件中的getEvent函数
    if (iev.type == EV_KEY) {

               status_t err = device->layoutMap->map(iev.code,

                         & outEvent->keyCode, & outEvent->flags);

               LOGV("iev.code=%d keyCode=%d flags=0x%08x err=%d\n",

                          iev.code, outEvent->keyCode, outEvent->flags, err);

               if (err != 0) {

                      outEvent->keyCode = AKEYCODE_UNKNOWN;

                       outEvent->flags = 0;

               }
       }
    确认这里转换是否ok了，如果没有则可能*.kl文件中没有添加进去这个键值 

2、InputReader.cpp文件中的KeyboardInputMapper处理函数process
    void KeyboardInputMapper::process(const RawEvent* rawEvent) {

    switch (rawEvent->type) {

    case EV_KEY: {

        int32_t scanCode = rawEvent->scanCode;

        if (isKeyboardOrGamepadKey(scanCode)) {

            processKey(rawEvent->when, rawEvent->value != 0, rawEvent->keyCode, scanCode,

                    rawEvent->flags);

        }

        break;

    }

    }

}

bool KeyboardInputMapper::isKeyboardOrGamepadKey(int32_t scanCode) {

    return scanCode < BTN_MOUSE

        || scanCode >= KEY_OK

        || (scanCode >= BTN_GAMEPAD && scanCode < BTN_DIGI);

}

可以在processKey中加打印，确认已通过notifyKey上报键值给android系统了。
 
附加，如何编译生成qwerty.kcm.bin 文件：
android为了减少载入时间，并没有使用原始按键表文件，而是将其转换成二进制文件

转换的工具源代码在android源代码build/tools/kcm目录下，android在编译过程中会

首先编译转换工具，然后利用转换工具将qwerty.kcm文件转换成qwerty.kcm.bin
转换后的二进制文件复制到out/target/product/ /system/usr/keychars

目录下，也就是目标平台的/system/usr/keychars目录中。
用法：
static int usage()

{

    fprintf(stderr,

            "usage: kcm INPUT OUTPUT\n"

            "\n"

            "INPUT   keycharmap file\n"

            "OUTPUT  compiled keycharmap file\n"

        );

    return 1;

}