กรอบงาน 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 บนไฟล์การกำหนดค่าทั้งหมดก่อนทำการติดตั้งบนอุปกรณ์
กระบวนการสามารถทำให้เป็นอัตโนมัติได้อย่างง่ายดายโดยเป็นส่วนหนึ่งของระบบบิลด์โดยใช้สคริปต์หรือ makefile
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)