拖放要檢查的 .XAPK、.APKS 或 .APK 文件
或點擊從您的裝置瀏覽
即時客戶端樹檢查 • 驗證manifest.json 和OBB 路徑XAPK 驗證引擎的工作原理
當 XAPK 安裝程式報告 “XAPK 檔案驗證失敗” 或 “損壞的 XAPK 檔案” 時,失敗幾乎總是源自於宣告式 manifest.json 檔案與容器內的實際 ZIP 條目之間的不符。
- 拆分 APK 存在審核: 驗證 split_apks[] 中列出的每個條目實際上存在於存檔的根目錄中且非空。
- OBB擴充路徑檢查: 確認每個 expansions[] 條目(例如 Android/obb/<pkg>/main.*.obb)與確切的內部 ZIP 路徑相符。
- 零上傳擷取: 一鍵直接從容器下載任何單獨的 .apk、.obb、.so 函式庫或 icon.png。
診斷「XAPK 檔案驗證失敗」並檢查 XAPK 清單
每個相容的 .xapk 套件在 ZIP 檔案的根目錄中都包含一個名為 manifest.json 的 UTF-8 JSON 檔案。專用的 XAPK 安裝程式在接觸單一 APK 或 OBB 檔案之前會讀取此描述符。根據封裝是 OBB 遊戲捆綁包(XAPK 架構 v1) 還是 拆分 APK 捆綁包(XAPK 架構 v2),manifest.json 定義了嚴格的結構規則:
- xapk_version(1 或 2): 版本 1 套件包含一個單片 <package_name>.apk 以及一個指向 Android/obb/ 資產的 expansions 陣列。版本 2 軟體包包含列出 base.apk 和設定拆分(config.arm64_v8a.apk、config.xxhdpi.apk)的 split_apks 陣列。
- 為什麼手機驗證失敗: 如果瀏覽器下載在 98% 時中斷,或者有人手動從 ZIP 中刪除了語言拆分,而沒有從 manifest.json 的 split_apks 數組中刪除其物件條目,或者如果 total_size 與解壓縮條目大小的總和不同,則安裝程式會立即中止並顯示 。 “XAPK 檔案驗證失敗”
- 如何修復失敗的 XAPK 套件: 將檔案放入上面的驗證器中。如果所有必要的 base.apk 和架構分割都完好無損,即使 manifest.json 的位元組數不匹配,您也可以透過將分割合併到我們的 XAPK 轉 APK 線上轉換器 上的獨立 .apk 來完全繞過嚴格的清單檢查,或使用我們的 XAPK生成器 重新包裝一個新的、。