Skip to content

implementation report RU

alvit edited this page Oct 22, 2026 · 10 revisions

От списка функций к проверенному поведению

English · العربية · বাংলা · Čeština · Deutsch · Español · فارسی · Français
עברית · हिन्दी · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Nederlands · Polski
Português · Русский · ไทย · Türkçe · Українська · Tiếng Việt · 简体中文 · 繁體中文

Контракты функций · Данные о размере

Этот отчёт фиксирует реализацию и доводку, а не объявляет релиз. Измеренный снимок плеера — 652726f8; отдельно собранный снимок нативного Android-приложения — be0d800. CI, слияние и продвижение релиза остаются отдельными проверочными этапами. Последующие коммиты только с документацией или тестами не превращают локальную проверку в доказательство обновления установленного устройства. Статусы ниже относятся к этим историческим снимкам, а не отслеживают релиз в реальном времени. Опубликованные сборки доступны в GitHub Releases.

Процесс реализации и этапы приёмки

Как проверялась работа

Исходный запрос разделили на 13 полезных функциональных частей для классического плеера, сервиса управления/CLI и независимого нативного Android-приложения. Ответственность распределили по компонентам, чтобы параллельные изменения можно было проверять и интегрировать, не заменяя работу другого компонента. Новый интерфейс использовал существующие переведённые подписи либо добавлял записи каталогов для всех 88 языков; полные инженерные руководства изначально писались на английском и русском. Теперь основное руководство и парные руководства по функциям имеют полные версии на 24 языках документации.

За реализацией последовали независимая перекрёстная проверка и исполняемые регрессионные тесты. До изменения кода каждую проблему сверяли с реальным путём колбэка, декодера, хранилища или фокуса. Падения тестов разделяли на регрессии поведения и устаревшие селекторы. Например, замена роли классических строк с button на option требовала обновления селекторов, но не давала оснований ослаблять требования к поведению клика.

Затем чистые производственные сборки проверяли выходные артефакты ES5 и полный объём JavaScript, включая необязательные модули провайдеров. Целевые браузерные тесты использовали поставляемые загрузчик, пакет и адаптеры устройств. Для нативного Android отдельно запускались тесты Gradle, lint и сборка пакетов. После отправки изменений проверки PR и обсуждения ревью проверяются повторно; успешная локальная сборка их не заменяет.

Что изменилось при ревью

Пять исправлений поведения и измеренный объём JavaScript

  • Разбор HLS и повторные попытки: ошибки разбора первоначально относились к общим сетевым ошибкам. Теперь они допускают не более одного переподключения к тому же URL в рамках лимита двух попыток при временных ошибках; новые декодеры и резервные URL этот лимит не сбрасывают. Окончательная ошибка авторизации/DRM также отменяет уже запланированную повторную попытку при временном сбое.
  • Резервный переход Native Auto: обработчик нативной ошибки мог завершить запрос, хотя режим Auto уже владел переходом на запасной вариант. Теперь существующий владелец сохраняет этот переход; отмена по-прежнему делает его отложенные колбэки недействительными.
  • Enter в модальном окне: автоматический фокус на первой кнопке отмены превращал Enter в окне ожидания Plex в отмену. Теперь фокус при открытии находится на самом диалоге. Tab явно переводит его на кнопки; обычные информационные диалоги и подтверждения сохраняют поведение Enter и Escape/Back.
  • Выбор указателем на PC: фокус мыши менял выделение до обработчика клика, превращая первый клик в активацию. Фокус от указателя больше не выделяет строку заранее. PC по-прежнему сначала выбирает, затем активирует; LG сохраняет действие одним кликом. Фокус клавиатуры по-прежнему следует за выделением.
  • Дорожки Android: выбор без подписи для текущего элемента мог стираться собственным подтверждением Auto или обновлением настройки субтитров либо переходить в другой элемент с равным TrackGroup. Теперь он переживает отложенные записи только в пределах текущего элемента. Семантические предпочтения используют язык/роль/подпись; сохранением владеет ViewModel, поэтому закрытие панели не отменяет запись.

13 реализованных частей: образец A/V; возобновляемая настройка Local/Home; ограниченное восстановление; пределы качества; предпочтения дорожек Android; ключи управления с ограниченной областью; привязки XMLTV; фильмы/сериалы Xtream; доступность классического интерфейса; устойчивые результаты команд; явная передача управления; резервные потоки; восстанавливаемые пакеты настроек. Руководство по функциям определяет область и ограничения каждой части.

Доказательства и оставшиеся этапы

Для 652726f8 прошли пять целевых браузерных сценариев: навигация указателем LG webOS, навигация указателем LG NetCast, поведение двух кликов PC, клавиатурная семантика диалогов и коллекции/разрешение/отмена/повтор Plex. Прошли TypeScript, модульный стенд доступности, lint в заданной области, проверки ES5 и бюджета пакета. Полный браузерный запуск на этой сборке завершился с 194 успешными тестами и одним пропуском: нативный HLS требует WebKit, а запуск использовал Chromium. Облачный CI и согласованная последовательность слияния остаются отдельными этапами.

Оставшаяся цепочка test:port и test:unified была завершена возобновляемыми сегментами после исправления отдельных тестовых фикстур. Каждую упавшую цель повторно запустили успешно, оставшиеся команды также завершились успешно; это не утверждение о едином непрерывном запуске npm test. Точный CI-шаг Android-моста из девяти команд также прошёл локально.

Для Android be0d800 локально прошли 101 тест приложения и 62 теста общего ядра, а также lint debug/release, сборки APK Debug/Release/Full, релизного bundle и компиляция APK androidTest. Компиляция APK инструментальных тестов не означает их выполнение на устройстве. На три подтверждённых замечания ревью ответили и закрыли их в Android PR 68. Этот PR прошёл проверки и был слит как 5b644b94; CI после слияния отслеживается отдельно. На диаграмме общий этап CI/релиза плеера остаётся незавершённым.

Полный объём веб-JavaScript изменился с 964,459 / 305,344 байт raw/gzip до 995,858 / 315,207: +31,399 / +9,863 байт (примерно 3.26% / 3.23%). Функциональный кандидат составлял 995,587 / 315,103; последующая доводка добавила 271 / 104. Итоговый основной входной файл этого снимка — 875,197 / 270,425. См. базовое измерение, измерение итогового артефакта и методику измерений.

Это исторические объёмы JavaScript в байтах, а не измеренное ускорение. Итоги не включают медиа-движки, словари, CSS, изображения и видео. Пакеты плеера того снимка отдельно содержали A/V-ролик размером 464,652 байта. После смены хостинга файл diagnostics/av-v1.mp4 остаётся в репозитории с генератором и проверяющим инструментом для воспроизводимости, но исключён из пакетов Web/OTTPlay Server, Tauri, Capacitor и Docker. Плеер загружает его с here.now только при явно запущенной A/V-проверке, требующей интернета; стартовое воспроизведение его не загружает. Удаление 464,652 байт несжатого медиаконтента не устанавливает размер экономии в сжатых установщиках и не меняет исторические измерения JavaScript. Время запуска, равномерность кадров, память, работа экранного диктора, реальный звук HDMI и поведение провайдеров требуют отдельных измерений на целевых устройствах. Отчёт не заявляет новый результат на физическом устройстве или выпуск беты. Список аппаратной приёмки и стратегия релизов остаются критериями продвижения.

Интеграция и ревью после беты

После публикации beta.4 в эту ветку интегрировали исходный снимок 39287792. Ревизия выполнения 9663b681 также исправляет возврат к краю живого эфира при ограничениях качества HLS и позволяет восстановить повреждённый журнал настроек до обычного запуска. Экран восстановления блокирует частичную загрузку состояния аккаунта, поддерживает повторную попытку и подтверждённый сброс, сохраняет посторонние cookie и не позволяет старым настройкам из cookie вернуться после сброса. См. процесс восстановления и его SVG-диаграмму.

Сравнение полного JavaScript после беты

Воспроизведение обеих исходных версий с Node 26.8.2, Rollup 4.64.5 и Terser 5.51.2 даёт 964,876 / 305,452 байта raw/gzip для исходной beta.4 и 1,000,388 / 316,600 для интеграции: +35,512 / +11,148 байт (3.68% / 3.65%). Итоги включают всех необязательных провайдеров: семь в базе и восемь в интеграции. Новый входной файл — 879,533 / 271,761. Это отдельное сравнение, не продолжение предыдущих зафиксированных графиков.

Обе локальные производственные сборки заново генерируют пять отслеживаемых файлов выполнения и не заявляют ревизию чистых исходников. Отчёты фиксируют это ограничение, а не выдают локальные файлы за опубликованные релизные артефакты: база и интеграция. Сборка интеграции и проверки ES5/нативного кода проходят. Также проходят шесть целевых браузерных проверок: восстановление/сброс журнала, клавиатурное поведение диалогов, ввод указателем LG webOS и NetCast, выбор двумя кликами PC и ожидание Plex с владельцем.

Интеграция браузерных проверок

Подтверждённые результаты локальной проверки браузеров

Исходная ревизия c52f4d07 включает PR 779 из main 1ecbc0e7. Команды тестов, проверки восстановления и утверждения для диалогов Plex обеих веток сохранены. Проходят TypeScript, lint, документация, контракты упаковки/линковки, производственная сборка и полная проверка скомпилированных пакетов. Все 27 выходных JavaScript-файлов плеера/провайдеров побайтово совпадают с измеренными выше артефактами. Полный набор браузерных тестов устройств этой сборки завершился с 196 успешными тестами и одним ожидаемым пропуском Chromium для нативного HLS, которому нужен WebKit.

Именно упакованный архив Mode A распаковали только после проверки его исходной версии, контрольной суммы и состава пакетов/провайдеров. Chromium 156.0.8078.4, Firefox 157.0 и WebKit 27.2 прошли по пять сценариев профилей без пропусков и повторов: 15 локальных успехов с Playwright 1.64.0. Реальный хост работал на macOS 26.7.1, а не на раннере macos-15, указанном в выбранных профилях. Протоколы явно фиксируют это различие и не являются прохождением облачной матрицы или квалификацией релиза. См. локальную сводку и рецепт воспроизведения, который ожидает существующую производственную сборку и отказывается заменять каталог распакованного кандидата.

Браузерная политика требует пяти облачных целей и 25 выполнений сценариев для проверок PR/беты; полный RC содержит 35 целей и 166 выполнений. Это настроенные требования, а не измеренное покрытие.

Как проверка кандидата формирует доказательства

Отдельный бета-пайплайн для main 1ecbc0e7 завершился успешно. Он не включает этот PR. Интеграции всё ещё нужны собственные успешные облачный CI и ревью, затем координация релиза; приведённые локальные результаты не утверждают, что эти этапы доставки пройдены.

Доставка

Эти PR содержат текущее состояние CI и слияния. Изменение плеера следует за согласованными текущими исправлениями Plex и их бета-релизом как отдельная волна доставки.


Source revision: f51bac7a. This documentation may describe changes awaiting release; use the matching build.

Clone this wiki locally