Брендирование Smart Launcher

• Мета-пакет приложений определяет набор и порядок приложений в главном меню.
• Тема позволяет изменить цвет, фон, размеры визуальных элементов приложений и шрифтов.
• Конфигурация лаунчера позволяет установить логотип и сформировать набор категорий в главном меню (стандартные категории - Media, Apps, Games). 

Брендирование Ministra TV platform осуществляется двумя способами:

1. Создание/модификация темы, мета-пакета приложений, изменение конфигурации лаунчера.

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

В данном документе встречается сокращение "{0}"- текущая высота экрана (1080, 720, 576, 480), подставляется в зависимости от разрешения, установленного на устройстве.

Мета-пакет приложений

Набор и порядок приложений определяется в мета-пакете, согласно его зависимостям в файле package.json . Стандартный мета-пакет называется stalker-apps-base . 

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

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

Как разработать и активировать свой мета-пакет используя стандартный мета-пакет:

1. В файле package.json измените название пакета stalker-apps-base на собственное.

2. Укажите название мета-пакета в конфигурационном файле custom.ini . ( значение поля launcher_apps_base_metapackage ).

3. Опубликуйте пакет с помощью системы npm. В каталоге этого пакета выполните команду

   npm publish

4. Установите опубликованный пакет через административную панель . Подробнее см. здесь.

Для редактирования фирменного мета-пакета перейдите в административную панель и выполните следующие действия:

1. Откройте вкладку Приложения.
2. Выберите Приложения Smart Launcher.
3. Нажмите Список установленных и выберите Сохранить список.
4. Отредактируйте сохраненный список (измените порядок приложений, удалите приложения, добавьте собственный набор приложений).
5 . Нажмите  Список установленных  и выберите  Загрузить список .
6. Нажмите кнопку  Выбрать файл , загрузив отредактированный вами список приложений.
7. Нажмите  Отправить .

npm publish

Темы приложений Ministra TV platform 5.x

В мета-пакете stalker-launcher-base содержатся следующие темы:

• Stalker 5x - graphite (magcore-theme-graphite)
• Stalker 5x - chocolate (magcore-theme-chocolate)

Для изменения внешнего вида темы, создайте свою тему или модифицируйте установленную.

Для поддержки совместимости разных версий приложений и тем выработан стандарт темы. Стандарт темы - набор CSS классов, необходимых для корректного отображения приложений.

Стандарт темы описан в npm-пакете magcore-theme в файле readme.md .

Создание темы

Для создания своей темы с использованием только CSS, достаточно опубликовать npm-пакет, с рекомендуемым префиксом magcore-theme- , в котором должно быть четыре CSS-файла: 480.css , 576.css , 720.css , 1080.css для четырех разрешений соответственно.

Эти файлы должны соответствовать требованиям стандарта темы текущей версии. Для просмотра текущей версии стандарта перейдите в административную панель и отфильтруйте приложения по типу Системные. Версия пакета magcore-theme и будет текущей.

Исходные файлы любой темы предоставляются посредством запроса в поддержку по e-maile: support@infomir.eu.

Модификация существующей темы

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

Пример пути к теме: /stalker_launcher_apps/magcore-theme-имя_темы

В корне темы лежит файл, отвечающий за фон темы: /img/{0}/bg

Цвета оформляются в HEX формате. Например, синий фон фокусной кнопки темы Stalker 5x - graphite имеет значение "#2c60c6".

Структура путей файлов

Все пакеты по умолчанию располагаются в каталоге stalker_launcher_apps .

После установки в этом каталоге появятся каталоги с именами пактов. В этих каталогах пакетов будут каталоги с их версиями, в которых и будут находится файлы приложений.

Пример полного пути к содержимому пакета для tv версии 1.2.4 : stalker_launcher_apps/magcore-app-tv/1.2.4 ,
где
magcore-app-tv- название пакета.

Базовая информация об иконках

Иконки приложений отображаются в главном меню, списке менеджера задач и при загрузке приложения.

Все иконки задекларированы в файле package.json пакета приложения.

Путь к иконкам по умолчанию относительно содержимого пакета: /app/img/{0}/normal.png .

Пример полного пути к иконкам: /stalker_launcher_apps/magcore-app-tv/1.0.6/img/720/normal.png .

Иконки имеют два состояния: обычное и активное (иконка в фокусе).

Размеры иконок для различных размеров экрана

Список доступных для брендирования элементов в главном меню:

1. Логотип.

2. Список категорий (стандартный набор категорий - Media, Apps, Games).

Пакет лаунчера называется magcore-app-launcher .

Файл конфигурации лаунчера находится по следующему пути: /stalker_launcher_apps/magcore-app-launcher/ текущая версия /app/config.json .

Для смены логотипа нужно положить в каталог img/{0}/ файл logo.png .

Если имя файла не подходит, в конфигурации надо изменить строчку img/{0}/logo.png на имя вашего файла.

Отображение приложений в главном меню, при изменении списка категорий, не гарантируется из-за возможного исчезновения целого набора соответствующей категории. Список содержится в поле "categories". Пример категории:

{
   "name": "Media",
   "icons": "img/{0}/icons/media.png"
}

где
name- имя категории, которое используется в нижнем регистре для сортировки приложений по этой категории (приложение с типом "media" попадет в этот набор).
icons- шаблонный путь к иконке приложения.

Существует два варианта применения собственной конфигурации:

1. В опциях пакета задать путь к конфигу. Опции пакета указываются в административной панели Ministra.

2. Заменить файл конфигурации лаунчера на свой.

Кастомизация иконок

Вариант 1

Замените иконки вручную. Путь к иконкам описан выше.

1. Добавьте собственное приложение со своими иконками. Для этого замените в стандартном приложении иконки на свои и опубликуйте под другими именем.

2. Удалите стандартное приложение.