Skip to content
volnalabsPublic

About

Установка .wgt-приложений на телевизоры Samsung (Tizen) с Windows, macOS, Linux или прямо с Android-телефона. Без Tizen SDK: находит ТВ, создаёт сертификат, подписывает, проверяет и устанавливает.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

EasyTizen — простой способ устанавливать приложения на телевизоры Samsung



Русская версия — вы читаете её

English version


Последняя версия Сборка Загрузки Лицензия Apache-2.0

Скачать  ·  Возможности  ·  Как выглядит  ·  Установка  ·  Android  ·  Windows  ·  macOS  ·  Linux  ·  Samsung TV  ·  FAQ  ·  Для разработчиков

Скачать

Выберите своё устройство. Каждая кнопка занимает отдельную строку и ведёт на последнюю версию.

📱 Android — телефон или планшет

Android 7.0 и новее. Компьютер не нужен.

Скачать EasyTizen для Android — телефон или планшет

Файл: EasyTizen-Android.apk


💻 Windows — компьютер или ноутбук

Windows 10 и 11, 64-bit.

Скачать EasyTizen для Windows

Файл: EasyTizen-Windows-x64-Setup.exe


🍎 macOS — Mac

macOS 10.15 и новее. Один файл для Apple silicon и Intel.

Скачать EasyTizen для macOS

Файл: EasyTizen-macOS.app.tar.gz


🐧 Linux — компьютер

64-bit. Универсальный AppImage для поддерживаемых дистрибутивов.

Скачать EasyTizen для Linux

Файл: EasyTizen-Linux-x64.AppImage


Все версии и исходный код →

SHA-256 контрольные суммы доступны на странице каждого релиза.


EasyTizen: телевизор подключён, пакет проверен, всё готово к установке

EasyTizen 1.0: телевизор подключён, файл прошёл обязательную и дополнительную проверку, сертификат выбран — дальше «Установить на телевизор».

Important

Что проверено. Все функции реализованы и покрыты автоматическими тестами (в том числе против эмулятора телевизора на уровне протокола SDB), но установка на физический телевизор Samsung и запуск на реальном Android-устройстве ещё не подтверждены автором. Что именно проверено и чем — в отчёте о тестировании; что предстоит проверить руками — в чек-листе.

EasyTizen работает сразу после установки: никакого Tizen SDK, Tizen Studio, Node.js, Python и загрузок на 15 ГБ. Поиск телевизора, сертификаты Samsung, подписание и установка .wgt выполняются собственным встроенным движком — одинаково на Windows, macOS, Linux и Android.

EasyTizen — самостоятельный инструмент с открытым исходным кодом. Он не содержит приложений для телевизора и ничего не скачивает за вас: файл .wgt для установки вы выбираете сами.

Возможности

Работает прямо с телефона
Версия для Android делает всё сама: поиск, сертификат, подпись, установка — без компьютера и Termux.

Ничего не нужно докачивать
Собственный движок: без Tizen SDK, Tizen Studio и внешних программ. Установил — и сразу работаешь.

Поиск телевизоров в сети
Все сетевые интерфейсы, SSDP и служба Samsung: находит ТВ даже с выключенным режимом разработчика и говорит, что настроить.

Подключение по IP и диагностика
Проверяет сеть, Developer Mode и Host PC IP по отдельности и объясняет, что именно исправить.

Получение DUID
Сам читает номер телевизора, нужный Samsung для выпуска сертификата.

Создание сертификатов
Для телевизоров до Tizen 7 — Tizen-сертификат без учётной записи за секунды; для Tizen 7 и новее — вход в Samsung Account в браузере.

Импорт сертификатов
Уже есть author.p12 и distributor.p12 из Tizen Studio? Подключите их.

Проверка WGT в два слоя
Всегда: структура архива, защита от zip-бомб и подмены путей, безопасный XML. Дополнительно (отключаемо): ID приложения, стартовая страница, вложенные программы, имеющаяся подпись.

Подписание приложений
Подписывает временную копию вашим сертификатом. Исходный файл не изменяется.

Установка, проверка и запуск
Потоковая передача с реальным прогрессом, ход установки от самого ТВ, проверка по списку приложений, запуск.

Несколько телевизоров
Сохраняет устройства, даёт им имена; один сертификат может покрывать несколько ТВ.

История установок
Что, куда и с каким результатом ставилось — с текстом ошибки телевизора.

Диагностика
Отчёт без паролей и ключей: скопировать или сохранить в файл для сообщения об ошибке.

Автоматические обновления
Скачивает и проверяет подписанное обновление; применяет его при перезапуске. На Android — через системный установщик. Отключается в настройках.

Note

Нужен телевизор Samsung на Tizen с режимом разработчика. Для телевизоров с Tizen 7 и новее нужна ещё бесплатная учётная запись Samsung (для сертификата); телевизорам до Tizen 7 хватает Tizen-сертификата без учётной записи. Ни рекламы, ни собственных учётных записей, ни сбора данных — см. конфиденциальность.

Как выглядит

На компьютере (Windows, macOS, Linux)

Первый запуск
Первый запуск. Два коротких экрана, выбор языка, светлая тема
Поиск телевизора
Поиск телевизора. Найденные в сети, сохранённые и ввод адреса
Телевизор подключён
Телевизор подключён. Шаг свёрнут в строку, следующий подсвечен
Проверка пакета
Проверка WGT. Итог одной строкой, подробности — по нажатию
Установка
Установка. Текущий этап, процент и все этапы
Готово
Готово. Приложение установлено и запущено
Новый сертификат
Сертификат. Телевизоры, пароль — дальше вход в Samsung в браузере
Телевизоры
Телевизоры. Список и подробности рядом: адрес, DUID, проверка связи
Обновления
Обновления. Автоматический режим, последняя проверка, проверенная подпись
Проверка безопасности
Безопасность. Отключение дополнительных проверок — только с подтверждением

На планшете

Планшет, книжная ориентация
Книжная ориентация. Навигационная панель сбоку, шаги установки во всю ширину
Планшет, альбомная ориентация
Альбомная ориентация. Список телевизоров и подробности рядом

На Android

Первый запуск
Первый запуск
Главный экран
Главный экран
Поиск
Поиск телевизора
Подключение
Подключён
Выбор WGT
Файл выбран
Проверка пакета
Проверка пакета
Установка
Ход установки
Готово
Установлено
Настройки
Настройки
Обновления
Обновления
Безопасность
Проверка безопасности
Режим разработчика
Подсказка для ТВ с адресом телефона

О скриншотах: это настоящий интерфейс EasyTizen на русском языке, снятый автоматически (scripts/screenshots.mjs) в демонстрационном режиме — телевизор, сертификат, приложение My App и вышедшее обновление на них эмулированы, подпись «Демо» видна на экране. Снимки сделаны в браузере с размерами окна компьютера, экрана телефона и планшета; на реальном телефоне, планшете и телевизоре приложение пока не снималось. Окно упакованного приложения для Linux в тестовом окружении (версия 0.9.5, прежний дизайн): linux-window.png. Английские скриншоты — в английской версии.

Установка

Сначала поставьте EasyTizen на своё устройство, затем подготовьте телевизор и выполните первую установку.

Android Windows
macOS Linux
Телевизор Samsung Первая установка
Android Компьютер
Что нужно скачать дополнительно ничего ничего
Кто подписывает и устанавливает встроенный движок EasyTizen встроенный движок EasyTizen
Учётная запись Samsung только для ТВ с Tizen 7 и новее только для ТВ с Tizen 7 и новее
Сеть Wi-Fi, та же, что у телевизора Wi-Fi или кабель, та же сеть, что у телевизора

Important

Компьютер или телефон и телевизор должны видеть друг друга в одной локальной сети — подключены к одному роутеру (Wi-Fi или кабель). Не подойдут: мобильный интернет на телефоне, гостевой Wi-Fi, сеть с «изоляцией клиентов», VPN, который перехватывает весь трафик, или второй роутер, создающий отдельную сеть. EasyTizen сам показывает свой адрес и предупреждает, если телевизор в другой сети.

Android

Телефон или планшет на Android 7.0 и новее. Компьютер не нужен.

  1. Скачайте EasyTizen-Android.apk прямо на телефоне.
  2. Откройте файл. Если Android спросит про «неизвестные источники» — разрешите установку для браузера или файлового менеджера, из которого открываете файл.
  3. Запустите EasyTizen и пройдите приветствие. Телефон должен быть в той же сети Wi-Fi, что и телевизор (не мобильный интернет и не гостевая сеть).
  4. Host PC IP на телевизоре — это адрес телефона, а не компьютера. EasyTizen показывает его над кнопкой «Найти телевизоры». Если телефон переподключился к другому Wi-Fi, адрес обновится сам при возврате в приложение.
Разрешение Зачем
Доступ к сети связь с телевизором в локальной сети (порты 26101 и 8001) и со службой сертификатов Samsung
Состояние сети и Wi-Fi понять, что телефон в сети, прежде чем искать телевизор

Других разрешений приложение не запрашивает: файл .wgt выбирается через системное окно выбора документа.

Warning

Если APK собран без постоянного ключа проекта (это указано в описании релиза), новую версию нельзя поставить поверх старой: Android попросит сначала удалить прежнюю. При удалении приложения его сертификаты удаляются — создайте их заново или импортируйте файлы .p12.

↑ к выбору устройства

Windows

Windows 10 и 11, 64-bit.

  1. Скачайте EasyTizen-Windows-x64-Setup.exe и запустите.
  2. Установка идёт для текущего пользователя, права администратора не нужны.
  3. При первом поиске телевизора Windows может спросить о доступе к сети — разрешите его для частных сетей. Если домашняя сеть отмечена как «Общедоступная», брандмауэр может мешать поиску (SSDP) — переключите её на «Частная» в параметрах сети.

Приложение запускается как обычная программа Windows: без чёрного консольного окна. Ошибки записываются в журнал — Настройки → Диагностика → «Папка с журналом».

Note

Пока установщик не подписан сертификатом издателя, SmartScreen показывает окно «Система Windows защитила ваш компьютер». Нажмите Подробнее → Выполнить в любом случае. Подписан ли конкретный выпуск, написано в описании релиза.

↑ к выбору устройства

macOS

macOS 10.15 и новее.

  1. Скачайте EasyTizen-macOS.app.tar.gz — один файл для Mac на процессорах Apple и Intel.
  2. Откройте его двойным щелчком (Safari часто распаковывает сам) — появится EasyTizen. Перетащите его в «Программы».
  3. Первый запуск. Пока приложение не нотаризовано Apple, macOS его заблокирует. Откройте Системные настройки → Конфиденциальность и безопасность, прокрутите вниз и нажмите «Всё равно открыть» рядом с сообщением об EasyTizen.

Если macOS пишет, что приложение повреждено, выполните в Терминале:

xattr -cr /Applications/EasyTizen.app

↑ к выбору устройства

Linux

64-bit, с WebKitGTK 4.1 (Ubuntu 22.04 и новее, Debian 12, Fedora 38 и новее).

Один файл для любого дистрибутива — AppImage, устанавливать ничего не нужно:

chmod +x EasyTizen-Linux-x64.AppImage
./EasyTizen-Linux-x64.AppImage

Если не запускается на Ubuntu 22.04 и новее — установите libfuse2: sudo apt install libfuse2. Обновления AppImage ставит сам.

Note

Пакет .deb больше не выпускается. Если EasyTizen был установлен из .deb, удалите его (sudo apt remove easy-tizen) и пользуйтесь AppImage — настройки, телевизоры и сертификаты сохранятся.

↑ к выбору устройства

Телевизор Samsung: режим разработчика

Телевизоры Samsung не ставят приложения с флешки. Приложение не из магазина устанавливается по сети через режим разработчика.

Шаг 1 Узнайте адрес устройства с EasyTizen

EasyTizen показывает его сам — в блоке «Host PC IP для телевизора» над кнопкой поиска, в приветствии и в инструкции «Как включить режим разработчика». Это адрес вида 192.168.1.23 — его телевизор будет считать доверенным. Если вы устанавливаете с телефона, это адрес телефона; с компьютера — адрес компьютера. Телевизор помнит только один такой адрес.

Узнать адрес самостоятельно: Windows — ipconfig в командной строке (строка «IPv4-адрес» у адаптера Wi-Fi или Ethernet); macOS — Системные настройки → Сеть; Linux — ip -4 addr; Android — Настройки → Wi-Fi → ваша сеть → IP-адрес.

Шаг 2 Включите Developer Mode

  1. На телевизоре откройте раздел Apps (Приложения).
  2. Наберите на пульте 1 2 3 4 5. Если на пульте нет цифр — нажмите кнопку 123 и наберите их на экране.
  3. Включите Developer Mode.
  4. В поле Host PC IP впишите адрес из шага 1.
  5. Нажмите OK.

Шаг 3 Перезагрузите телевизор

Удерживайте кнопку питания на пульте, пока телевизор не выключится и не включится снова. В разделе Apps появится надпись Develop mode.

Tip

Адрес телевизора (если поиск его не найдёт): Настройки → Общие → Сеть → Состояние сети → Настройки IP.

Если телевизор не подключается

EasyTizen проверяет каждое условие отдельно и показывает список «Что проверено»: сеть этого устройства, та же ли это сеть, отвечает ли телевизор, включён ли Developer Mode, какой Host PC IP указан на телевизоре, открыт ли порт установки и принимает ли телевизор подключение. Состояние Developer Mode и Host PC IP приложение узнаёт у самого телевизора (служба Samsung на порту 8001) — и не утверждает того, чего не смогло проверить.

Что происходит Что проверить
«Телевизоры Samsung в этой сети не найдены» Телевизор включён и не в глубоком режиме ожидания · оба устройства в одной сети, не в гостевой · VPN выключен · введите адрес вручную
«Developer Mode выключен» Телевизор сам сообщил, что режим разработчика выключен — включите его (шаг 2)
«Неверный Host PC IP» / «Телевизор ждёт другое устройство» На телевизоре указан адрес другого устройства — EasyTizen покажет оба адреса. Впишите нужный и перезагрузите ТВ
«Телевизор разорвал соединение» Так телевизор поступает, когда Host PC IP не совпадает. Впишите адрес этого устройства, выключите и включите Developer Mode, перезагрузите ТВ
«Телевизор, похоже, в другой сети» Адрес телевизора не входит в сеть этого устройства — проверьте адрес и подключите оба устройства к одному роутеру
Раньше работало, теперь нет У телефона или компьютера сменился адрес — впишите новый в Host PC IP и перезагрузите телевизор. Адрес телевизора тоже мог смениться: «Телевизоры» → «Изменить адрес»
Адрес в Host PC IP записывается задом наперёд На некоторых прошивках с языком справа налево адрес вводится в обратном порядке
Брандмауэр Разрешите EasyTizen исходящие подключения к портам 26101 и 8001 в локальной сети

↑ к выбору устройства

Первая установка приложения

Готовить ничего не нужно: EasyTizen работает сразу после установки на всех платформах.

Шаг 1 Найдите телевизор

Нажмите «Найти телевизоры». EasyTizen сам определит активные сетевые интерфейсы (Wi-Fi, Ethernet; VPN, виртуальные машины и мобильный интернет пропускаются), опросит свою локальную сеть параллельно и покажет телевизоры по мере обнаружения: название, IP, модель, версию Tizen и статус — «Готов к установке», «Developer Mode выключен», «Неверный Host PC IP». Поиск можно отменить; длится он обычно 3–6 секунд.

Шаг 2 Подключитесь — или введите IP вручную

Нажмите «Подключить» у найденного телевизора. Если его нет в списке, введите адрес (например, 192.168.1.100) в поле «Адрес телевизора» и нажмите «Подключить». EasyTizen проверит адрес, доступность, Developer Mode и Host PC IP, прочитает модель, версию Tizen и номер устройства (DUID) и сохранит телевизор — в следующий раз искать не придётся.

Шаг 3 Выберите файл .wgt

Перетащите файл в окно или нажмите «Выберите файл .wgt». EasyTizen проверит архив и покажет название, версию и подпись; итог проверки — одной строкой, подробности — в «Что проверено».

Шаг 4 Создайте сертификат

Делается один раз. EasyTizen сам предложит подходящий тип по версии Tizen телевизора:

Телевизор Сертификат Что нужно
до Tizen 7 (примерно до 2022 года) Tizen-сертификат ничего: без учётной записи и без привязки к телевизору
Tizen 7 и новее Сертификат Samsung бесплатная учётная запись Samsung; выпускается для номера (DUID) конкретных ТВ
  1. В шаге «Подпись» нажмите «Создать сертификат» и проверьте выбранный тип.
  2. Придумайте название и пароль (не менее 8 символов: заглавная, строчная буква и цифра). Это пароль файла сертификата, а не учётной записи Samsung. Для сертификата Samsung отметьте телевизоры, для которых он нужен.
  3. Tizen-сертификат: нажмите «Создать сертификат». EasyTizen один раз скачает с download.tizen.org официальный пакет сертификатов Samsung certificate-generator (около 4 МБ), сверит три нужных файла по SHA-256 и создаст ваш собственный ключ автора, подписанный «Tizen Developers CA» из Tizen SDK. Нет доступа к download.tizen.org — скачайте этот zip на другом устройстве и выберите его в окне («Нет доступа к download.tizen.org?»). Сертификат Samsung: нажмите «Войти в Samsung и создать» — откроется страница входа Samsung в браузере. Войдите или создайте бесплатную учётную запись и вернитесь в EasyTizen.

Note

Уже есть пара сертификатов из Tizen Studio? Нажмите «Импортировать» и укажите author.p12, distributor.p12 и пароли. Сертификат дистрибьютора должен быть выпущен для DUID вашего телевизора.

Шаг 5 Установите

Нажмите «Установить на телевизор». Этапы на экране соответствуют реальным операциям: подписание временной копии → подключение → передача (реальный процент переданных байтов) → установка (процент сообщает сам телевизор) → проверка результата по списку приложений телевизора → запуск. «Установлено» показывается только после того, как телевизор подтвердил установку. Временная копия удаляется и с компьютера или телефона, и с телевизора — в том числе при ошибке, обрыве связи или отмене.

Если установка завершилась ошибкой
Сообщение Что делать
Телевизор не принял подпись Сертификат выпущен для другого телевизора или истёк. Создайте новый сертификат для этого ТВ
Приложение подписано другим автором На ТВ уже стоит это приложение с чужой подписью. Нажмите «Удалить старую копию…» под ошибкой — EasyTizen удалит её и повторит установку
На телевизоре недостаточно места Удалите ненужные приложения на телевизоре
Телевизор перестал отвечать / разорвал соединение Проверьте Wi-Fi, не ушёл ли телевизор в режим ожидания, и повторите. Недопереданный файл на телевизоре не остаётся
Телевизор не подтвердил установку Проверьте раздел Apps; откройте «Технические подробности» и приложите их к сообщению об ошибке

Полный текст ответа телевизора доступен под ошибкой в «Технических подробностях» и в разделе «История».

↑ к выбору устройства

Вопросы и ответы

Какие телевизоры поддерживаются?

Телевизоры Samsung на Tizen с режимом разработчика — это модели примерно с 2016 года. Телевизоры Samsung на других системах (Orsay, до 2015 года) и телевизоры других марок не поддерживаются. Список моделей, проверенных с EasyTizen, появится в отчёте о тестировании — сейчас он пуст.

Как включить Developer Mode?

Apps → наберите на пульте 1 2 3 4 5 → включите Developer Mode → впишите в Host PC IP адрес устройства с EasyTizen → перезагрузите телевизор. Подробно — в разделе Samsung TV; та же инструкция с вашим адресом есть в самом приложении.

Почему телевизор не находится?

Поиск работает только в вашей локальной сети и сочетает три способа: параллельный опрос адресов каждой сети Wi-Fi/Ethernet (сети до /22 целиком, более крупные — в пределах /24 вокруг вашего адреса) на порт установки 26101 и службу Samsung 8001; запрос SSDP, на который отвечают телевизоры Samsung; повторную проверку сохранённых телевизоров по последнему адресу. Каждый кандидат подтверждается настоящим рукопожатием SDB или ответом службы Samsung, поэтому посторонние устройства в список не попадают. Телевизор не найдётся, если он выключен или в глубоком режиме ожидания, если устройства в разных сетях (гостевой Wi-Fi, изоляция клиентов, VPN, второй роутер). В таких случаях введите адрес телевизора вручную.

Почему нужен Host PC IP?

Телевизор принимает подключения разработчика только с одного адреса, который вы сами указали в окне Developer Mode. Это его защита: посторонние устройства в сети не смогут ничего установить. Поэтому при смене адреса телефона или компьютера Host PC IP нужно обновить и перезагрузить телевизор.

Что такое DUID?

Device Unique ID — уникальный номер телевизора. Samsung вписывает его в сертификат дистрибьютора, и телевизор принимает только пакеты, в сертификате которых есть его номер. EasyTizen читает DUID сам при подключении.

Зачем нужны сертификаты?

Tizen устанавливает только подписанные приложения. Нужны два сертификата: автора (кто собрал пакет) и дистрибьютора (на каких телевизорах его можно запускать). Оба бесплатно выпускает Samsung для вашей учётной записи. Закрытые ключи создаются на вашем устройстве и никуда не отправляются.

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

Так Samsung ограничивает установку приложений не из магазина: сертификат дистрибьютора действует только на телевизорах, чьи DUID в него вписаны. Для нового телевизора создайте новый сертификат — или сразу отметьте в окне создания несколько телевизоров.

Какие WGT можно установить?

Веб-приложения Tizen в формате .wgt (ZIP-архив с config.xml) размером до 512 МБ. Подписан файл или нет — неважно: EasyTizen подпишет копию вашим сертификатом. Форматы .tpk и приложения для других платформ не поддерживаются. Будет ли приложение работать, зависит от версии Tizen вашего телевизора — требуемая версия показана в сведениях о файле.

Почему установка завершилась ошибкой?

Чаще всего — из-за сертификата (выпущен для другого телевизора или истёк), конфликта с уже установленной копией от другого автора или потери связи. EasyTizen показывает причину обычным языком, а полный ответ телевизора — в «Технических подробностях». Таблица решений — в разделе «Первая установка».

Можно ли устанавливать приложения прямо с Android?

Да, версия для Android — самостоятельный установщик: тот же встроенный движок на Rust, что и на компьютере, сам ищет телевизор в Wi-Fi, общается с ним по протоколу SDB, выпускает сертификаты и подписывает пакеты. Файл .wgt выбирается через системное окно выбора файлов (в том числе из «Загрузок» и облачных папок). Важная оговорка: эта версия проверена автоматическими тестами и сборкой APK, но не на реальном телефоне с реальным телевизором — см. ограничения.

Нужен ли компьютер?

Нет, если у вас Android. Версии для Windows, macOS и Linux делают то же самое — для тех, кому удобнее с компьютера.

Где хранятся сертификаты?

В папке данных приложения, certificates/<название>/author.p12 и distributor.p12, зашифрованные вашим паролем. Пароль не сохраняется — EasyTizen помнит его до закрытия и спрашивает снова после перезапуска. Действующий сертификат используется повторно для всех установок на телевизоры, для которых он выпущен.

Сертификаты, созданные прежними версиями через Tizen SDK, никуда не деваются: на странице «Сертификаты» они помечены «Нужен перенос». Нажмите «Перенести» и введите пароль — EasyTizen скопирует их из хранилища Tizen SDK (или из ~/SamsungCertificate/<название>/ Tizen Studio) в своё хранилище, не изменяя исходных файлов. Если файлы не нашлись, импортируйте author.p12 и distributor.p12 вручную.

Папка данных: Windows — %APPDATA%\io.github.volnalabs.easytizen, macOS — ~/Library/Application Support/io.github.volnalabs.easytizen, Linux — ~/.local/share/io.github.volnalabs.easytizen, Android — внутреннее хранилище приложения, недоступное другим приложениям.

Как обновляется EasyTizen?

Настройки → Обновления приложения. В автоматическом режиме (включён по умолчанию) EasyTizen раз в несколько часов спрашивает у GitHub последнюю версию, скачивает обновление и проверяет его подпись ключом проекта. На Windows, macOS и Linux оно применяется при перезапуске — EasyTizen спросит подтверждение и никогда не перезапустится во время установки на телевизор. На Android скачанный APK сверяется с контрольной суммой релиза и передаётся системному установщику: Android сам попросит подтвердить установку (и один раз — разрешить установку из EasyTizen). Если приложение установлено из Google Play, обновления приходят оттуда. Выключите переключатель — и никаких фоновых проверок и загрузок не будет; кнопка «Проверить сейчас» работает всегда. Сборки без ключа подписи обновлений (например, собранные самостоятельно) ничего не устанавливают сами и предлагают скачать установщик вручную.

Что проверяет EasyTizen перед установкой и можно ли это отключить?

Проверка состоит из двух слоёв.

  • Безопасная обработка файла — всегда. Структура ZIP-архива, защита от подмены путей (Zip Slip), ограничения числа файлов, размера и степени сжатия (zip-бомбы), повреждённые архивы, config.xml без DTD и сущностей. Эти проверки не отключаются.
  • Дополнительные проверки — включены по умолчанию. ID приложения в формате Tizen и совпадение с ID пакета, наличие стартовой страницы, отсутствие исполняемых программ для других систем (ELF, Windows PE, Mach-O), отсутствие повторяющихся имён файлов и — при установке без переподписи — совпадение имеющейся подписи с файлами. Пакет с проблемами не устанавливается.

Дополнительные проверки можно отключить: Настройки → Безопасность → «Дополнительная проверка безопасности приложений». EasyTizen попросит подтвердить отключение, покажет предупреждение у каждого пакета и перед каждой установкой попросит явно подтвердить, что вы доверяете файлу. Это проверки целостности и согласованности, а не антивирус.

Как диагностировать проблемы?

Настройки → Диагностика → «Скопировать отчёт» (или «Сохранить в файл»). В отчёте — версия, система, сетевые интерфейсы и адрес для Host PC IP, сохранённые телевизоры, сертификаты, последние установки с ошибками и конец журнала. Паролей, ключей и токенов в нём нет, номера устройств сокращены. Журнал ведётся в папке данных приложения (logs/easytizen.log); на компьютере его папка открывается кнопкой «Папка с журналом». Приложите отчёт к сообщению об ошибке.

Я пользовался TV Deploy. Что с моими данными?

EasyTizen — новое имя TV Deploy. При первом запуске он сам переносит настройки, сохранённые телевизоры и профили сертификатов. Tizen SDK больше не нужен; его можно удалить после того, как вы перенесли сертификаты (страница «Сертификаты» → «Перенести»). EasyTizen ничего из SDK не удаляет сам.

Для разработчиков

Архитектура, структура, тесты и сборка
React/TS интерфейс ──типизированные команды──▶ src-tauri (Rust) ──▶ easytizen-core (Rust, везде)
                                                                     поиск ТВ · SDB-клиент · подпись WGT
                                                                     выпуск сертификатов Samsung CA

Один движок для всех платформ; приложение не запускает дочерних процессов.

crates/easytizen-core/   ядро без зависимости от UI: поиск ТВ (discovery), SDB-клиент, проверка
                         и подписание WGT, Samsung CA, диагностика, эмулятор телевизора для тестов
src-tauri/               оболочка Tauri 2: команды, настройки, история, журнал, обновления
src-tauri/gen/android/   проект Android (Gradle)
src/                     интерфейс (React, TypeScript, Tailwind), демо-бэкенд для браузера
scripts/                 релизные проверки, генерация картинок README, тесты-ограничители
docs/                    документация, скриншоты, оформление README

Для сборки из исходников (пользователям готовых сборок это не нужно) нужны Node.js 22 и Rust stable; для компьютера — зависимости Tauri, для Android — JDK 21, Android SDK (platform 36, build-tools 35) и NDK 27.

npm ci

# Тесты
cargo test --workspace --features easytizen-core/mock-tv   # Rust: ядро и бэкенд
npm test                                                   # интерфейс и релизные скрипты
npm run typecheck

# Интерфейс в браузере с эмулятором ТВ (без Rust)
npm run dev            # http://localhost:1420 · ?platform=android · ?demo=fresh · ?update=available · ?checks=off|fail

# Эмулятор телевизора (SDB на 26101 и служба Samsung на 8001 — находится поиском)
cargo run -p easytizen-core --example mock_tv --features mock-tv -- 0.0.0.0 26101

# Компьютер
npx tauri dev
npx tauri build --bundles appimage         # nsis | app (--target universal-apple-darwin)

# Android
export ANDROID_HOME=… NDK_HOME=$ANDROID_HOME/ndk/27.2.12479018
npx tauri android build --apk --target aarch64 armv7

Подробнее: архитектура · дизайн-система · отчёт о тестировании · ограничения · выпуск релизов и подпись · зависимости · история изменений.

Лицензия и конфиденциальность

Лицензия. Apache-2.0. EasyTizen — независимый проект; он не связан с Samsung и не одобрен ею. Samsung и Tizen — товарные знаки их владельцев.

Сторонние компоненты

Компонент Где используется Лицензия
Открытые сертификаты Samsung VD CA из Samsung tizen-agent-skills встраиваются в сертификаты пользователя Apache-2.0, см. LICENSE и NOTICE
Tauri 2 и плагины dialog, fs, opener оболочка приложения MIT / Apache-2.0
React, lucide, Tailwind CSS интерфейс MIT / ISC
RustCrypto (rsa, sha2, x509-cert), p12-keystore, ureq, rustls, zip, roxmltree, if-addrs, socket2 ядро MIT / Apache-2.0 / BSD-3-Clause

Tizen SDK не используется и не скачивается. Полный список — в docs/DEPENDENCIES.md.

Что хранится на устройстве. Настройки, список телевизоров (адрес, имя, модель, DUID), сведения о сертификатах, история установок и журнал — в папке данных приложения. Сертификаты — зашифрованными файлами .p12. EasyTizen не записывает на диск пароли сертификатов и токен Samsung; в журнал и историю секреты не попадают.

Куда обращается приложение

Адрес Когда Что передаётся
Ваш телевизор, порт 26101, локальная сеть поиск, подключение, установка команды SDB и ваш пакет
Ваш телевизор, порт 8001, локальная сеть поиск и проверка подключения запрос сведений об устройстве (модель, Developer Mode, Host PC IP)
Адреса вашей локальной сети, порты 26101 и 8001; SSDP 239.255.255.250:1900 только при нажатии «Найти телевизоры» попытка TCP-подключения; запрос M-SEARCH
account.samsung.com (в вашем браузере) создание сертификата вход выполняете вы сами на сайте Samsung
svdca.samsungqbe.com создание сертификата запрос на сертификат (открытый ключ, имя автора, DUID) и токен Samsung
api.github.com, github.com и хранилище файлов GitHub проверка и загрузка обновлений (отключается) ничего, кроме стандартного запроса

Собственных серверов, аналитики и телеметрии у EasyTizen нет.

About

Установка .wgt-приложений на телевизоры Samsung (Tizen) с Windows, macOS, Linux или прямо с Android-телефона. Без Tizen SDK: находит ТВ, создаёт сертификат, подписывает, проверяет и устанавливает.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages