開發與發布自己的來源

01開始前需要的能力

• Kotlin 與 Gradle／Android 專案建置。
• HTTP 請求、狀態碼、header、cookie 與登入流程。
• HTML 結構、CSS selector 與網頁解析。
• 目標服務的使用條款、存取權與合理請求頻率。

02來源套件需要負責什麼？

來源套件不是漫畫資料檔；它是可執行的連接器。一般會負責以下流程：

1. 1目錄與搜尋。回傳熱門、最新、搜尋結果與下一頁資訊。
2. 2作品與章節。提供標題、封面、說明、狀態、章節清單與穩定識別資料。
3. 3閱讀頁面。依正確順序回傳每一頁，並處理必要的 request header。
4. 4可選設定。若服務需要登入、mirror 或其他選項，提供清楚且不洩漏敏感資料的設定欄位。

03透過 Repository 發布

建置完成後會得到 APK。MangaFuru 不是直接讀取你的 Kotlin 原始碼，而是從 Repository index 找到套件資訊，再下載 APK。傳統 Repository 通常使用以下結構：

repo/
├── index.min.json
├── apk/
│   └── example-source-v1.0.1.apk
└── icon/
    └── com.example.source.png

網站需能透過 HTTPS 公開讀取 index、APK 與 icon。檔名大小寫與 index 內容必須完全一致。

04最小索引資料

index.min.json 是套件索引，不是內容目錄。以下是用虛構資料表示的傳統格式：

[
  {
    "name": "Example Source",
    "pkg": "com.example.source",
    "apk": "example-source-v1.0.1.apk",
    "lang": "en",
    "code": 1,
    "version": "1.6.1",
    "nsfw": 0,
    "sources": [
      {
        "name": "Example Source",
        "lang": "en",
        "id": "123456789",
        "baseUrl": "https://example.com"
      }
    ]
  }
]

• pkg 是套件的穩定安裝識別，不要在更新時隨意更換。
• code 必須在每次發布更新時遞增。
• sources[].id 必須保持穩定，否則既有書庫可能無法對回原來源。
• apk 必須對應 apk/ 內實際存在的檔案。

05不要只確認「可以建置」

來源在 Android 工具鏈中成功產生 APK，不代表一定能在 MangaFuru 的 iOS 執行環境完整運作。發布前至少逐層驗證：

1. 1Repository 可載入。用完整 HTTPS index URL 加入，確認套件會顯示。
2. 2來源可安裝。確認 APK 能下載、轉換、載入，且來源出現在「探索」。
3. 3完整閱讀流程可用。逐一測試熱門、最新、搜尋、作品詳情、章節與實際頁面。
4. 4更新不破壞既有資料。提高版本後再次安裝，確認穩定 ID、書庫與續讀仍能對應。

一般使用者的加入與管理步驟請見 Repository 與外部來源。