Создание или установка стороннего приложения на Smart TV требует включения режима разработчика и знания архитектуры операционной системы вашего телевизора. Без этих действий система блокирует запуск неподписанного кода, выдавая ошибки безопасности или просто игнорируя файлы установки. Понимание различий между платформами — первый шаг к рабочему результату.

Процедура кардинально отличается в зависимости от бренда: Samsung на Tizen, LG на webOS, устройства на Android TV/Google TV и Apple TV на tvOS имеют собственные SDK, инструменты сборки и политики стейджинга. Универсальной инструкции «на все случаи» не существует, поэтому далее разберем алгоритмы для каждой популярной среды.

Основные платформы Smart TV и их архитектура

Выбор стратегии разработки или установки начинается с идентификации ОС. В меню Настройки → Поддержка → Информация о телевизоре указаны модель и версия прошивки — эти данные критичны для скачивания верного SDK. Не пытайтесь установить .apk на Tizen или .wgt на Android TV — форматы пакетов несовместимы на уровне ядра.

Каждая платформа наклагивает ограничения на фоновые процессы, доступ к кодекам и работу с пультом. Например, Tizen строго регламентирует жизненный цикл приложения через config.xml, а webOS требует специальный формат appinfo.json для манифеста. Игнорирование этих требований приводит к отказу в публикации или крашу при запуске.

  • 🟦 Tizen (Samsung) — веб-приложения на HTML5/JS/TS, нативные на .NET, IDE: Tizen Studio.
  • 🟢 webOS (LG) — Enact/React, веб-технологии, CLI: ares-cli, эмулятор в VirtualBox.
  • 🤖 Android TV / Google TV — Kotlin/Java, Jetpack Compose, APK/AAB, Android Studio.
  • 🍏 tvOS (Apple TV) — Swift/SwiftUI, Xcode, обязательное подписывание сертификатом Apple Developer.
📊 На какой платформе вы планируете запускать приложение?
Tizen (Samsung)
webOS (LG)
Android TV / Google TV
tvOS (Apple TV)
💡

Формат установочного пакета и инструменты сборки жестко привязаны к ОС телевизора, кроссплатформенных бинарников не существует.

Подготовка телевизора: режим разработчика и сетевая отладка

На любом устройстве первым действием становится включение Режима разработчика (Developer Mode). На Samsung это скрытое меню в Smart Hub: нажатие комбинаций кнопок пульта (часто 12345 или зажатие Home) открывает панель ввода IP-адреса ПК для стейджинга. На LG переключатель находится в Настройки → Общие → О телевизоре → Режим разработчика.

После активации телевизор генерирует сертификат устройства (DUID) и ожидает подключения по локальной сети. Обязательное условие — ПК с IDE и телевизор должны находиться в одной подсети без изоляции клиентов (AP Isolation). Корпоративные роутеры и гостевые сети часто блокируют mDNS и прямые TCP-соединения, необходимые для деплоя.

⚠️ Внимание: Включение режима разработчика на некоторых моделях сбрасывает настройки Smart Hub или требует перезагрузки. Сохраните список авторизованных аккаунтов и пароли от Wi-Fi перед процедурой.

☑️ Подготовка к деплою

Выполнено: 0 / 5

Способы установки приложений без официального магазина

Стейджинг (Sideloading) — установка пакета напрямую с компьютера разработчика — основной метод тестирования. Для Tizen используется tizen install -n package.wgt -t , для webOS — ares-install --device package.ipk. Android TV принимает стандартный adb install app.apk после авторизации по RSA-ключу на экране телевизора.

Альтернатива — веб-установка через браузер телевизора. Разместите .wgt, .ipk или .apk на локальном веб-сервере (Python http.server, Node serve, nginx) и откройте ссылку в браузере TV. Метод работает нестабильно: Tizen часто требует валидный SSL и соответствие CID в манифесте, а webOS блокирует скачивание с HTTP-ресурсов без сертификата.

⚠️ Внимание: Установка через браузер на Samsung Tizen работает только если версия прошивки поддерживает «Установку с флешки/сети» в меню «Мои приложения». На моделях 2018-2019 гг. эта функция часто отключена производителем.
  • 📦 CLI-деплой — быстрый, логирует ошибки установки в консоль ПК.
  • 🌐 Локальный веб-сервер — удобен для быстрой проверки без кабелей, но капризен к заголовкам Content-Type.
  • 💾 USB-накопитель — только для Android TV (через файловый менеджер) и старых версий Tizen (виджет «Установка с USB»).
Нюансы веб-установки на Tizen

Для веб-установки .wgt на Samsung нужен валидный SSL-сертификат (Let's Encrypt подойдет, если домен резолвится в локальный IP). В config.xml должен быть указан верный , совпадающий с CID разработчика. Без этого установка завершится ошибкой "Invalid package" без деталей.

Разработка собственного приложения: стек и инструменты

Если цель — написать приложение с нуля, выбор стека диктуется ОС. Для Tizen и webOS доминируют веб-технологии: React, Vue, Svelte собираются в бандл (Webpack/Vite), затем упаковываются CLI-утилитами платформы. Критически важно тестировать на реальном железе: эмуляторы не воспроизводят поведение пульта, аппаратное ускорение видео и ограничения памяти точно.

На Android TV используется стандартный Android-стек с расширениями Leanback/TV Material. Особенность — навигация D-pad (фокус), требующая ручной настройки focusable и nextFocusDown в XML или модификаторов в Compose. Для tvOS — нативный SwiftUI с FocusState, обязательная поддержка Top Shelf и интеграция с TV App.

ПлатформаОсновной языкIDE / CLIФормат пакетаСпособ запуска на железе
TizenTypeScript / C#Tizen Studio / VS Code + Ext.wgtsdb / tizen cli (порт 26101)
webOSJavaScript / TypeScriptVS Code + ares-cli.ipkares-install (порт 9998/SSH)
Android TVKotlin / JavaAndroid Studio.apk / .aabadb (порт 5555)
tvOSSwiftXcode.app (signed)Xcode / TestFlight (Wi-Fi)
💡

Используйте кроссплатформенные фреймворки (React Native TV, Flutter, Capacitor) только для прототипов. Для продакшена нативные API пульта и DRM-видео требуют платформенно-специфичного кода.

Работа с ADB, SDB и удаленной отладкой

Отладка на устройстве — единственный способ найти утечки памяти и тормоза UI. На Android TV подключение по adb connect :5555 дает доступ к logcat, perfetto и Layout Inspector. На Tizen используется sdb connect (Smart Development Bridge), предоставляющий шелл, профилировщик CPU/GPU и доступ к файловой системе песочницы /opt/usr/home/owner/apps_rw/....

Для webOS протокол — SSH на порту 9998 (логин developer, пароль — пустой или заданный в ares-setup-device). Консоль JavaScript доступна через ares-inspect --device , открывающую DevTools в браузере ПК. Это позволяет ставить брейкпоинты в React-компонентах прямо на телевизоре.

⚠️ Внимание: Длительная отладка по Wi-Fi нестабильна из-за энергосбережения сетевого модуля TV. Для профилирования производительности используйте кабель Ethernet или USB-C/ETH-адаптер, если порт предусмотрен моделью.

Типичные ошибки при установке и запуске

Самая частая ошибка «Install failed» на Tizen — несовпадение author.signature в config.xml с сертификатом, установленным на телевизор через «Разрешить установку приложений с этого IP». Решение: экспортировать профиль разработчика в Tizen Studio (Certificate Manager → Export) и импортировать его на другом ПК.

На Android TV частая причина — INSTALL_FAILED_VERSION_DOWNGRADE или INSTALL_FAILED_UPDATE_INCOMPATIBLE. Удалите старую версию через adb uninstall package.name перед установкой новой. На webOS ошибка «Not enough storage» часто ложная: очистите кэш браузера и временные файлы через SSH-команду rm -rf /tmp/ /var/cache/.

  • 🔴 Неверный ID пакета — должен совпадать с зарегистрированным в портале разработчика (для стор-сборок).
  • 🔴 Минимальная версия API в манифесте выше, чем ОС на телевизоре.
  • 🔴 Отсутствие разрешения INTERNET или ACCESS_NETWORK_STATE в манифесте Android/Tizen.
  • 🔴 Архитектура ABI — APK собран только под arm64-v8a, а телевизор на x86 (редко, но бывает на старых приставках).

Безопасность, подпись и публикация в официальные магазины

Тестирование в режиме разработчика бесплатно, но срок действия сертификата на Tizen/webOS ограничен (обычно 1 год или до смены IP). Для публикации в Samsung Apps Store, LG Content Store или Google Play требуется прохождение модерации: тесты на стабильность, соответствие UI-гайдлайнам (TV App Checklist), проверка DRM (Widevine/PlayReady) для видеоплееров.

На Android TV сборка релизного .aab (App Bundle) обязательна для Play Console. Подпись управляется Google Play App Signing — загружаете только зашифрованный ключ загрузки (upload key). Для tvOS без программы Apple Developer Program ($99/год) запуск на железе ограничен 7 днями (бесплатная подпись в Xcode), после чего приложение перестает открываться.

💡

Режим разработчика предназначен только для тестирования. Для постоянного использования приложения другими пользователями необходима публикация в официальном магазине соответствующей платформы.

FAQ: Частые вопросы по созданию и установке приложений на ТВ
Можно ли установить APK-файл на Samsung или LG?

Нативно — нет. Tizen и webOS не поддерживают формат APK. Варианты: найти порт приложения в формате .wgt/.ipk, использовать скрин-миринг с телефона, или запустить Android-приложение через эмулятор (например, на приставках с Android TV, подключенных к этим ТВ по HDMI).

Нужен ли платный аккаунт разработчика для тестирования на своем телевизоре?

Для Tizen, webOS и Android TV — нет, достаточно бесплатной регистрации (Samsung Developers, LG Developer, Google Play Console не нужен для локального ADB). Для tvOS — да, бесплатный Apple ID дает 7 дней подписи, платный Developer Program — год.

Почему приложение устанавливается, но сразу вылетает при запуске?

Проверьте логи через sdb/adb/ares-inspect. Частые причины: обращение к несуществующим API (например, Tizen API на старых прошивках), превышение лимита памяти (на бюджетных моделях ~128-256 Мб на приложение), ошибки в манифесте (неверные разрешения, точки входа).

Как обновить сайдлоуднутое приложение без потери данных?

На Android TV: adb install -r new.apk (флаг -r сохраняет данные). На Tizen/webOS: переустановка через CLI обычно сохраняет sandbox (/data), но лучше реализовать автообновление внутри приложения (проверка версии на вашем сервере и скачивание пакета).

Работает ли Bluetooth-клавиатура/мышь для навигации в своих приложениях?

Да, если ОС их поддерживает (Android TV, tvOS, webOS 4.0+, Tizen 4.0+). В коде обрабатывайте события клавиатуры как альтернативу D-pad. Пульт остается основным интерфейсом, клавиатура — вспомогательной для ввода текста.