Устранение неполадок

Сначала загляните в журнал

Вкладка Журнал показывает вывод приложения и Xray-core в реальном времени. Чтобы получить больше подробностей, повысьте Уровень журналирования Xray в настройках (расширенные параметры). При включённых расширенных параметрах сгенерированную конфигурацию также можно открыть в просмотрщике.

Внутренние сообщения помечаются тегом INTERNAL, сообщения ядра — CORE, на экране и в экспортированном тексте. Вкладки «Все», Internal и Core используют значки Notes, Android и Manufacturing из Material Symbols.

Селектор «Все/Internal/Core» расположен поверх нижнего градиента. Значок выбранной вкладки плавно появляется при переключении. При нажатии на удалённую вкладку анимируются только исходная и выбранная вкладки; при свайпе и завершающей прокрутке выделение следует за позицией страницы. Нижний отступ заканчивается ровно на верхней границе затухания. Кнопка прокрутки вниз рисуется поверх затухания и находится на 8 dp выше селектора — с таким же зазором, как между селектором и нижней навигацией приложения. Высота верхней области затухания — 16 dp; дополнительного запаса прокрутки нет. Поиск и селектор плавно заменяются вместе с градиентом и отведённым под них пространством. При выделении строк селектор с градиентом плавно уезжает и исчезает, освобождая отведённое место. Кнопка прокрутки вниз также скрывается при выделении. Снятие выделения возвращает их.

Нажмите Поиск в журнале (значок поиска на странице перед меню экспорта), чтобы открыть поле поиска над клавиатурой. Поиск фильтрует текущую вкладку Все, Internal или Core по тексту сообщения без учёта регистра. Кнопка закрытия в заголовке закрывает поиск и клавиатуру. Если введён запрос, в заголовке отображается число совпавших строк; действия экспорта и очистки скрываются, когда совпадений нет. Закрытие клавиатуры сохраняет поиск открытым, если есть запрос или выделенные строки. Открытие меню экспорта касанием оставляет клавиатуру поиска на месте и сохраняет выделение даже при пустом поле поиска. Жест «назад» сначала закрывает меню, сохраняя поиск и выделение. При пустом поиске и без выделения в заголовке остаётся только кнопка закрытия. Переключение вкладок журнала свайпом заблокировано при открытом поиске и при выделении строк.

При выделении строк журнала верхняя панель окрашивается как при прокрутке, а затухание под ней плавно исчезает. Снятие выделения возвращает обычный цвет панели и затухание.

Нажмите и удерживайте строку журнала, чтобы выделить её, затем проведите или нажмите, чтобы выделить ещё. Когда выделена хотя бы одна строка, а в текущем списке больше одной строки, первым действием на панели появляется Выбрать все — оно выделяет все видимые результаты на активной вкладке. Когда все эти строки выделены, кнопка меняется на Снять выделение: она очищает выделение, не закрывая поиск. Панель выделения умеет копировать выбранные строки, а её меню экспорта предлагает Сохранить в файл и Поделиться журналом только для них. Без выделения меню экспорта сохраняет или отправляет весь журнал активной вкладки Все, Internal или Core. Имена файлов заканчиваются на -all.txt, -internal-only.txt, -core-only.txt или -selected.txt, чтобы было понятно, что именно экспортировано. Очистка журнала требует подтверждения и удаляет записи и приложения, и Xray.

У редактора JSON активной конфигурации Xray или отдельного сервера нет затухания и фиксированных полос у верхнего и нижнего краёв. Внутренние отступы прокручиваются вместе с текстом, а небольшой зазор не даёт тексту касаться рамки.

Частые проблемы

Подписка не обновляется. Проверьте, не говорится ли в ошибке о небезопасном соединении. По умолчанию Material Xray отказывается от обычного HTTP, недействительных сертификатов и перенаправлений с HTTPS на HTTP. Если вы доверяете источнику, включите для этой подписки Разрешить небезопасные обновления.

Провайдер сообщает, что устройство не распознано. Подписке может требоваться идентификатор оборудования или определённый User-Agent. Убедитесь, что включено Отправлять HWID, или попробуйте предустановку User-Agent Happ. См. заголовки запроса.

Правила маршрутизации пропущены. Не удалось скачать геоданные провайдера, поэтому приложение работает в режиме совместимости. Нажмите на баннер на вкладке «Маршруты», чтобы повторить попытку.

Режим с root переключается на режим без root. Постоянный VPN в Android принудительно включает режим без root. Отключите его для Material Xray, если хотите использовать root.

Как сообщить о проблеме

Создайте issue и укажите:

версию Android и модель устройства,
режим работы (без root или с root, и какое решение для root),
шаги для воспроизведения.