Overview
Kiedy to jest potrzebne
Jeśli Primuse ulega awarii, przestaje odpowiadać, pomija utwory podczas skanowania, nie może połączyć się ze źródłem muzyki lub przerywa odtwarzanie, deweloper zwykle potrzebuje zapisu z chwili, w której wystąpił problem. Diagnostyka pozostaje na urządzeniu i nigdy nie jest wysyłana automatycznie — opuszcza urządzenie tylko wtedy, gdy sam ją wyślesz.
Zanim zaczniesz
- Sprawdź wersję aplikacji: w Ustawienia → O widać Wersja i Kompilacja. Podaj je w zgłoszeniu.
- Przesyłanie wymaga internetu. Każde urządzenie może przesyłać do 5 razy dziennie, każdy pakiet ma najwyżej 8 MB.
Krok 1: Włącz tryb diagnostyczny (zalecane)
- Otwórz Ustawienia → O → „Raporty diagnostyczne”.
- Mac: Ustawienia → O → „Dzienniki diagnostyczne…”, a następnie w otwartym oknie kliknij „Raporty diagnostyczne”.
- Apple TV: otwórz „Raporty diagnostyczne” w Ustawienia.
- Włącz „Zapisuj szczegółowe dzienniki”. Przez kolejne 24 godziny aplikacja zapisuje dodatkowe szczegóły do rozwiązywania problemów, a potem sama wyłącza tę opcję.
- Odtwórz problem (np. zeskanuj ponownie, odtwórz utwór jeszcze raz lub połącz się ponownie ze źródłem) i zanotuj przybliżoną godzinę.
To, co wydarzyło się przed włączeniem trybu, jest tylko w podstawowym dzienniku i może brakować szczegółów, dlatego najlepiej odtworzyć problem raz przy włączonym trybie.
Krok 2: Prześlij do dewelopera
- Na ekranie „Raporty diagnostyczne” stuknij „Wyślij do autora” na pasku narzędzi.
- W sekcji „Załączniki (opcjonalnie)” wybierz, co dołączyć: „Raporty diagnostyczne” (raporty awarii i zawieszeń, dane o działaniu) oraz „Dzienniki”.
- Opcjonalnie dodaj zrzuty ekranu w „Obrazy (opcjonalnie)” (do 6, zmniejszane automatycznie) i opisz w polu „Prośby lub sugestie”, co robiłeś, czego oczekiwałeś, co się faktycznie stało i mniej więcej kiedy.
- Stuknij „Prześlij autorowi” na dole. Kolejno pojawią się „Pakowanie…”, „Przesyłanie: …%” i „Potwierdzanie…”.
- Gdy pojawi się „Przesłano autorowi”, stuknij „Kopiuj kod” i podaj kod w zgłoszeniu na GitHubie lub w e-mailu.
Oczekiwany wynik: wyświetla się kod raportu. Po udanym przesłaniu przesłane raporty i dzienniki są usuwane z urządzenia.
Apple TV nie ma systemowych raportów awarii, więc przesyłany jest tylko dziennik i Twoja wiadomość; po wyświetleniu kodu możesz stuknąć „Wyślij kolejny”, aby wysłać kolejny.
Jeśli przesłanie się nie udaje: e-mail lub Udostępnij
- Pod przyciskiem przesyłania jest „Wyślij e-mailem” lub „Udostępnij w inny sposób”. Do wiadomości dołączane są wybrane raporty lub dzienniki, a przed wysłaniem możesz ją przejrzeć.
- Jeśli usługa przesyłania jest niedostępna, przycisk przesyłania się nie pojawia; na pasku narzędzi widać „Otwórz pocztę” lub „Udostępnij” oraz adres e-mail dewelopera.
- Wersje starsze niż 1.12.2 nie mają przesyłania — użyj „Wyślij do autora”, aby wysłać e-mailem lub przez Udostępnij.
Udostępnianie pojedynczego raportu
Stuknij raport na ekranie „Raporty diagnostyczne”, aby udostępnić tylko jego. Na Macu przycisk „Eksportuj logi” pokazuje plik dziennika w Finderze.
Znaczenie opcji
| Opcja | Znaczenie |
|---|---|
| Raporty awarii i zawieszeń | Raporty pozostawiane przez system po awarii lub długim zawieszeniu; zwykle pojawiają się po ponownym otwarciu aplikacji |
| Metryki działania | Okresowe dane systemu o działaniu aplikacji, np. szczytowe użycie pamięci i przyczyny zakończenia |
| Dzienniki | Własny zapis aplikacji dotyczący ostatniego odtwarzania, skanowania i synchronizacji; przesyłana i udostępniana jest tylko najnowsza część |
| Zapisuj szczegółowe dzienniki | Przez 24 godziny zapisuje więcej szczegółów, potem się wyłącza |
| Wyczyść dzienniki | Usuwa dzienniki z tego urządzenia; nie można tego cofnąć |
Prywatność
Dzienniki zawierają tytuły utworów i ścieżki plików; adresy i konta źródeł muzyki są zastępowane krótkimi etykietami. Hasła, tokeny i inne dane uwierzytelniające są usuwane przed zapisem. Przesłane dane służą wyłącznie do rozwiązywania problemów i są usuwane z serwera dewelopera po 30 dniach (wcześniej, jeśli brakuje miejsca). Przed wysłaniem możesz odznaczyć „Dzienniki” lub nie dołączać zrzutów ekranu.
Ograniczenia
- Jedno przesłanie to najwyżej 8 MB po spakowaniu; 5 przesłań dziennie na urządzenie, nieukończone próby też się liczą.
- Raporty i dzienniki są przechowywane na urządzeniu przez około 7 dni.
- Apple TV nie ma raportów awarii i zawieszeń; Apple Watch nie ma ekranu diagnostyki — zgłaszaj z połączonego iPhone’a.