Усі колекції
Навчальний матеріал
Журнали збоїв на мобільних пристроях
Журнали збоїв на мобільних пристроях

Як створити журнали збоїв(Crash Logs) на мобільних пристроях і отримати їх?

Kostya avatar
Автор: Kostya
Оновлено протягом останнього тижня

"Де знайти журнали збоїв на мобільних пристроях і як їх отримати? Який найпростіший спосіб?"

Мотивація

У разі збоїв у мобільній програмі журнали пристрою є обов’язковими як ключовий компонент вашого звіту про помилку. Вони також можуть бути корисними для зависання програм. Лише зареєстрована інформація може надати детальне розуміння обставин проблеми.

У цій статті ви дізнаєтесь, як отримати інформацію журналу для пристроїв Android та iOS. Застосування цих методів дозволить вам записувати та додавати значущі файли журналу до своїх звітів.

Отримання журналів збоїв на пристроях Android

Для пристроїв Android є два основні підходи: один – використовувати Android Debug Bridge (ADB), а другий – використовувати інтегровану функцію звіту про помилки всередині інструментів розробника у вашому телефоні. Спочатку ми пояснимо, як використовувати ADB.

Журнали збоїв за допомогою ADB

Для Windows, щоб отримати журнали збоїв через ADB, вам потрібно буде завантажити SDK Platform Tools. Ви можете завантажити SDK Platform Tools тут.

Для macOS вам потрібно буде інсталювати android-platform-tools за допомогою Homebrew. Інструкції по установці ви знайдете далі в цій статті.

Запуск ADB на Windows і macOS

Windows

Після того, як ви завантажите SDK Platform Tools, вам потрібно буде витягнути файли (папку) звідти. Коли ви видобуваєте файли (папку), вам потрібно відкрити видобуту папку. Після того, як ви відкриєте витягнуту папку, в адресному рядку Провідника файлів клацніть вільне місце, потім, коли буде показано шлях до файлу, введіть cmd і натисніть клавішу ENTER на клавіатурі. Це запустить cmd (командний рядок) у папці, і таким чином ADB буде запущено.

macOS

Перше, що вам потрібно зробити, це встановити Homebrew за допомогою терміналу, а потім інсталювати android-platform-tools. Щоб установити Homebrew на ваш macOS, відвідайте веб-сайт Homebrew і скопіюйте посилання на встановлення в розділі Встановити Homebrew. Після того, як ви скопіювали посилання для встановлення, вставте його в термінал і натисніть Enter на клавіатурі. Homebrew почнеться з встановлення. Дотримуйтесь інструкцій по установці до кінця.

Примітка: У деяких випадках інсталяція може тривати довше через інсталяцію додаткових компонентів, але не хвилюйтеся, все добре.

Після завершення встановлення Homebrew вам потрібно буде інсталювати android-platform-tools. Щоб установити android-platform-tools, відвідайте веб-сайт android-platform-tools Homebrew Formulas і скопіюйте команду Installation. Після того як ви скопіювали команду встановлення, вставте її в термінал і натисніть Enter на клавіатурі. Після цього почнеться встановлення. Після завершення встановлення введіть Terminal adb і натисніть Enter. Якщо ви бачите команди adb, це означає, що інсталяція виконана успішно.

Примітка: Після встановлення android-platform-tools для кожного наступного використання вам потрібно буде лише відкривати термінал і вводити команди для отримання журналів, які описані далі в цій статті.

Створення журналів

Щоб створити журнали, вам потрібно буде активувати налагодження USB у параметрах розробника на телефоні та виконувати команди в попередньо відкритому cmd (Windows) або терміналі (macOS). Якщо ви вже активували інструменти розробника та USB Debugging, ви можете перейти до Частини 2.

Частина 1: Активація USB Debugging на пристрої Android

  1. Відкрийте додаток Налаштування на вашому Android-пристрої.

  2. Знайдіть номер збірки (зазвичай він знаходиться в розділі Інформація про програмне забезпечення в розділі "Про телефон").

  3. Натисніть на номер збірки кілька разів, доки не побачите повідомлення Ви тепер розробник!

  4. Після активації опцій розробника знайдіть їх в налаштуваннях та відкрийте цей розділ.

  5. Якщо опції розробника ще не активовані, активуйте їх, натиснувши на відповідну кнопку-перемикач.

  6. Знайдіть опцію налагодження USB і ввімкніть її, торкнувшись перемикача.

Частина 2: Створення журналів

  1. В раніше відкритому вікні командного рядка (Windows) або Терміналі (macOS) введіть команду adb start-server та натисніть клавішу Enter на вашій клавіатурі. Це запустить сервер adb.

  2. Тепер підключіть свій телефон до комп'ютера за допомогою USB-кабелю. Якщо раніше ви не використовували USB-налагодження на своєму Android-телефоні, ви побачите запит Дозволити USB-налагодження?. Торкніться "OK". Також ви можете встановити позначку Завжди дозволяти з цього комп'ютера і знову торкнутися OK, щоб переконатися, що вас не буде постійно запитувати, коли ви намагаєтеся отримати журнали падінь.

  3. Тепер введіть в командному рядку cmd або в Терміналі команду adb devices та натисніть клавішу Enter. Це виведе список підключених до вашого комп'ютера пристроїв, переконайтеся, що ваш пристрій є в цьому списку.

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

  4. Щоб створити журнал для відтворюваних проблем, спочатку очистіть історію журналу, щоб видалити зайвий вміст, введіть команду adb logcat -c та натисніть клавішу Enter.

  5. Тепер настав час записувати журнали.

    5а. Якщо ви хочете створити журнал у поточній папці (де розташовані засоби платформи, на Windows), ви можете ввести команду adb logcat -v time > crashlog.txt у командному рядку (cmd) та натиснути клавішу Enter на клавіатурі. Процес ведення журналу почнеться після натискання Enter.

    5б. Якщо ви хочете створити журнал у якійсь іншій папці, вам потрібно скопіювати шлях до цієї папки (на Windows: перейдіть до цільової папки --> клікніть на вільному просторі в адресному рядку провідника --> скопіюйте шлях до файлу; на macOS: виділіть папку, яку ви хочете --> правий клік на неї --> клікніть на "Copy"), після того як ви скопіювали шлях до файлу, в командному рядку (cmd) або в Терміналі введіть команду adb logcat –v time > paste_file_path_here\log.txt та натисніть клавішу Enter на клавіатурі (Команда на Windows повинна виглядати так: adb logcat -v time > D:\testIO\Logs\crashlog.txt; на Mac вона повинна виглядати так: adb logcat -v time > /Users/testIO/log/crashlog.txt). Процес ведення журналу розпочнеться після натискання Enter.

  6. Тепер, коли ви розпочали ведення журналу, відтворіть помилку або падіння, для якого ви хочете створити журнал, і, якщо ви закінчили, в cmd або Терміналі натисніть CTRL + C. Це призведе до зупинки процесу ведення журналу, і ви повинні знайти свій файл журналу в вказаній папці.

Відеопояснення: 5а. - Створення журналу в поточній папці, де знаходяться інструменти платформи

Відеопояснення: 5б. - Створення журналу в іншому місці призначення (Windows)

Відеопояснення: 5б. - Створення журналу в іншому місці призначення (Mac)

Функція звіту про помилку

Інший спосіб отримати журнали з вашого телефону Android – це скориставшись функцією звіту про помилки Android безпосередньо в параметрах розробника на вашому пристрої, ви можете створювати звіти про помилки в будь-який час, які включатимуть усі дії журналу протягом певного періоду часу залежно від розміру вашого буфера журналу та активності журналу на вашому пристрої. Цей часовий проміжок може становити від кількох хвилин до кількох годин і навіть днів.

Як створити звіт про помилку за допомогою параметрів розробника

  1. Відкрийте додаток Налаштування.

  2. Знайдіть пункт Номер збірки (зазвичай він розташований у розділі "Інформація про програмне забезпечення" в розділі "Про телефон").

  3. Торкніться Номер збірки кілька разів, доки не з'явиться повідомлення Ви зараз розробник!

  4. Після активації режиму розробника знайдіть його в Налаштуваннях і відкрийте його.

  5. Якщо режим розробника ще не активовано, активуйте його, натиснувши включальний перемикач.

  6. Торкніться Надіслати звіт про помилку або Зробити звіт про помилку (назва цієї функції може варіюватися в залежності від пристрою), виберіть Інтерактивний звіт і натисніть кнопку Створити звіт.

  7. Ваш звіт буде створено. Ви можете стежити за процесом створення в розділі сповіщень. Як тільки звіт про помилку буде готовий, надішліть його собі по електронній пошті або завантажте на вибраний вами ресурс, такий як Google Drive або Dropbox.

  8. Відкрийте текстовий файл звіту на своєму комп'ютері (розпакуйте його, якщо це необхідно).

  9. Знайдіть розділ СИСТЕМНИЙ ЖУРНАЛ звіту та додайте його до звіту про помилку.

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

Отримання журналів збоїв на пристроях iOS

Отримання інформації журналу на пристроях iOS не потребує особливих зусиль. Залежно від комп’ютера, який ви використовуєте (Windows або Mac), ми покажемо вам у наступному тексті, як ви можете швидко витягнути журнали та додати їх до звіту про помилку.

Коли на вашому пристрої iOS відбувається збій, у більшості випадків файл .ips буде автоматично створено та додано до даних Analytics. Цей файл .ips вам потрібно буде прикріпити до звіту про помилку, коли ви повідомляєте про помилку щодо збою на пристрої iOS. Ви можете знайти журнали збоїв на своєму пристрої iOS, виконавши наступні кроки:

  1. Відкрийте Налаштування на вашому пристрої iOS.

  2. Знайдіть і відкрийте Конфіденційність та Безпека.

  3. Відкрийте Аналітика та Покращення.

  4. Перейдіть до Даних аналітики.

Після відкриття даних аналітики ви знайдете всі журнали, які створені на вашому пристрої iOS. Тепер у нас є частина, як їх швидко витягнути. Залежно від вашого комп'ютера (Windows або Mac), ми рекомендуємо наступні способи:

Windows

Використання 3uTools. За допомогою 3uTools ви зможете швидко знайти і витягти журнали на свій ПК під управлінням Windows, і єдине, що вам потрібно - це USB-кабель. Для цього дійте наступним чином:

  1. Завантажте 3uTools. Ви можете завантажити 3uTools тут.

  2. Встановіть 3uTools і після завершення встановлення відкрийте 3uTools.

  3. Підключіть свій iOS-пристрій до ПК за допомогою USB-кабеля.

    3а. Якщо на вашому пристрої виводиться запит Довіряти цьому комп'ютеру?, натисніть Довіряти і, за необхідності, введіть код доступу до вашого пристрою.

  4. Переконайтеся, що ваш пристрій видно в 3uTools.

  5. Клацніть Інструменти у навігаційному меню.

  6. Відкрийте Аналіз аварій і потім клацніть Файли.

  7. Знайдіть відповідний файл журналу і експортуйте його в обрану вами теку.

  8. Додайте експортований файл журналу до свого звіту про помилку.

macOS

Витягти файли журналу на macOS з iOS-пристрою ще легше, ніж на Windows. Найшвидший спосіб витягнути файли журналу з вашого iOS-пристрою на Mac - використовуючи функцію AirDrop. Для цього дійте наступним чином:

  1. ​В раніше відкритому розділі Даних аналітики відкрийте відповідний файл журналу.

  2. Торкніться кнопки Поділитися в правому верхньому куті екрану.

  3. Торкніться AirDrop.

  4. Відправте файл журналу на свій пристрій Mac.

  5. Додайте файл журналу до свого звіту про помилку.

Якщо у вас виникли труднощі з витягуванням журналів з iOS-пристрою на ваш комп'ютер Windows або Mac за раніше наведеними кроками, є також один простий обхідний спосіб. Єдиною річчю, яку вам потрібно зробити, є відкрити відповідний файл журналу в Даних аналітики, торкнутися кнопки Поділитися, вибрати додаток Пошта та відправити файл журналу самому собі. Після цього перейдіть до вашої пошти на комп'ютері Windows або Mac, завантажте журнал і додайте його до свого звіту про помилку. Звісно, якщо у вас є власні способи витягування журналів, ви можете також використовувати їх. ​

Примітка: Іноді ви можете зіткнутися з помилкою "аварійне завершення роботи", але не зможете знайти файл журналу аварії. У цьому випадку вам потрібно буде завантажити файл журналу консолі в свій звіт про помилку. Ви можете перевірити, як створити файл журналу консолі на своєму iOS-пристрої.

Ви отримали відповідь на своє запитання?