Skip to content

implementation report RU

alvit edited this page Oct 17, 2026 · 10 revisions

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

English · Контракты функций · Измерения объёма

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

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

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

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

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

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

Что исправила повторная проверка

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

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

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

Подтверждения и оставшиеся этапы

На 652726f8 прошли пять целевых браузерных сценариев: указатель LG webOS, указатель LG NetCast, два нажатия на ПК, клавиатура диалогов и полный цикл Plex «сбор → получение потока → отмена → повтор». Прошли TypeScript, unit-тест доступности, lint затронутых файлов, ES5 и проверка лимита сборки. Полный браузерный прогон по этой сборке завершился: 194 сценария прошли, один пропущен — native HLS проверяется в WebKit, а этот прогон выполнен в Chromium. Удалённый CI и согласованное слияние остаются отдельными этапами.

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

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

Полный web JavaScript вырос с 964 459 / 305 344 до 995 858 / 315 207 байт до/после gzip: +31 399 / +9 863 байта, около 3,26% / 3,23%. Кандидат с функциями занимал 995 587 / 315 103; последующие исправления добавили 271 / 104 байта. Основной итоговый entry этого снимка — 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. Версия runtime 9663b681 также исправляет возврат к прямому эфиру при ограничении качества HLS и позволяет восстановиться после повреждения журнала настроек до обычного запуска. Экран восстановления блокирует загрузку частичного аккаунта, предлагает повтор и подтверждаемый сброс, сохраняет посторонние cookies и предотвращает возврат старых настроек через cookies. Процесс и SVG-схема описаны в руководстве.

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

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

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

Интеграция браузерной приёмки

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

Версия c52f4d07 включает PR 779 из main 1ecbc0e7. Сохранены команды тестов обеих веток, проверки восстановления и диалогов Plex. Прошли TypeScript, lint, проверка документации, контрактов упаковки и сборщика, production-сборка и полный набор проверок скомпилированного кода. Все 27 JavaScript-файлов плеера и провайдеров побайтово совпадают с измеренными выше файлами. Полный браузерный набор на этой сборке завершился с 196 успешными проверками и одним ожидаемым пропуском в Chromium: native 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 из названия выбранных профилей. Это различие явно записано в отчётах; результаты не подтверждают матрицу CI или квалификацию релиза. Сохранены сводный отчёт и команда воспроизведения. Она ожидает готовую production-сборку и отказывается заменять уже распакованный каталог кандидата.

Правила браузерной приёмки требуют пяти целей CI и 25 выполнений сценариев для PR/беты; полный RC — 35 целей и 166 выполнений. Это настроенные требования, а не измеренное покрытие.

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

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

Доставка изменений

Состояние CI и слияния проверяется по этим PR. Плеер поставляется следующей волной после согласованной текущей серии исправлений Plex и её бета-релиза.


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

Clone this wiki locally