alat validatekeymaps

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Framework Android memiliki alat kecil yang disebut validatekeymaps untuk memvalidasi sintaksis file konfigurasi perangkat input, file tata letak tombol, file peta karakter tombol, dan file definisi kunci virtual.

Kompilasi

Untuk mengompilasi validatekeymaps, siapkan lingkungan pengembangan, download hierarki sumber Android, kompilasi, lalu jalankan:

mmm frameworks/base/tools/validatekeymaps

Perintah ini akan mengompilasi alat host yang disebut validatekeymaps ke dalam direktori out/host/<os>/bin.

Penggunaan

Jika Anda menjalankan envsetup.sh untuk menyiapkan lingkungan pengembangan, alat validatekeymaps seharusnya sudah ada di jalur Anda. Anda dapat memverifikasinya dengan menjalankan validatekeymaps.

validatekeymaps

Anda akan melihat output berikut:

Keymap Validation Tool

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

Kemudian, Anda hanya perlu menjalankan validatekeymaps dan memberikan jalur satu atau beberapa file yang akan divalidasi.

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

Contoh:

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

Success.

Dan jika terjadi error...

validatekeymaps Bad.kl

Contoh:

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

Failed!

Otomatisasi

Sebaiknya jalankan validatekeymaps di semua file konfigurasi sebelum menginstalnya di perangkat.

Proses ini dapat dengan mudah diotomatiskan sebagai bagian dari sistem build menggunakan skrip atau makefile.

Contoh makefile berikut didasarkan pada konten 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)