دليل المطورين

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
  • تأكد من إرسال application/json لملف JSON

كيفية إضافة المستودع للمستخدمين

  1. افتح TrollFools
  2. اضغط على أيقونة "+" بجانب زر التحديث
  3. أدخل رابط المستودع (بدون /trollpackages.json)
  4. مثال: https://trollfools.example.com

أفضل المقاييس عزيزي المطور

  1. أيقونات عالية الجودة: استخدم أيقونات 512x512 بكسل
  2. أوصاف واضحه: اكتب أوصاف مفيدة ومفصلة
  3. أحجام دقيقه: حدد أحجام الملفات بدقة
  4. روابط صحيحه: تأكد من صحة جميع الروابط
  5. تحديثات منتظمه: حافظ على تحديث المستودع

اختبار المستودع

تأكد من:

  • إمكانية الوصول لملف trollpackages.json
  • صحة تنسيق JSON
  • عمل جميع روابط الملفات
  • وجود أيقونات المستودع والحزم
  • صحة المعلومات المدخله

نشر المستودع

  1. رفع جميع الملفات للخادم
  2. اختبار الوصول للمستودع
  3. مشاركة رابط المستودع مع المستخدمين