Телевизоры Samsung с 2015 года выпуска работают на операционной системе Tizen, поэтому устанавливаемые приложения упаковываются в формат .wgt — это ZIP-архив с веб-технологиями HTML5, CSS и JavaScript внутри. Ранее, до 2015 года, использовалась платформа Orsay с собственным форматом виджетов, который сейчас не поддерживается современными магазинами приложений. Понимание этой разницы критично, если вы пытаетесь установить APK-файл от Android или ищете способ запустить стороннее ПО на Smart Hub.

Файл с расширением .wgt (Widget) содержит манифест config.xml, иконки, HTML-страницы, скрипты и стили. При установке через официальный магазин Samsung Apps этот процесс происходит невидимо для пользователя, но при боковой загрузке (sideloading) разработчики и энтузиасты работают именно с этим архивом. Система проверяет цифровую подпись и идентификатор приложения перед распаковкой в защищенную область памяти.

Архитектура Tizen OS и веб-технологии

Операционная система Tizen основана на ядре Linux и использует веб-движок для рендеринга интерфейса приложений. Это означает, что нативных бинарных файлов под архитектуру ARM в стандартном приложении нет — весь код выполняется интерпретатором JavaScript. Такой подход обеспечивает кроссплатформенность между телевизорами, часами и холодильниками Samsung, но накладывает ограничения на производительность тяжелых игр.

Для доступа к аппаратным ресурсам (тунер, DRM, пульт) предоставляются специализированные Tizen API. Без знания этих интерфейсов невозможно написать полноценный плеер или приложение для умного дома. Документация по API доступна на портале разработчика Samsung Developers и обновляется с каждым крупным релизом прошивки.

⚠️ Внимание: Попытка переименовать APK-файл в .wgt не сработает, так как внутренняя структура и манифест полностью отличаются. Тизен не умеет выполнять байт-код Dalvik/ART.

Структура пакета .wgt и файл config.xml

Внутри архива обязательно присутствует файл config.xml в корне. Он описывает метаданные: идентификатор (ID), версию, имя, иконки, разрешения (privileges) и точку входа — обычно index.html. Без валидного манифеста установщик Tizen отвергнет пакет с ошибкой валидации.

Стандартная структура каталогов выглядит так: /css, /js, /images, /lib для сторонних библиотек. Размер распакованного приложения не должен превышать квоту, установленную для конкретной модели телевизора (обычно от 100 МБ до нескольких ГБ для кэша).

Пример минимального config.xml

Your App

Идентификатор приложения (App ID) формируется по схеме: ИмяРазработчика.ИмяПриложения. Он должен быть уникален в экосистеме Samsung. При конфликте ID установка новой версии перезапишет старую, что удобно для обновлений, но опасно при тестировании чужого кода.

Инструменты разработки: Tizen Studio и CLI

Официальная среда разработки — Tizen Studio. Она включает эмулятор, редактор манифеста, веб-инспектор для удаленной отладки и утилиту tizen для сборки и установки пакетов через командную строку. Установка доступна для Windows, macOS и Ubuntu.

Для быстрой сборки без IDE используется команда tizen package -t wgt --sign <имя_сертификата> -- <путь_к_проекту>. Сертификат разработчика генерируется один раз через меню Certificate Manager в Tizen Studio или утилитой tizen certificate. Без подписи телевизор в режиме разработчика не примет пакет.

💡

Используйте веб-инспектор (Remote Web Inspector) в Tizen Studio для отладки JS-ошибок на телевизоре в реальном времени. Порт по умолчанию: 7011.

Альтернативой является Visual Studio Code с расширением "Tizen Web App Development". Оно интегрирует сборку и запуск в привычный интерфейс, что ускоряет работу веб-разработчикам, не желающим переходить на тяжелую Eclipse-based IDE.

Способы установки приложений на телевизор

Существует три основных пути доставки .wgt на устройство: через официальный магазин Samsung Apps (после модерации), через USB-накопитель в режиме разработчика и по сети через CLI (sdb/tizen cli). Для последних двух требуется включить «Режим разработчика» в меню Настройки → Общие → Конфиденциальность и указать IP-адрес ПК с запущенным сервером установки.

Установка через USB: архив .wgt кладется в папку userwidget на корне флешки (FAT32). После подключения к ТВ появляется уведомление о найденных приложениях. Этот метод удобен для тестирования без сети, но требует физического доступа к порту.

☑️ Чек-лист перед установкой .wgt через USB

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

Сетевая установка через командную строку: tizen install -n <имя_файла>.wgt -t . Утилита sdb (Smart Development Bridge) устанавливается вместе с Tizen Studio и работает аналогично ADB в Android. Она позволяет также запускать, останавливать и удалять приложения удаленно.

Совместимость моделей: Orsay, Tizen 2.3 — 8.0

Телевизоры 2012–2014 годов (серии E, F, H) работают на платформе Orsay. Их приложения — это также веб-виджеты, но с другим манифестом (config.xml со специфическими тегами) и API. Магазин для них закрыт, новые приложения не публикуются. Запуск современного .wgt на Orsay невозможен из-за отсутствия API Tizen.

С 2015 года (серии J, K, M, N, Q, R, T, A, B) используется Tizen. Версии ОС: 2.3 (2015), 2.4 (2016), 3.0 (2017), 4.0 (2018), 5.0/5.5 (2019-2020), 6.0/6.5 (2021-2022), 7.0/8.0 (2023-2026). Каждая версия добавляет новые API (например, AVPlay для DRM, WebAssembly поддержка). Приложение, собранное под новый API, не запустится на старом ТВ без полифилов или условной компиляции.

💡

Ключевой момент: формат файла .wgt единый для всех версий Tizen, но набор доступных API зависит от версии прошивки телевизора.

Год выпускаСерия моделиПлатформаВерсия TizenФормат приложения
2012-2014E, F, HOrsay—Orsay Widget (.zip/.wgt)
2015JTizen2.3.wgt (Tizen)
2017M, QTizen3.0.wgt (Tizen)
2019R, QTizen5.0 / 5.5.wgt (Tizen)
2023-2026B, C, DTizen7.0 / 8.0.wgt (Tizen)

Модели линейки Lifestyle (The Frame, The Serif, The Sero) и Outdoor TV также работают на Tizen и поддерживают стандартный формат .wgt. Различия только в доступных сенсорах и разрешениях экрана, которые учитываются в CSS-медиа-запросах.

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

Ошибка «Invalid package» (неверный пакет) чаще всего означает повреждение архива, отсутствие config.xml в корне или несоответствие ID в манифесте и сертификате. Проверьте архиватор: он не должен создавать вложенную папку с названием проекта внутри .wgt — файлы манифеста должны лежать прямо в корне архива.

Ошибка «Signature verification failed» указывает на несовпадение сертификата, которым подписан пакет, с сертификатом, установленным на телевизор в режиме разработчика. Каждый ТВ привязывается к профилю разработчика при первом включении режима. Сменить профиль можно только сбросом Smart Hub.

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

Ошибка «Install failed: No space» встречается на бюджетных моделях с 4 ГБ встроенной памяти, где под пользовательские данные отводится менее 1 ГБ. Очистите кэш браузера, удалите неиспользуемые приложения через меню Настройки → Поддержка → Управление хранилищем.

📊 Какой способ установки сторонних приложений вы используете чаще?
Официальный магазин Samsung Apps
USB-флешка (режим разработчика)
CLI / Tizen Studio (по сети)
Не устанавливал сторонние приложения
⚠️ Внимание: Не пытайтесь установить приложения, требующие привилегию http://tizen.org/privilege/root или доступ к /dev/. Такие права есть только у системных приложений Samsung, сторонний код их не получит.

Публикация в Samsung Apps Store: требования к пакету

Для размещения в официальном магазине пакет .wgt должен пройти автоматическую и ручную проверку. Основные критерии: соответствие UI Guidelines (навигация пультом, фокус, анимации), отсутствие утечек памяти, поддержка минимальной версии Tizen (обычно 2.3 или 3.0), корректная работа на эмуляторе и реальных устройствах тестовой фермы Samsung.

Размер загружаемого пакета не должен превышать лимит магазина (на данный момент 200 МБ для .wgt, ассеты можно подгружать после запуска). Обязательна локализация на английский и языки целевых регионов. Иконки нужны в разрешениях 512x512, 1280x720 (баннер) и адаптивные для разных DPI.

После одобрения приложение получает статус «Published» и становится доступно в Smart Hub пользователей выбранных стран. Обновления проходят ту же модерацию. Версионирование в config.xml должно быть строго возрастающим (semver).

Часто задаваемые вопросы

Можно ли запустить Android-приложение (APK) на Samsung TV?

Нет, напрямую — нельзя. Tizen не совместим с Android Runtime. Существуют проекты-обертки (например, на базе Flutter или React Native), которые компилируются под обе платформы из единого кода, но бинарный APK на Tizen не запустится. Вариант — использовать.screen mirroring или внешнюю приставку на Android TV.

Как узнать версию Tizen на моем телевизоре?

Зайдите в Настройки → Поддержка → Информация о телевизоре. В строке «Версия ПО» или «Версия Tizen» будет указана цифра (например, 5.5 или 7.0). Также версию можно увидеть в эмуляторе Tizen Studio при подключении устройства.

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

Частая причина — ошибка в JavaScript на этапе инициализации (например, обращение к API, которого нет в этой версии Tizen). Подключите веб-инспектор (Remote Web Inspector) к запущенному приложению и посмотрите консоль: там будет красная ошибка с номером строки.

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

Нет, аккаунт Samsung Developers бесплатен. Плата взимается только за публикацию в магазине (разовая модерация) и за использование некоторых облачных сервисов Samsung (например, Push, IAP). Для локальной разработки и установки по USB/сети денег не требуется.

Поддерживает ли Tizen WebAssembly (Wasm)?

Да, начиная с Tizen 4.0 (модели 2018 года) и полноценно с 5.5. Это позволяет портировать C/C++/Rust код (видеокодеки, игровые движки, криптографию) в веб-модули .wasm и вызывать их из JavaScript. Производительность близка к нативной.