Android4.0 添加一個新的Android 索引值

標籤：linux   new   core   public   添加   web   ons   ros   plugins   

這裡添加新的索引值，不是毫無憑據憑空創造的一個索引值，而是根據kernel中檢測到的按索引值，然後轉化為Android所需要的數值：

以添加一個linux索引值為217，把它映射為android的索引值Browser(這個索引值之前不存在)為例介紹一下：

1、android之前沒有這個索引值，需要定義

/frameworks/base/core/java/android/view/KeyEvent.java

//定義這個新的索引值

public static final int KEYCODE_BROWSER = 210;

 

然後我們會看到有如下注釋：

// NOTE: If you add a new keycode here you must also add it to:

// isSystem()

// native/include/android/keycodes.h

// frameworks/base/include/ui/KeycodeLabels.h

// external/webkit/WebKit/android/plugins/ANPKeyCodes.h

// frameworks/base/core/res/res/values/attrs.xml

// emulator?

// LAST_KEYCODE

// KEYCODE_SYMBOLIC_NAMES

//

// Also Android currently does not reserve code ranges for vendor-

// specific key codes. If you have new key codes to have, you

// MUST contribute a patch to the open source project to define

// those new codes. This is intended to maintain a consistent

// set of key code definitions across all Android devices.

 

上面的注釋已經為我們指明了添加索引值所需要的步驟：

2、/frameworks/base/core/java/android/view/KeyEvent.java

public final boolean isSystem() {

return native_isSystemKey(mKeyCode);

}

 

/frameworks/base/jni/android_view_KeyEvent.java

static jboolean native_isSystemKey(JNIEnv* env, jobject clazz, jint keyCode) {

return KeyEvent::isSystemKey(keyCode);

}

 

/frameworks/base/libs/ui/Input.cpp

bool KeyEvent::isSystemKey(int32_t keyCode) {

switch (keyCode) {

……

case AKEYCODE_BROWSER:

return true;

}

}

 

3、native/include/android/keycodes.h

/*

* Key codes.

*/

enum {

……

AKEYCODE_CALCULATOR = 210,

AKEYCODE_BROWSER = 211,

 

}

 

4、frameworks/base/include/ui/KeycodeLabels.h

這裡定義的實際上是我們在kl檔案，也就是linux key到android key的一個映射表中的linux索引值和android索引值的名稱；

比如atc260x-irkeypad.kl：

……

key 217 BROWSER //這裡的BROWSER就是我們定義的android索引值的字元形式，217則是linux索引值

 

 

那麼，BROWSER不能無緣無故就使用，必然有定義位置，這個位置就是KeycodeLabels.h

static const KeycodeLabel KEYCODES[] = {

……

{ "CALCULATOR", 210 },

{"BROWSER", 211}, //這裡的BROWSER就是我們上面使用的東西，而211是android索引值

{ NULL, 0}

}

 

在EventHub.cpp中載入並解析這個map：atc260x-irkeypad.kl，那麼得到的是linux索引值217為key的string，這個string就是BROWSER，有了上面這個KEYCODES數組，就可以獲得它對應的android索引值了。

 

5、external/webkit/WebKit/android/plugins/ANPKeyCodes.h

enum ANPKeyCodes {

……

 

kAppSwitch_ANPKeyCode = 186,

 

kBrowser_ANPKEYCODE = 211,

};

 

6、frameworks/base/core/res/res/values/attrs.xml

<attr name="keycode">

 

<enum name="KEYCODE_CALCULATOR" value="210" />

<enum name="KEYCODE_BROWSER" value="211" />

</attr>

 

7、/frameworks/base/core/java/android/view/KeyEvent.java

LAST_KEYCODE也就是最後一個keycode，因為添加了新的，所以需要更改這個的數值

LAST_KEYCODE = KEYCODE_BROWSER

 

private static final

SparseArray<String> KEYCODE_SYMBOLIC_NAMES = new SparseArray<String>();

 

 

private static void populateKeycodeSymbolicNames() {

……

 

names.append(KEYCODE_MUSIC, "KEYCODE_MUSIC");

names.append(KEYCODE_CALCULATOR, "KEYCODE_CALCULATOR");

names.append(KEYCODE_BROWSER, "KEYCODE_BROWSER");

}

這些操作完成了之後，就完成了linux鍵到android的索引值映射。也就是android中多了一個KEYCODE_BROWSER它的值是211.

 

Android4.0 添加一個新的Android 索引值