वैलिडेटकीमैप्स टूल

एंड्रॉइड फ्रेमवर्क में इनपुट डिवाइस कॉन्फ़िगरेशन फ़ाइलों, कुंजी लेआउट फ़ाइलों, मुख्य चरित्र मानचित्र फ़ाइलों और वर्चुअल कुंजी परिभाषा फ़ाइलों के सिंटैक्स को मान्य करने के लिए validatekeymaps नामक एक छोटा टूल है।

संकलन

validatekeymaps संकलित करने के लिए, विकास परिवेश सेट करें, Android स्रोत ट्री डाउनलोड करें, इसे संकलित करें, फिर चलाएँ:

mmm frameworks/base/tools/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 चलाना एक बहुत अच्छा विचार है।

स्क्रिप्ट या मेकफ़ाइल का उपयोग करके प्रक्रिया को बिल्ड सिस्टम के हिस्से के रूप में आसानी से स्वचालित किया जा सकता है।

निम्नलिखित नमूना मेकफ़ाइल 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)