Часті питання та розв'язання проблем

Зміст

Застосунок не запускається

Можливі причини: застаріла версія Windows; непідтримувана архітектура; уже запущений екземпляр; недоступна папка даних.

Що перевірити:

  1. Windows має бути 64-розрядною, версії Windows 10 (1607) або новішою. Windows 7/8 і 32-розрядні системи не підтримуються.
  2. Подивіться в область сповіщень (трей) — програма може бути вже запущена й згорнута.
  3. Перевірте, чи існує папка ErrantLauncher поруч із exe і чи доступна вона для читання.

Що спробувати: перемістіть exe-файл у звичайну папку на локальному диску (наприклад, C:\Tools\) і запустіть знову; перевірте журнал ErrantLauncher\logs\bootstrap.log — він створюється за збоїв запуску.

Повідомити підтримці: версію Windows, розташування exe-файлу та вміст bootstrap.log, якщо він є.

Попередження SmartScreen

Причина: виконуваний файл не підписаний цифровим підписом — для бета-версії це очікувано, це не ознака проблеми.

Що перевірити (рекомендовано): справжність файлу за контрольною сумою. У PowerShell у папці з програмою:

Get-FileHash .\ErrantLauncher-x64.exe -Algorithm SHA256

Звірте результат із рядком у файлі SHA256SUMS.txt із комплекту релізу.

Що зробити: у вікні SmartScreen натисніть «Докладніше» → «Виконати в будь-якому разі». Вимикати SmartScreen або інший захист Windows не потрібно і не рекомендується.

Чи потрібен встановлений .NET

Ні. Середовище виконання .NET вбудовано у виконуваний файл — програма працює на чистій Windows без встановленого .NET.

Врахуйте зворотний бік однофайлового постачання: під час кожного запуску програма розпаковує бібліотеки в %TEMP%\.net\ErrantLauncher. Каталоги накопичуються — їх можна видалити вручну, доки застосунок закритий.

«Errant Launcher уже запущено»

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

Що перевірити: область сповіщень (трей) — програма могла згорнутися туди; якщо зв'язатися із запущеним екземпляром не вдається, програма повідомить про це окремо.

Що спробувати: закрийте процес через меню трея «Вихід» або диспетчер завдань і запустіть знову.

Режим «Лише читання» та «Немає носія»

Причини:

  • Лише читання — у програми немає прав на запис у папку даних (захищений носій, права доступу, карантин).
  • Немає носія — папка даних тимчасово недоступна (відключений USB-накопичувач).

Що відбувається: у режимі лише читання картки можна дивитися й запускати, але зміни відхиляються зі зрозумілим повідомленням. За «Немає носія» зміни лишаються в пам'яті й збережуться після повторного підключення накопичувача — програма повідомить «Накопичувач знову підключено».

Що перевірити: чи є папка ErrantLauncher поруч із exe; чи не встановлено в неї атрибут «лише читання»; чи підключений накопичувач з тим самим вмістом.

«Файл пошкоджено»

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

Що пропонується: у діалозі — «Видалити» пошкоджений файл або «Залишити» його (наприклад, щоб спробувати відновити вручну).

Що спробувати: відновити файл із резервної копії — з експортованого архіву через «Імпорт конфігурації» або вручну з .backup\/.mass-import-backups\ всередині папки даних.

Запуск із USB-накопичувача

Нормально: це штатний сценарій — переносьте exe і папку ErrantLauncher разом.

Типові проблеми:

  • Програма завершилася під час вилучення — закривайте її до вилучення накопичувача.
  • Картки не запускаються на іншому комп'ютері — вони посилаються на файли за локальними шляхами; перевірте статуси карток і шляхи.
  • Зміни не зберігаються — див. розділ про режим «Лише читання».

Картка-команда залишає вікно консолі

Це особливість, а не помилка. Команди виконуються з cmd /k або powershell -NoExit, щоб вивід лишився на екрані. Закрийте вікно консолі вручну, коли результат більше не потрібен.

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

Картка показує «Файл відсутній» або «Носій відсутній»

Причина: програма перевіряє доступність цілей карток. Статуси:

Статус Значення
Доступно Ціль знайдено
Файл відсутній Файлу немає за вказаним шляхом
Джерело недоступне Папка/джерело не читається
Носій відсутній Диск/накопичувач не підключений
Перевірка… Триває перевірка

Що перевірити: чи існує файл за вказаним шляхом; чи підключений потрібний диск (особливо після перенесення лаунчера на інший комп'ютер). Виправити шлях можна в «Редагувати картки».

Масовий імпорт завершився частково або з помилками

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

Що перевірити: підсумковий звіт імпорту перелічує причини («дублікат: уже є картка», «ім'я вже використовується», «зник — файл не знайдено»). Нотатки на екрані результатів показують, що відсікли фільтри: типи, архітектури, розширення, виключені папки.

Що спробувати: скоригувати фільтри та вибір; використати «Повторну перевірку» замість нового сканування.

Якщо запис перервався: перед імпортом автоматично створюється резервна копія (в .mass-import-backups\). Повідомлення про помилку вказує шлях до неї та дію: скопіюйте її вміст поверх папки даних або повторіть імпорт. Не видаляйте папку даних вручну — це знищить і резервні копії.

Вікно не вміщується на екрані

Причина: вікна програми мають фіксований розмір (вміст 1000 × 620 DIP, зовнішній габарит 1028 × 648 DIP). Якщо робоча область екрана менша — наприклад, за низької роздільної здатності в поєднанні з високим масштабом Windows — частина вікна може вийти за краї екрана, включно з верхньою панеллю з кнопками вікна.

Що перевірити: масштаб Windows (Параметри → Система → Дисплей → Масштаб) і роздільну здатність екрана.

Що спробувати: зменшити масштаб Windows або вибрати вищу роздільну здатність; якщо частина вікна за екраном — змінити масштаб і перезапустити програму, щоб вікно відцентрувалося заново.

Подробиці: Системні вимоги.

Оновлення та збереження даних

Оновлення: автооновлення немає — замініть exe-файл за закритої програми; папку ErrantLauncher не чіпайте.

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

Сортування карток: вибраний порядок сортування зберігається лише на час сесії — після перезапуску застосовується порядок за замовчуванням. Це відоме обмеження бети, а не втрата даних.

Де шукати журнали та як повідомити про помилку

Журнали: ErrantLauncher\logs\ поруч із exe — app.log (робочі повідомлення та помилки) і bootstrap.log (збої запуску). Журнали нікуди не надсилаються автоматично.

Як повідомити про помилку: покрокова інструкція, що додати і куди писати — у документі Підтримка та звіти про помилки.

Увага

Перед надсиланням журналу перегляньте його: у ньому можуть бути шляхи до ваших файлів і папок.