驗證鍵盤地圖工具

Android 架構提供名為 validatekeymaps 的小型工具，可驗證輸入裝置設定檔、按鍵版面配置檔、按鍵字元對應檔案和虛擬按鍵定義檔案的語法。

編譯

如要編譯 validatekeymaps，請設定開發環境、下載 Android 來源樹狀結構、編譯並執行：

mmm frameworks/base/tools/validatekeymaps

這個指令應將名為 validatekeymaps 的主機工具編譯至 out/host/<os>/bin 目錄。

用量

如果您已執行 envsetup.sh 來設定開發環境，validatekeymaps 工具應已在路徑中。您可以執行 validatekeymaps 來驗證這項資訊。

validatekeymaps

您應該會看到下列輸出結果：

Keymap Validation Tool

Usage:
 validatekeymaps [*.kl] [*.kcm] [*.idc] [virtualkeys.*] [...]
   Validates the specified key layouts, key character maps, 
   input device configurations, or virtual key definitions.

接著，您只需執行 validatekeymaps，並提供一或多個要驗證的檔案路徑即可。

validatekeymaps frameworks/base/data/keyboards/Generic.kl

例子：

Validating file 'frameworks/base/data/keyboards/Generic.kl'...
No errors.

Success.

如果發生錯誤...

validatekeymaps Bad.kl

例子：

Validating file 'Bad.kl'...
E/KeyLayoutMap(87688): Bad.kl:24: Expected keyword, got 'ke'.
Error -22 parsing key layout file.

Failed!

自動化

非常建議您在將所有設定檔安裝到裝置前，先對這些檔案執行 validatekeymaps。

您可以使用指令碼或 Make 檔案，輕鬆將這個程序自動化，做為建構系統的一部分。

以下範例的 makefile 是根據 frameworks/base/data/keyboards/Android.mk 的內容建立。

# This makefile performs build time validation of framework keymap files.

LOCAL_PATH := $(call my-dir)

# Validate all key maps.
include $(CLEAR_VARS)

validatekeymaps := $(HOST_OUT_EXECUTABLES)/validatekeymaps$(HOST_EXECUTABLE_SUFFIX)
files := MyKeyboard.kl MyKeyboard.kcm MyTouchScreen.idc

LOCAL_MODULE := validate_framework_keymaps
LOCAL_MODULE_TAGS := optional
LOCAL_REQUIRED_MODULES := validatekeymaps

validate_framework_keymaps: $(files)
    $(hide) $(validatekeymaps) $(files)

include $(BUILD_PHONY_PACKAGE)