WindowManager डंप, किसी खास समय पर WindowManager का स्नैपशॉट देते हैं. WindowManager के ट्रेस में, राज्यों का क्रमवार सीक्वेंस होता है. इससे यह अहम जानकारी मिलती है कि कोई विंडो स्क्रीन पर क्यों दिखती है, उसका कॉन्फ़िगरेशन क्या है या उसकी गतिविधि, टास्क, डिसप्ले या WindowManager के क्रम में मौजूद किसी अन्य एलिमेंट का कॉन्फ़िगरेशन क्या है. इस जानकारी से, इन समस्याओं को हल करने में मदद मिलती है: मेरा ऐप्लिकेशन क्यों नहीं दिख रहा है या ऐप्लिकेशन बदलते समय स्क्रीन फ़्लिकर हो रही है.
Winscope का WindowManager व्यूअर, दोनों ट्रेस और डंप के लिए यह जानकारी दिखाता है.
ट्रेस कलेक्शन के बारे में ज़्यादा जानकारी के लिए, WindowManager देखें.
पहली इमेज. WindowManager के ट्रेस का विश्लेषण.
स्क्रीन की बाईं ओर, खिड़कियों का 3D व्यू दिखाया गया है. रेक्ट व्यू में, विंडो की सीमाओं, z-ऑर्डर, और अपारदर्शिता को ध्यान में रखा जाता है.
टैब का सेंट्रल सेगमेंट, विंडो हैरारकी दिखाता है. विंडो, गतिविधियों, और टास्क के बीच माता-पिता और बच्चे के संबंधों के अलावा, इस व्यू में यह जानकारी भी शामिल होती है:
- V: इससे दिखने वाली विंडो की पहचान होती है.
स्क्रीन की दाईं ओर, उपलब्ध सभी प्रॉपर्टी का प्रोटो डंप दिखता है. प्रोटो डंप सेक्शन की सुविधाओं के बारे में ज़्यादा जानने के लिए, प्रॉपर्टी देखें.
@IntDef translation
@IntDef, WindowManager प्रॉपर्टी पैनल की एक मुख्य प्रॉपर्टी है.
@IntDef से पता चलता है कि पूर्णांक टाइप का एनोटेट किया गया एलिमेंट, लॉजिकल टाइप को दिखाता है. साथ ही, इसकी वैल्यू साफ़ तौर पर बताई गई कॉन्स्टेंट वैल्यू में से एक होनी चाहिए.
@IntDef का इस्तेमाल Android कोड बेस में किया जाता है. इसका इस्तेमाल, मेमोरी और परफ़ॉर्मेंस पर पड़ने वाले असर को कम करने के लिए, इनम के बजाय किया जाता है.
यहां @IntDef के इस्तेमाल का उदाहरण दिया गया है:
/**
* The modes to control how root task is moved to the front when calling {@link Task#reparent}.
*/
@Retention(RetentionPolicy.SOURCE)
@IntDef({
REPARENT_MOVE_ROOT_TASK_TO_FRONT,
REPARENT_KEEP_ROOT_TASK_AT_FRONT,
REPARENT_LEAVE_ROOT_TASK_IN_PLACE
})
@interface ReparentMoveRootTaskMode {}
// Moves the root task to the front if it was not at the front
static final int REPARENT_MOVE_ROOT_TASK_TO_FRONT = 0;
// Only moves the root task to the front if it was focused or frontmost already
static final int REPARENT_KEEP_ROOT_TASK_AT_FRONT = 1;
// Do not move the root task as a part of reparenting
static final int REPARENT_LEAVE_ROOT_TASK_IN_PLACE = 2;
फ़्लैग को पूर्णांकों के तौर पर सेव किया जाता है. इसके लिए, इंसानों के पढ़ने लायक वैल्यू का इस्तेमाल नहीं किया जाता. इन वैल्यू को समझना मुश्किल हो सकता है. Winscope, @IntDef की परिभाषाओं का इस्तेमाल करके इन फ़्लैग को ऐसी वैल्यू में बदलता है जिन्हें आसानी से समझा जा सकता है.
कंपाइलेशन के दौरान, Winscope @IntDef वैल्यू की डिक्शनरी इकट्ठा करता है. साथ ही, इस सूची का इस्तेमाल करके, रनटाइम में @IntDef इंस्टेंस को ऐसे फ़ॉर्मैट में डिकोड करता है जिसे आसानी से पढ़ा जा सके. उदाहरण के लिए, 2 की activityType वाली गतिविधि का अनुवाद ACTIVITY_TYPE_HOME की activityType में किया जाता है. इसी तरह, flags=2173763840 वाली विंडो को Winscope में इस तरह से अनुवादित किया जाता है:
flags=FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS | FLAG_HARDWARE_ACCELERATED |
FLAG_SPLIT_TOUCH | FLAG_SHOW_WALLPAPER | FLAG_LAYOUT_INSET_DECOR |
FLAG_LAYOUT_IN_SCREEN
अगर Winscope, @IntDef इंस्टेंस का सही तरीके से अनुवाद नहीं करता है, तो Winscope को @IntDef इंस्टेंस की सूची अपडेट करने के लिए, @IntDef मैपिंग अपडेट करें में दिया गया तरीका अपनाएं.