Skip to content

Структура паков

Andrey Skobtsov edited this page Mar 15, 2023 · 1 revision

Каждый пак для TL представляет из себя zip архив с расширением .tl. Изменённое расширение нужно, чтобы можно было удобнее устанавливать паки в андроид приложение. Если хочется изменить пак вручную, то можно либо открыть архиватором .tl файл, либо изменить расширение с .tl на .zip, и уже после этого открыть архиватором. Результат будет одинаковый.

Внутри zip архива можно увидеть следующую структуру:

  • Authors - содержит иконки авторов.
    • Поддерживаются форматы: .gif, .png, .webp, .jpg
    • Предпочтительный формат для анимаций - .gif
    • Предпочтительный формат для статичных изображений - .webp без потери качества
  • Modified - содержит изменяемые файлы
  • Previews - содержит изображения для показа на странице информации о паке
    • Поддерживаются форматы: .png, .jpg, .webp, .gif
    • Предпочтительный формат для анимаций - .gif
    • Предпочтительный формат для статичных изображений - .webp с потерей качества (меньше места занимает)
  • Icon.gif/Icon.png/Icon.webp - иконка пака
    • Предпочтительный формат для анимаций - .gif
    • Предпочтительный формат для статичных изображений - .webp без потери качества
  • Settings.json - информация о паке

Структура Settings.json:

{
    "packStructureVersion": 23, # <число> - версия структуры пака. Нужна для обозначения поддержи тех или иных функций
    "title": "Example name", # <строка> - название пака. Показывается в онлайн и офлайн списках
    "guid": "11111111-2222-3333-4444-555555555555", # <строка формата guid/uuid> - идентификатор пака. Все паки должны иметь уникальный `guid`
    "descriptionRussian": "Супер классный пак", # <строка> - описание пака на русском
    "descriptionEnglish": "Super cool pack", # <строка> - описание пака на английском
    "authors": [
        {
            "file": "1.png", # <строка> - путь до иконки автора в папке `Authors`
            "name": "Author name", # <строка> - имя автора, которое будет отображаться на странице информации о паке
            "color": "#ff9c2121", # <строка формата #aarrggbb> - строка с цветом argb (alpha, red, green, blue) в шестнадцатеричном виде
            "link": "https://somecoolsitefortheauthor.com", # <строка> - ссылка на страницу автора. При нажатии на автора в приложении откроется браузер на этой странице
            "icon_height": 70 # необязательное <число в диапазоне от 70 до 110> - позволяет увеличить иконку автора. Полезно в случае больших иконок, чтобы название автора было по центру по вертикали
        }
    ], # <массив авторов> - информация об авторах пака
    "version": 1, # <число> - версия пака. Нужна для обновления паков с помощью сервера
    "predefined_tags": [
        1
    ] # <массив чисел> - список тегов для пака, по которым можно фильтровать на странице с паками
}