Руководство разработчика

TrollFools Repository Guide

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

Требования к репозиторию

Для создания совместимого с TrollFools репозитория вам нужно:

Веб-сервер
  • Поддержка HTTPS
ملف trollpackages.json
  • В корневой папке
Файлы пакетов
  • .dylib, .zip, .deb

Структура репозитория

Структура папок
your-repository.com/
├── trollpackages.json
├── icons/
│   ├── tweak1-icon.png
│   └── tweak2-icon.png
├── downloads/
│   ├── tweak1.dylib
│   ├── tweak2.zip
│   └── tweak3.deb
├── screenshots/
│   ├── tweak1-screenshot1.png
│   └── tweak1-screenshot2.png
└── repo-icon.png

Формат файла trollpackages.json

JSON Structure
{
  "repository_name": "اسم مستودعك",
  "repository_icon": "https://yoursite.com/repo-icon.png",
  "packages": [
    {
      "name": "اسم الحزمه",
      "version": "v1.0.0",
      "description": "وصف مفصل للحزمه وميزاتها",
      "app_url": "رابط التطبيق اذا كانت الاداه تعمل على تطبيق معين",
      "bundle": "بندل التطبيق للحقن التلقائي",
      "icon_url": "https://yoursite.com/icons/package-icon.png",
      "dylib": "https://yoursite.com/downloads/package.dylib",
      "section": "قسم الحزمه",
      "size": "حجم الملف",
      "author": "اسم المطور",
      "screenshots": [
        "https://yoursite.com/screenshots/screenshot1.png",
        "https://yoursite.com/screenshots/screenshot2.png"
      ]
    }
  ]
}

Обязательные и необязательные поля

Поля репозитория
  • repository_name Обязательно: Имя репозитория
  • repository_icon Необязательно: Иконка репозитория
  • packages Обязательно: Массив пакетов
Поля пакета
  • name Обязательно: Имя пакета
  • version Обязательно: Версия пакета
  • description Обязательно: Описание пакета
  • app_url Необязательно: Ссылка на приложение, если инструмент предназначен для определенного приложения
  • bundle Необязательно: Пакет приложения для автоматической инъекции
  • dylib Обязательно: Ссылка на файл пакета
  • icon_url Необязательно: Иконка пакета
  • section Необязательно: Раздел пакета
  • size Необязательно: Размер файла
  • author Необязательно: Имя разработчика
  • screenshots Необязательно: Скриншоты пакета

Поддерживаемые типы файлов

.dylib: دايليب .zip: ملف مضغوط .deb: حزمة ديبيان

Требования к серверу

HTTPS
  • Сервер должен поддерживать HTTPS
CORS
  • Убедитесь, что запросы CORS не блокируются
Content-Type
  • Убедитесь, что для JSON файла отправляется application/json

Как добавить репозиторий для пользователей

  1. Откройте TrollFools
  2. Нажмите значок "+" рядом с кнопкой обновления
  3. Введите URL репозитория (без /trollpackages.json)
  4. Пример: https://trollfools.example.com

Лучшие практики дорогой разработчик

  1. Высококачественные иконки: Используйте иконки 512x512 пикселей
  2. Четкие описания: Пишите полезные и подробные описания
  3. Точные размеры: Точно указывайте размеры файлов
  4. Правильные ссылки: Убедитесь, что все ссылки действительны
  5. Регулярные обновления: Поддерживайте репозиторий в актуальном состоянии

Тестировать репозиторий

Убедитесь в:

  • Доступность файла trollpackages.json
  • Действительность формата JSON
  • Работе всех файловых ссылок
  • Доступности иконок репозитория и пакетов
  • Правильности введенной информации

Опубликовать репозиторий

  1. Загрузите все файлы на сервер
  2. Протестируйте доступ к репозиторию
  3. Поделитесь ссылкой на репозиторий с пользователями