Bangumi 追番客戶端安裝配置指南從零到雙平臺(tái)可運(yùn)行【免費(fèi)下載鏈接】Bangumi:electron: An unofficial https://bgm.tv ui first app client for Android and iOS, built with React Native. 一個(gè)無廣告、以愛好為驅(qū)動(dòng)、不以盈利為目的、專門做 ACG 的類似豆瓣的追番記錄bgm.tv 第三方客戶端。為移動(dòng)端重新設(shè)計(jì)內(nèi)置大量加強(qiáng)的網(wǎng)頁(yè)端難以實(shí)現(xiàn)的功能且提供了相當(dāng)?shù)淖远x選項(xiàng)。 目前已適配 iOS / Android。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ba/Bangumi新番季一開場(chǎng)散落在瀏覽器書簽和手機(jī)筆記里的追番清單總需要收攏到一個(gè)地方。Bangumi 是 bgm.tv 的第三方客戶端以統(tǒng)一的形式記錄動(dòng)畫、音樂、日劇與游戲等二次元條目并基于 React Native 為 Android 與 iOS 重新設(shè)計(jì)了界面。本文按“準(zhǔn)備、落地、構(gòu)建、維護(hù)”四個(gè)階段展開帶你把項(xiàng)目從空環(huán)境跑到真機(jī)可交互。環(huán)境體檢前置軟件清單構(gòu)建前先核對(duì)工具鏈。Android 與 iOS 的差異集中在原生工程一側(cè)Node 側(cè)兩者一致。平臺(tái)軟件用途雙端Node.jsLTS 版 Git運(yùn)行腳本、拉取代碼雙端Yarn安裝依賴官方要求npm 版本解析易出偏差安卓JDK注意是 JDKJRE 不行Gradle 原生打包安卓watchman監(jiān)聽文件變更缺失會(huì)報(bào)“監(jiān)聽文件過多”安卓Android Studio USB 調(diào)試連接真機(jī)部署iOSmacOS Xcode Expo 客戶端調(diào)試與簽名運(yùn)行npm 源保持官方 registry。項(xiàng)目說明中明確提示淘寶鏡像在跑環(huán)境時(shí)可能提示不允許代理遇到此類報(bào)錯(cuò)先換源再排查其他因素。快速落地源碼克隆與依賴安裝拉取倉(cāng)庫(kù)并進(jìn)入目錄git clone https://gitcode.com/GitHub_Trending/ba/Bangumi cd Bangumi該項(xiàng)目把依賴拆分為 iOS、安卓、Web 三套環(huán)境由 packages/env.js 統(tǒng)一管理不要在根目錄直接裝包。先切到目標(biāo)環(huán)境目錄安裝cd packages/ios # 安卓開發(fā)則進(jìn)入 packages/android yarn再回到根目錄切換開發(fā)環(huán)境yarn env iospostinstall階段會(huì)自動(dòng)執(zhí)行 patch-package把 patches/ 下的補(bǔ)丁打到依賴上。三套環(huán)境的目錄結(jié)構(gòu)與補(bǔ)丁歸屬見 packages/README.md。雙平臺(tái)構(gòu)建安卓與 iOS 構(gòu)建命令差異兩套原生工程各自獨(dú)立命令與入口如下表。項(xiàng)目安卓iOS環(huán)境切換yarn env androidyarn env ios依賴目錄packages/android/packages/ios/原生工程android/Gradleios/CocoaPods調(diào)試方式Metro USB 真機(jī)Expo 客戶端 Xcode排障起手式./gradlew clean重新pod install安卓打包前先進(jìn)入工程目錄清理一次cd android ./gradlew cleaniOS 側(cè)先同步 Pods再打開ios/Bangumi.xcworkspace用 Xcode 運(yùn)行cd ios pod install安卓真機(jī)需開啟開發(fā)者調(diào)試模式并授予應(yīng)用安裝權(quán)限與懸浮窗權(quán)限gradle 依賴緩存只有 24 小時(shí)偶發(fā)的read timeout多為網(wǎng)絡(luò)波動(dòng)重試即可。啟動(dòng)與驗(yàn)證跑通后的預(yù)期結(jié)果根目錄執(zhí)行yarn dev啟動(dòng) Expo 服務(wù)。iOS 用 Expo 客戶端掃終端二維碼安卓通過 USB 連接后自動(dòng)加載調(diào)試包。驗(yàn)證按這個(gè)順序走啟動(dòng)頁(yè) → 登錄 bgm.tv 賬號(hào) → 把一部動(dòng)畫加入追番清單 → 更新一集進(jìn)度。進(jìn)度能落庫(kù)并回顯說明登錄、記錄、CDN 緩存三條鏈路全部打通。故障快排常見構(gòu)建報(bào)錯(cuò)條目spawnSync adb ENOENTadb 不在 PATH 中把 Android SDK 的 platform-tools 目錄加入環(huán)境變量。Gradle 拉包失敗或read timeout依賴緩存過期網(wǎng)絡(luò)恢復(fù)后執(zhí)行./gradlew clean重試?！氨O(jiān)聽文件過多”類報(bào)錯(cuò)安裝 watchman 后重跑。Apple 芯片上打包失敗核對(duì) JDK 版本JRE 無法替代。postinstall補(bǔ)丁應(yīng)用失敗對(duì)照 packages/README.md 檢查 patches/ 目錄下的補(bǔ)丁符號(hào)鏈接是否完整。進(jìn)階玩法主題定制與數(shù)據(jù)同步外觀主題狀態(tài)集中在 src/stores/theme/登錄后可在應(yīng)用內(nèi)設(shè)置項(xiàng)調(diào)整深淺色與自定義配色。設(shè)置頁(yè)界面實(shí)現(xiàn)位于 src/screens/user/setting/含賬號(hào)安全、CDN 服務(wù)、隱私等分組。數(shù)據(jù)同步bgm.tv 賬號(hào)是單一數(shù)據(jù)源同一賬號(hào)在兩臺(tái)設(shè)備登錄即共享追番記錄無需手動(dòng)遷移。版本說明每個(gè)版本的圖文更新記錄維護(hù)在 web/CHANGELOG.MD排查行為差異前先查這里。項(xiàng)目脈搏活躍度與維護(hù)狀態(tài)倉(cāng)庫(kù)最近一次提交在 2026 年 9 月 24 日處于持續(xù)維護(hù)狀態(tài)。項(xiàng)目自 2019 年前后開始開發(fā)倉(cāng)庫(kù)內(nèi)保留有 2019 至 2022 各年的年鑒素材頁(yè)面數(shù)量超過 100基本覆蓋 bgm.tv 網(wǎng)站全部頁(yè)面。多環(huán)境補(bǔ)丁體系下安卓環(huán)境維護(hù) 7 個(gè)依賴補(bǔ)丁iOS 環(huán)境維護(hù) 3 個(gè)均在 packages/ 內(nèi)統(tǒng)一管理。收尾建議首次運(yùn)行成功后選一部當(dāng)季動(dòng)畫加入追番清單并更新一集進(jìn)度。這個(gè)動(dòng)作會(huì)一次性驗(yàn)證賬號(hào)登錄、進(jìn)度記錄與 CDN 緩存比逐項(xiàng)點(diǎn)功能菜單更能確認(rèn)環(huán)境搭建無誤。更多項(xiàng)目背景與功能說明見倉(cāng)庫(kù)根目錄 README.MD?！久赓M(fèi)下載鏈接】Bangumi:electron: An unofficial https://bgm.tv ui first app client for Android and iOS, built with React Native. 一個(gè)無廣告、以愛好為驅(qū)動(dòng)、不以盈利為目的、專門做 ACG 的類似豆瓣的追番記錄bgm.tv 第三方客戶端。為移動(dòng)端重新設(shè)計(jì)內(nèi)置大量加強(qiáng)的網(wǎng)頁(yè)端難以實(shí)現(xiàn)的功能且提供了相當(dāng)?shù)淖远x選項(xiàng)。 目前已適配 iOS / Android。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ba/Bangumi創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考