MyBookshelf零基础入门指南：从项目探秘到核心架构解析

【项目探秘】揭开开源阅读神器的面纱

💡 实用提示：建议先通过git clone https://gitcode.com/gh_mirrors/my/MyBookshelf获取完整项目，配合文件管理器同步对照学习。

1.1 目录结构可视化：核心文件夹功能定位

MyBookshelf/
├── app/                 # 应用主引擎（包含所有业务逻辑）
│   ├── src/main/        # 核心源码目录
│   │   ├── assets/      # 静态资源仓库（阅读背景/书源数据）
│   │   ├── java/        # 业务代码区（Activity👉应用界面组件/逻辑处理）
│   │   └── res/         # 资源配置中心（界面布局/图标/字符串）
│   └── AndroidManifest.xml # 应用身份证（权限声明/组件注册）
├── basemvplib/          # 基础框架库（MVP架构核心组件）
├── gradle/              # 构建工具配置（自动化编译脚本）
└── tool/                # 辅助工具箱（书源管理工具）

[!TIP] 重点关注app/src/main/assets/data/BookSourceXxl.json，这是自定义书源的关键配置文件。

1.2 关键文件定位技巧

功能需求	对应文件路径	核心作用
应用入口	app/src/main/java/com/kunfei/bookshelf/view/activity/MainActivity.java	启动第一个界面
阅读背景	app/src/main/assets/bg/	存放16种预设阅读背景图
网络权限	app/src/main/AndroidManifest.xml	声明INTERNET等系统权限
构建配置	app/build.gradle	管理依赖库版本和编译参数

【核心组件解析】读懂应用的"五脏六腑"

💡 实用提示：理解组件间关系可先从MainActivity入手，顺着setContentView()方法找到对应布局文件。

2.1 启动流程揭秘：应用如何"苏醒"

用户点击图标
    ↓
Android系统解析AndroidManifest.xml
    ↓
找到<intent-filter>中MAIN类别
    ↓
启动MainActivity（com.kunfei.bookshelf.view.activity.MainActivity）
    ↓
执行onCreate()方法
    ↓
加载activity_main.xml布局
    ↓
初始化书架数据并展示

[!WARNING] 修改启动Activity需同步更新AndroidManifest.xml中的配置，否则会导致应用无法启动。

2.2 配置文件必改项与优化参数

AndroidManifest.xml关键配置

参数	必改性	优化建议
android:allowBackup	建议修改	设为false防止数据泄露
android:icon	可选修改	替换为自定义应用图标
	按需添加	仅保留必要权限（如INTERNET）

build.gradle性能优化

android {
    compileSdk 33  // 使用最新SDK版本
    defaultConfig {
        minSdk 23    // 最低支持Android 6.0
        targetSdk 33 // 目标SDK版本
        versionCode 2 // 版本号自增
    }
    // 启用R8代码混淆
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

【快速上手】3步跑通开发环境

💡 实用提示：首次编译可能需要下载依赖，请确保网络通畅并耐心等待Gradle同步完成。

3.1 环境准备：开发工具配置

1. 安装Android Studio Electric Eel或更高版本
2. 配置JDK 11环境（项目默认依赖）
3. 克隆项目：git clone https://gitcode.com/gh_mirrors/my/MyBookshelf
4. 打开项目并等待Gradle同步完成

3.2 启动调试：一键运行应用

1. 连接Android设备或启动模拟器
2. 在Android Studio中点击▶️ Run按钮
3. 首次启动会自动安装调试版APK
4. 等待应用加载完成，初始界面如图所示：

3.3 个性化定制：修改阅读背景

1. 准备1080x2340分辨率的图片
2. 命名为custom_bg.jpg
3. 复制到app/src/main/assets/bg/目录
4. 在应用设置中选择新添加的背景

[!TIP] 背景图片建议使用低饱和度色彩，减轻长时间阅读的视觉疲劳。

通过以上三个模块的学习，你已经掌握了MyBookshelf的核心架构和开发入门技巧。接下来可以尝试修改书源配置文件，添加自定义阅读源，开启你的个性化阅读之旅。