开发者指南

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. 与用户分享存储库链接