Журнали збоїв

Огляд

Журнали збоїв є цінними діагностичними інструментами, які допомагають розробникам виявляти та виправляти проблеми та помилки, що спричиняють збій програми або її несподівану поведінку. Можна ділитися журналами зі свого пристрою Android з командою розробників OsmAnd. Наразі користувачі iOS мають лише один варіант журналу збоїв для надсилання.

Журнали збоїв та Logcat

OsmAnd дозволяє надсилати розробникам два типи даних:

• Журнали збоїв. Генеруються, коли програма OsmAnd стикається з критичною помилкою або винятком, що спричиняє її збій. Ці журнали надають детальну інформацію про стан програми під час збою, включаючи дані збірки, трасування стека, повідомлення про помилки та інші відповідні деталі.
• Журнали Logcat. Запис потоку журналів OsmAnd, що фіксує різні події та повідомлення. Ці журнали допомагають розробникам відстежувати поведінку програми, відстежувати потік виконання, трасувати конкретні дії та досліджувати проблеми, не пов'язані зі збоями. Журнали Logcat зазвичай містять записи активності з моменту останнього запуску програми.

Ваша приватна інформація

Будьте обережні під час надсилання журналів logcat, оскільки вони можуть містити приватну інформацію, таку як місцезнаходження пристрою, пошукові запити, результати побудови маршруту та навігаційні дані.

Надсилання журналів з програми OsmAnd (Android)

1. Перейдіть до Menu → Help → Send crash log (Send logcat log). Залежно від вашої ситуації, виберіть відповідний тип журналу. Ви можете звернутися до розділу Журнали збоїв та Logcat для отримання детальної інформації про відмінності між типами журналів.
2. У спливаючому меню виберіть Gmail або бажану програму електронної пошти. Електронний лист буде згенеровано автоматично.
3. Натисніть кнопку Надіслати.

Надсилання журналів з пристроїв iOS

1. Журнали з пристроїв iOS можна надсилати:

   • Автоматично.

     • Перейдіть до програми OsmAnd Menu → Help → Report an issue (Send log).
     • Потім, використовуючи свою програму електронної пошти, ми рекомендуємо надсилати журнали на адресу crash@osmand.net.

   • Вручну.

     • Перейдіть до системної програми iOS Файли → На моєму iPhone (або На моєму iPad) → OsmAnd Maps → Журнали.

   

2. Надішліть IPS-формат журналів та дані авторизації:

   • Перейдіть до Налаштування iOS → Аналітика → Дані аналітики → Файл OsmAnd Maps у форматі ips (до iOS 17).
   • Налаштування iOS → Конфіденційність та безпека → Аналітика та вдосконалення → Дані аналітики → Файл OsmAnd Maps у форматі ips (починаючи з iOS 18).
   • Потім, використовуючи свою програму електронної пошти, ми рекомендуємо надсилати журнали на адресу crash@osmand.net.

   

Надсилання файлів Tombstone (Android)

Важливо

Тільки для досвідчених користувачів!

У певних складних або незвичайних випадках можуть знадобитися файли Tombstone. Ці файли надають детальні трасування стека для всіх потоків у процесі, що зазнав збою (не тільки того, що спричинив помилку), повну карту пам'яті та список усіх відкритих дескрипторів файлів. Файли Tombstone є життєво важливими для налагодження та діагностики проблем, пов'язаних з нативним кодом на платформі Android.

Використання вашого пристрою

Щоб експортувати файли tombstone, вам потрібно згенерувати звіт про помилку за допомогою системних налаштувань Android:

1. Увімкніть Параметри розробника (цей екран за замовчуванням прихований).

   • Перейдіть до Налаштування → Про телефон → Інформація про програмне забезпечення (цей шлях дійсний для пристроїв Samsung).
   • Натисніть Номер збірки сім разів, доки не з'явиться спливаюче вікно, що підтверджує активацію режиму розробника.

2. Перейдіть до Параметри розробника, зазвичай розташованих унизу списку налаштувань. Ви також можете скористатися функцією пошуку.

   • Натисніть опцію Зробити звіт про помилку.
   • Виберіть тип звіту про помилку та натисніть Звіт.

Після того, як звіт про помилку буде готовий, ви отримаєте сповіщення. Натисніть на поле сповіщення, щоб завантажити звіт на свій пристрій. Розпакуйте файл і надішліть файли tombstone команді розробників OsmAnd (електронна пошта: crash@osmand.net).

note

Зверніть увагу, що звіти про помилки можуть містити приватні дані, включаючи використання програми або місцезнаходження.

Використання ADB

Android Debugging Bridge (ADB) — це інструмент командного рядка, який дозволяє розробникам налагоджувати свої програми. Щоб використовувати ADB для експорту файлів tombstone, вам потрібно спочатку завантажити та встановити його. Дотримуйтесь інструкцій, наданих на офіційному сайті розробників Android.

Підготуйте свій пристрій

Переконайтеся, що Параметри розробника увімкнено (цей екран за замовчуванням прихований) і Налагодження USB увімкнено:

• Перейдіть до Налаштування → Про телефон → Інформація про програмне забезпечення.
• Натисніть Номер збірки сім разів, доки не з'явиться спливаюче вікно, що підтверджує активацію режиму розробника.
• У Параметрах розробника увімкніть Налагодження USB.

Потім підключіть свій пристрій до робочої станції через USB. Якщо це перше підключення, з'явиться спливаюче вікно з запитом дозволу на налагодження.

Згенеруйте звіт про помилку

1. Відкрийте термінал командного рядка. На Mac або Linux використовуйте програму Термінал, а на Windows — Командний рядок.
2. Перейдіть до папки platform-tools, де розташовано ADB, за допомогою команди cd (наприклад, ‘cd /Users/Username/Downloads/Tools’).
3. Згенеруйте звіт про помилку:
   • На Mac: adb bugreport
   • На Windows: adb.exe bugreport
4. Зачекайте кілька хвилин, поки звіт буде згенеровано. Отриманий файл буде збережено в папці platform tools.
5. Розпакуйте файл.
6. Знайдіть папку tombstones з файлами, такими як tombstone_00, tombstone_01 тощо.
7. Надішліть файли tombstone на адресу crash@osmand.net.

Використання рутованих пристроїв або емулятора Android Studio

• З root-доступом до вашого пристрою ви можете безпосередньо відкрити папку /data/tombstones.

• В Android Studio використовуйте емулятор, щоб перейти до Device File Explorer і знайти папку /data/tombstones. Всередині ви знайдете файли з назвами, такими як tombstone_00, tombstone_01 та інші. Завантажте ці файли та надішліть їх на адресу crash@osmand.net.

Для отримання додаткової інформації про звіти про помилки зверніться до документації Android.