Создание или установка стороннего приложения на 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.
Формат установочного пакета и инструменты сборки жестко привязаны к ОС телевизора, кроссплатформенных бинарников не существует.
Подготовка телевизора: режим разработчика и сетевая отладка
На любом устройстве первым действием становится включение Режима разработчика (Developer Mode). На Samsung это скрытое меню в Smart Hub: нажатие комбинаций кнопок пульта (часто 12345 или зажатие Home) открывает панель ввода IP-адреса ПК для стейджинга. На LG переключатель находится в Настройки → Общие → О телевизоре → Режим разработчика.
После активации телевизор генерирует сертификат устройства (DUID) и ожидает подключения по локальной сети. Обязательное условие — ПК с IDE и телевизор должны находиться в одной подсети без изоляции клиентов (AP Isolation). Корпоративные роутеры и гостевые сети часто блокируют mDNS и прямые TCP-соединения, необходимые для деплоя.
⚠️ Внимание: Включение режима разработчика на некоторых моделях сбрасывает настройки Smart Hub или требует перезагрузки. Сохраните список авторизованных аккаунтов и пароли от Wi-Fi перед процедурой.
☑️ Подготовка к деплою
Способы установки приложений без официального магазина
Стейджинг (Sideloading) — установка пакета напрямую с компьютера разработчика — основной метод тестирования. Для Tizen используется tizen install -n package.wgt -t , для webOS — ares-install --device . 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 должен быть указан верный
Разработка собственного приложения: стек и инструменты
Если цель — написать приложение с нуля, выбор стека диктуется ОС. Для 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 | Формат пакета | Способ запуска на железе |
|---|---|---|---|---|
| Tizen | TypeScript / C# | Tizen Studio / VS Code + Ext | .wgt | sdb / tizen cli (порт 26101) |
| webOS | JavaScript / TypeScript | VS Code + ares-cli | .ipk | ares-install (порт 9998/SSH) |
| Android TV | Kotlin / Java | Android Studio | .apk / .aab | adb (порт 5555) |
| tvOS | Swift | Xcode | .app (signed) | Xcode / TestFlight (Wi-Fi) |
Используйте кроссплатформенные фреймворки (React Native TV, Flutter, Capacitor) только для прототипов. Для продакшена нативные API пульта и DRM-видео требуют платформенно-специфичного кода.
Работа с ADB, SDB и удаленной отладкой
Отладка на устройстве — единственный способ найти утечки памяти и тормоза UI. На Android TV подключение по adb connect дает доступ к 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. Пульт остается основным интерфейсом, клавиатура — вспомогательной для ввода текста.