Bangumi从入门到实践：轻量级ACG内容高效管理指南

Bangumi是一款基于React Native开发的轻量级第三方客户端，专为ACG爱好者设计，提供番组进度跟踪、用户空间管理和时间线记录等核心功能。作为bgm.tv的非官方应用，它通过移动端优化界面和增强功能，帮助动漫爱好者高效管理追番进度与内容收藏。

准备工作：开发环境检查

在开始安装前，请确保你的开发环境满足以下基础要求：

• Node.js（推荐最新稳定版）：JavaScript运行环境，用于执行项目构建脚本
• Git：版本控制工具，用于获取项目源码
• Android Studio/Xcode：分别用于Android和iOS平台的应用构建
• Java JDK（Android开发必需）：Java开发工具包，支持Android项目编译

⚠️ 注意：Windows用户需额外安装Android Studio的SDK Manager，并配置ANDROID_HOME环境变量

环境搭建：依赖获取与项目配置

1. 获取项目源码

使用Git克隆项目仓库到本地开发目录：

git clone https://gitcode.com/GitHub_Trending/ba/Bangumi
cd Bangumi

2. 安装核心依赖

项目使用Yarn作为包管理器，执行以下命令安装JavaScript依赖：

yarn

3. 平台特定配置

🔧 Android平台配置

cd android
./gradlew clean install
cd ..

🔧 iOS平台配置

cd ios
pod install
cd ..

功能验证：应用启动与基础操作

📱 Android应用启动

yarn android

📱 iOS应用启动

yarn ios

首次启动成功后，你将看到Bangumi的欢迎界面，此时可以：

1. 浏览推荐番组列表
2. 测试主题切换功能（支持明暗两种模式）
3. 尝试添加番组到"想看"列表

核心技术解析

核心框架

• React Native：跨平台移动应用开发框架，使用JavaScript构建原生UI
• Expo：React Native开发工具集，简化构建和部署流程
• MobX：状态管理库，实现响应式数据绑定
• TypeScript（JavaScript的静态类型扩展）：提供类型安全，减少运行时错误

辅助工具

• Gradle：Android项目构建工具
• CocoaPods：iOS依赖管理工具
• ESLint：代码质量检查工具
• Prettier：代码格式化工具

常见问题解决

依赖安装失败

如果yarn命令执行失败，尝试清除缓存后重试：

yarn cache clean
yarn

Android构建错误

确保Android SDK版本与项目要求一致（API 21+），可通过Android Studio的SDK Manager更新。

iOS模拟器启动问题

检查Xcode版本是否满足要求（建议Xcode 12.0+），并确保已安装对应iOS版本的模拟器。

通过以上步骤，你已成功搭建Bangumi的开发环境并完成基础功能验证。该项目的模块化架构和响应式设计，为进一步定制和扩展提供了良好基础。无论是日常追番管理还是二次开发学习，Bangumi都是ACG领域值得探索的优质开源项目。