WindowManager

WindowManager डंप, किसी खास समय पर WindowManager का स्नैपशॉट देते हैं. WindowManager के ट्रेस में, राज्यों का क्रमवार सीक्वेंस होता है. इससे यह समझने में मदद मिलती है कि कोई विंडो स्क्रीन पर क्यों दिखती है, उसका कॉन्फ़िगरेशन क्या है या उसकी गतिविधि, टास्क, डिसप्ले या WindowManager के क्रम में मौजूद किसी अन्य एलिमेंट का कॉन्फ़िगरेशन क्या है. इस जानकारी से, मेरा ऐप्लिकेशन क्यों नहीं दिख रहा है या ऐप्लिकेशन बदलते समय मुझे फ़्लिकरिंग की समस्या हुई जैसी समस्याओं को हल करने में मदद मिलती है.

Winscope का WindowManager व्यूअर, ट्रेस और डंप, दोनों के लिए यह जानकारी दिखाता है.

ट्रेस कलेक्शन के बारे में ज़्यादा जानकारी के लिए, WindowManager देखें.

पहली इमेज. WindowManager के ट्रेस का विश्लेषण.

स्क्रीन की बाईं ओर, खिड़कियों का 3D व्यू दिखाया गया है. रेक्ट व्यू में, विंडो की सीमाओं, z-ऑर्डर, और अपारदर्शिता को ध्यान में रखा जाता है.

टैब का सेंट्रल सेगमेंट, विंडो हैरारकी दिखाता है. विंडो, गतिविधियों, और टास्क के बीच माता-पिता और बच्चे के संबंधों के अलावा, इस व्यू में यह जानकारी भी शामिल होती है:

• V: इससे दिखने वाली विंडो की पहचान होती है.

स्क्रीन की दाईं ओर, उपलब्ध सभी प्रॉपर्टी का प्रोटो डंप दिखता है. प्रोटो डंप सेक्शन की सुविधाओं के बारे में ज़्यादा जानने के लिए, प्रॉपर्टी देखें.

@IntDef translation

@IntDef ट्रांसलेशन, WindowManager प्रॉपर्टी पैनल की एक मुख्य प्रॉपर्टी है. @IntDef से पता चलता है कि पूर्णांक टाइप का एनोटेट किया गया एलिमेंट, लॉजिकल टाइप को दिखाता है. साथ ही, इसकी वैल्यू साफ़ तौर पर बताए गए कॉन्स्टेंट में से कोई एक होनी चाहिए. @IntDef का इस्तेमाल Android कोडबेस में किया जाता है. इससे मेमोरी और परफ़ॉर्मेंस पर पड़ने वाले असर को कम किया जा सकता है. इसके लिए, enums का इस्तेमाल नहीं किया जाता.

यहां @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 मैपिंग अपडेट करें में दिया गया तरीका अपनाएं.