Отримання журналів роботи Krita

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

  1. Журнал користування Krita — у цьому журналі містяться дані останніх 10 сеансів Krita (одним сеансом вважається проміжок роботи програми після її запуску). У журналі вказано моменти часу відкриття програми, базові відомості щодо системи і Krita, а також назви усіх створених, відкритих та збережених файлів, включно із усіма файлами автоматично створених копій.

  2. Відомості щодо системи — це не зовсім журнал, просто файл, який містить докладні відомості щодо системи, які пов’язано із Krita.

  3. Журнал або зворотне трасування аварійного завершення роботи — цей журнал буде створено, якщо роботу Krita буде завершено аварійно через якусь внутрішню проблему. Вміст цього журналу часто є необхідним для виправлення вади у програмі, якщо розробникам не вдається відтворити цю ваду (повторити кроки, які призводять до аварійного завершення роботи програми) самостійно.

  4. Виведення Krita до консолі/Виведення до журналу перегляду/Виведення на панель діагностики — у цьому журналі містяться випадкові повідомлення, які логіка програми Krita виводить до звіту щодо роботи. У цьому журналі часто містяться додаткові корисні дані, які можуть допомогти усунути проблему.

Швидкий доступ

Журнал користування Krita

З використанням графічного інтерфейсу

Найпростішим способом отримати дані з журналу користування Krita є використання графічного інтерфейсу Krita. Скористайтеся пунктом меню Довідка ‣ Показати журнал Krita для звітування про вади. У відповідь буде відкрито нове діалогове вікно, у якому буде показано вміст журналу.

З використанням файлової системи

Втім, іноді скористатися графічним інтерфейсом Krita неможливо. Наприклад, у випадках, коли вікно програми просто неможливо відкрити. Оскільки журнали є звичайними текстовими файлами, ви можете отримати до них доступ вручну за допомогою файлової системи вашого комп’ютера.

Файл журналу має назву krita.log. Місце зберігання файла:

Linux

$HOME/.local/share/krita.log

Windows

%LOCALAPPDATA%\krita.log

macOS

$HOME/Library/Application Support/krita.log

Android

  • Версія для Play Store: <storage>/Android/data/org.krita/files/krita.log

  • Krita Next: <storage>/Android/data/org.krita.next/files/krita.log

Примітка

У Windows ви можете просто вставити цей шлях до рядка пошуку Провідника Windows на верхній панелі, і програма знайде для вас відповідний файл.

Журнал аварійного завершення роботи та зворотне трасування

Розташування і спосіб отримання даних зворотного трасування у різних системах є різним.

Windows

Зазвичай, достатньо надати дані, які показано у вікні, що відкривається пунктом меню Довідка ‣ Показати журнал Krita для звітування про вади, оскільки у цих даних міститься зворотне трасування.

Якщо ви не можете відкрити вікно Krita, оскільки програма завершує роботу в аварійному режимі під час запуску, будь ласка, надайте дані з файла %LOCALAPPDATA%\kritacrash.log. Іноді, потрібна докладніша інформація. У таких випадках вам слід точно виконати настанови з розділу щодо засобу діагностики Dr. Mingw.

Linux

У Linux передбачено п’ять способів встановлення Krita.

  • За допомогою пакунків дистрибутива

  • Збирання і встановлення Krita власноруч

  • За допомогою пакунка snap

  • За допомогою пакунка flatpak

  • За допомогою офіційного пакунка AppImage

Придатні до аналізу журнали аварій та дані зворотного трасування можна отримати лише з пакунків дистрибутивів або зібраних власноруч версій. Для роботи з пакунками дистрибутивів вам слід встановити відповідні діагностичні пакунки (debug або dbg). Спосіб встановлення залежить від конкретного дистрибутива. Якщо ви користуєтеся пакунками дистрибутива і стільничним середовищем Плазми KDE, система покаже діалогове вікно аварійного завершення роботи, у якому дані зворотного трасування буде наведено на вкладці «Розробник».

У інших випадках вам доведеться скористатися gdb у вікні термінала.

  1. Відкрийте Krita у gdb:

    # якщо Krita встановлено зі сховищ пакунків дистрибутива, вам, можливо, достатньо скомандувати «gdb krita»
# якщо це не так, вкажіть шлях до виконуваного файла
gdb path/to/krita

  2. Вимкніть поділ на сторінки:

    set pagination off

  3. Запустіть Krita:

    run

  4. Виконайте дії, які призводять до аварійного завершення роботи.

  5. Отримайте скорочений варіант зворотного трасування:

    thread apply all bt

  6. Отримайте повний варіант зворотного трасування:

    thread apply all bt full

  7. Скорочений і повний варіанти зворотного трасування зберігаються у окремих текстових файлах.

  8. Зі скороченого варіанта зворотного трасування рекомендуємо вилучити усі дані потоків, які є ідентичними або, очевидно, не містять корисної інформації.

    Якщо ви впевнені щодо того, яка саме частин зворотного трасування є найважливішою (зазвичай, це найдовша гілка виконання), виріжте її і вставте вирізаний фрагмент до звіту щодо вади як коментар. Втім, корисними будуть обидва варіанти зворотного трасування — їх також варто долучити до вашого звіту щодо вади.

    Якщо ви не певні щодо корисних для розробників даних, просто долучіть обидва файли зворотного трасування до звіту щодо вади.

macOS

У системах macOS рекомендуємо скористатися lldb.

  1. Відкрийте Terminal.app

  2. Відкрийте Krita у lldb:

    lldb /Applications/krita.app/Contents/MacOS/krita

  3. Запустіть Krita:

    run

  4. Виконайте дії, які призводять до аварійного завершення роботи.

  5. Отримайте дані зворотного трасування:

    thread backtrace all

  6. Збережіть дані зворотного трасування до текстового файла.

  7. Зі зворотного трасування рекомендуємо вилучити усі дані потоків, які є ідентичними або, очевидно, не містять корисної інформації). Корисні дані варто додати як коментар, так, щоб розробнику було простіше з ними працювати.

    Якщо ви впевнені щодо того, яка саме частин зворотного трасування є найважливішою (зазвичай, це найдовша гілка виконання), виріжте її і вставте вирізаний фрагмент до звіту щодо вади як коментар. Втім, корисним буде і повний варіант зворотного трасування — його також варто долучити до вашого звіту щодо вади.

    Якщо ви не певні щодо корисних для розробників даних, просто долучіть файл із даними зворотного трасування до звіту щодо вади.

Android

Для отримання журналів за допомогою графічного інтерфейсу скористайтеся даними, які надає пункт меню Довідка ‣ Показати журнал Krita для звітування про вади.

Якщо ви не можете відкрити вікно Krita, оскільки програма завершує роботу під час запуску, будь ласка, надайте вміст файла <storage>/Android/data/org.krita/files/kritacrashlog.txt.

Logcat (Android)

Для отримання виведених даних logcat для Krita скористайтеся даними, які надає пункт меню Довідка ‣ Показати журнал Android для звітування про вади.

Текстове виведення Krita

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

З використанням графічного інтерфейсу

  1. Скористайтеся пунктом меню Параметри ‣ Бічні панелі ‣ Перегляд журналу.

  2. За допомогою найлівішої кнопки можна вмикати і вимикати ведення журналу. Переконайтеся, що вона перебуває у натиснутому стані.

  3. Виконайте дії, які слід виконати для отримання потрібних вам виведених даних.

  4. Скористайтеся третьою за ліком кнопкою (вона має підказку Зберегти журнал) для збереження журналу до файла.

  5. Долучіть файл до звіту щодо вади.

За допомогою консолі

Використання консолі є найнадійнішим способом отримати виведені Krita текстові дані. Це стосується операційних систем macOS і Linux.

Змінено в версії 5.0: Крім того, у новій версії це можна робити у Windows за допомогою виконуваного файла krita.com.

Примітка

Виконуваний файл krita.com запускає Krita як програму, яка працює з командного рядка, за допомогою вікна консолі. Цим файлом не можна було скористатися у версіях Krita до 5.0. Якщо ви користуєтеся старішою версією або надаєте перевагу використанню програми krita.exe без вікна консолі, див. настанови щодо DebugView.

  1. У macOS відкрийте Terminal.app, у Linux відкрийте ваш улюблений емулятор термінала або програму-консоль. У Windows відкрийте командний рядок введенням команди cmd.exe у меню «Пуск» із наступним натисканням клавіші Enter.

  2. Впишіть шлях до виконуваного файла Krita.

    # У Linux, якщо встановлено зі сховищ пакунків дистрибутива:
krita
# У Linux, в усіх інших випадках:
#  (пам'ятайте, що якщо ви хочете послатися на файл з каталогу,
#   у якому ви зараз працюєте, вам слід вказати «./назва_файла_krita» замість «назва_файла_krita»
#   і пам'ятайте, що цей файл повинен мати права на виконання, щоб його можна було виконати)
шлях/до/krita

    # У macOS:
/Applications/krita.app/Contents/MacOS/krita

    REM  У Windows:
REM  Типово, у cmd.exe надано перевагу запуску файла .COM, а не .EXE, отже,
REM  ви можете пропустити суфікс назви файла .COM.
"C:\Program Files\Krita (x64)\bin\krita.com"

  3. Виконайте дії, які слід виконати для отримання потрібних вам виведених даних.

  4. Скопіюйте дані, збережіть їх до файла і долучіть файл до звіту щодо вади.

За допомогою DebugView

Щоб отримати текстове виведення Krita у Windows за допомогою програми із графічним інтерфейсом, вам слід скористатися зовнішньою програмою, яка має назву DebugView. Порівняно із використанням консолі, перевагою DebugView є включення часових позначок до записів журналу.

  1. Отримайте DebugView, якщо програму ще не встановлено у системі. Натисніть яскраво-синій запис Download DebugView із підкреслюванням. Одразу після цього має розпочатися отримання даних програми.

  2. Отриманий вами файл є архівом .zip. До складу Windows 10 вже включено засоби розпаковування zip. Достатньо видобути усі файли з архіву до якоїсь теки. Докладніше про видобування даних можна дізнатися зі сторінки підручника Windows, яку присвячено видобуванню даних.

  3. У видобутих із архіву даних буде файл із назвою DbgView.exe (підписом до якого буде DbgView, залежно від параметрів роботи вашої системи). Двічі клацніть на ньому.

  4. Дочекайтеся запуску програми і відкрийте у ній Krita.

  5. Виконайте дії, які слід виконати для отримання потрібних вам виведених даних.

  6. Перемкніться на DebugView і скопіюйте дані. Збережіть дані до файла і долучіть файл до звіту щодо вади.