Overview
यह कब ज़रूरी है
अगर Primuse क्रैश हो, जवाब देना बंद कर दे, स्कैन में गाने छोड़ दे, किसी म्यूज़िक स्रोत से कनेक्ट न हो पाए या प्लेबैक बीच में रुक जाए, तो डेवलपर को आमतौर पर उसी पल का रिकॉर्ड चाहिए जब समस्या हुई। डायग्नोस्टिक्स आपके डिवाइस पर ही रहते हैं और कभी अपने-आप नहीं भेजे जाते; वे डिवाइस से तभी बाहर जाते हैं जब आप खुद भेजते हैं।
शुरू करने से पहले
- ऐप का संस्करण देखें: सेटिंग्स → के बारे में में संस्करण और निर्माण दिखते हैं। अपनी रिपोर्ट में इन्हें लिखें।
- अपलोड के लिए इंटरनेट चाहिए। हर डिवाइस दिन में अधिकतम 5 बार अपलोड कर सकता है, और हर पैकेज 8 MB से बड़ा नहीं हो सकता।
चरण 1: डायग्नोस्टिक मोड चालू करें (सुझाया गया)
- सेटिंग्स → के बारे में → “डायग्नोस्टिक रिपोर्ट” खोलें।
- Mac: सेटिंग्स → के बारे में → “डायग्नोस्टिक लॉग्स…”, फिर खुलने वाली विंडो में “डायग्नोस्टिक रिपोर्ट” पर क्लिक करें।
- Apple TV: सेटिंग्स में “डायग्नोस्टिक रिपोर्ट” खोलें।
- “विस्तृत लॉग रिकॉर्ड करें” चालू करें। अगले 24 घंटे ऐप समस्या खोजने के लिए अतिरिक्त विवरण दर्ज करता है, फिर यह अपने-आप बंद हो जाता है।
- समस्या दोहराएँ (जैसे दोबारा स्कैन करें, गाना फिर से चलाएँ या स्रोत से फिर कनेक्ट करें) और लगभग समय नोट करें।
मोड चालू करने से पहले जो हुआ वह सिर्फ़ बुनियादी लॉग में होता है और उसमें पर्याप्त विवरण न हो, इसलिए मोड चालू रखकर समस्या एक बार दोहराना सबसे अच्छा है।
चरण 2: डेवलपर को अपलोड करें
- “डायग्नोस्टिक रिपोर्ट” स्क्रीन पर टूलबार में “लेखक को भेजें” पर टैप करें।
- “अटैचमेंट (वैकल्पिक)” में चुनें कि क्या जोड़ना है: “डायग्नोस्टिक रिपोर्ट” (क्रैश और अटकने की रिपोर्ट, प्रदर्शन डेटा) और “लॉग”।
- चाहें तो “छवियाँ (वैकल्पिक)” में स्क्रीनशॉट जोड़ें (अधिकतम 6, अपने-आप छोटे किए जाते हैं) और “अनुरोध या सुझाव” में लिखें कि आप क्या कर रहे थे, क्या उम्मीद थी, असल में क्या हुआ और लगभग कब।
- नीचे “लेखक को अपलोड करें” पर टैप करें। क्रम से “पैक किया जा रहा है…”, “अपलोड हो रहा है …%” और “पुष्टि की जा रही है…” दिखेंगे।
- जब “लेखक को अपलोड हो गया” दिखे, “कोड कॉपी करें” पर टैप करें और कोड को GitHub की रिपोर्ट या ईमेल में लिखें।
अपेक्षित परिणाम: एक रिपोर्ट कोड दिखता है। सफल अपलोड के बाद अपलोड की गई रिपोर्ट और लॉग डिवाइस से हटा दिए जाते हैं।
Apple TV पर सिस्टम क्रैश रिपोर्ट नहीं होतीं, इसलिए सिर्फ़ लॉग और आपका संदेश अपलोड होता है; कोड दिखने के बाद “एक और भेजें” से और भेज सकते हैं।
अपलोड न हो पाए तो: ईमेल या शेयर
- अपलोड बटन के नीचे “इसके बजाय ईमेल से भेजें” या “इसके बजाय शेयर करें” है। चुनी गई रिपोर्ट या लॉग संदेश में जुड़ जाते हैं, और भेजने से पहले आप उसे देख सकते हैं।
- अगर अपलोड सेवा उपलब्ध नहीं है, तो अपलोड बटन नहीं दिखता; टूलबार में “मेल खोलें” या “शेयर करें” और डेवलपर का ईमेल पता दिखता है।
- 1.12.2 से पुराने संस्करणों में अपलोड नहीं है; ईमेल या शेयर के लिए “लेखक को भेजें” का उपयोग करें।
एक रिपोर्ट शेयर करना
“डायग्नोस्टिक रिपोर्ट” स्क्रीन पर किसी रिपोर्ट पर टैप करके सिर्फ़ उसे शेयर करें। Mac पर “निर्यात लॉग” लॉग फ़ाइल को Finder में दिखाता है।
विकल्पों का अर्थ
| विकल्प | अर्थ |
|---|---|
| क्रैश और हैंग रिपोर्ट | ऐप के क्रैश होने या देर तक अटकने के बाद सिस्टम द्वारा छोड़ी गई रिपोर्ट; आमतौर पर ऐप दोबारा खोलने के बाद दिखती हैं |
| रनटाइम मेट्रिक्स | सिस्टम द्वारा समय-समय पर दिया जाने वाला प्रदर्शन डेटा, जैसे अधिकतम मेमोरी उपयोग और बंद होने के कारण |
| लॉग | हाल के प्लेबैक, स्कैन और सिंक का ऐप का अपना रिकॉर्ड; अपलोड और शेयर में केवल नवीनतम हिस्सा शामिल होता है |
| विस्तृत लॉग रिकॉर्ड करें | 24 घंटे तक ज़्यादा विवरण दर्ज करता है, फिर बंद हो जाता है |
| लॉग मिटाएँ | इस डिवाइस के लॉग हटा देता है; इसे वापस नहीं लिया जा सकता |
गोपनीयता
लॉग में गानों के नाम और फ़ाइल पथ होते हैं; म्यूज़िक स्रोतों के पते और खाते छोटे लेबल से बदल दिए जाते हैं। पासवर्ड, टोकन और अन्य क्रेडेंशियल लिखने से पहले हटा दिए जाते हैं। अपलोड की गई सामग्री सिर्फ़ समस्या सुलझाने के लिए उपयोग होती है और डेवलपर के सर्वर से 30 दिन बाद (जगह कम हो तो पहले) हटा दी जाती है। भेजने से पहले आप “लॉग” का चयन हटा सकते हैं या स्क्रीनशॉट न जोड़ें।
सीमाएँ
- एक अपलोड पैकेजिंग के बाद अधिकतम 8 MB; हर डिवाइस पर दिन में 5 अपलोड, अधूरे प्रयास भी गिने जाते हैं।
- रिपोर्ट और लॉग डिवाइस पर लगभग 7 दिन रहते हैं।
- Apple TV पर क्रैश और अटकने की रिपोर्ट नहीं हैं; Apple Watch पर डायग्नोस्टिक्स स्क्रीन नहीं है, इसलिए पेयर किए गए iPhone से रिपोर्ट करें।