Platforma Androida zawiera małe narzędzie o nazwie validatekeymaps, które służy do weryfikacji
składnia plików konfiguracji urządzeń wejściowych, pliki układu klucza, znak towarowy
mapuje i plików definicji kluczy wirtualnych.
Kompilacja
Aby skompilować validatekeymaps, skonfiguruj środowisko programistyczne, pobierz
z drzewa źródłowego Androida, skompiluj je i uruchom:
mmm frameworks/base/tools/validatekeymaps
Polecenie to powinno skompilować narzędzie hosta o nazwie validatekeymaps do
Katalog out/host/<os>/bin.
Wykorzystanie
Jeśli do skonfigurowania środowiska programistycznego został uruchomiony plik envsetup.sh, wówczas
Narzędzie validatekeymaps powinno już być na ścieżce. Możesz zweryfikować
to, uruchamiając validatekeymaps.
validatekeymaps
Powinny się wyświetlić te dane wyjściowe:
Keymap Validation Tool Usage: validatekeymaps [*.kl] [*.kcm] [*.idc] [virtualkeys.*] [...] Validates the specified key layouts, key character maps, input device configurations, or virtual key definitions.
Teraz wystarczy uruchomić polecenie validatekeymaps i podać mu ścieżkę
co najmniej jednego pliku do sprawdzenia.
validatekeymaps frameworks/base/data/keyboards/Generic.kl
Przykład:
Validating file 'frameworks/base/data/keyboards/Generic.kl'... No errors. Success.
A jeśli wystąpi błąd...
validatekeymaps Bad.kl
Przykład:
Validating file 'Bad.kl'... E/KeyLayoutMap(87688): Bad.kl:24: Expected keyword, got 'ke'. Error -22 parsing key layout file. Failed!
Automatyzacja
Bardzo dobrym pomysłem jest uruchamianie polecenia validatekeymaps we wszystkich plikach konfiguracji
przed zainstalowaniem ich na urządzeniu.
Ten proces można łatwo zautomatyzować w ramach systemu kompilacji za pomocą skrypt lub plik Makefile.
Ten przykładowy plik Makefile jest oparty na zawartości
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)