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