3步完成轻量级动漫播放器Animius配置指南

功能概览

Animius是一款基于Kotlin开发的轻量化动漫播放应用，采用Jetpack Compose构建现代化界面，通过MVVM架构（Model-View-ViewModel）实现业务逻辑与UI分离。核心功能包括多数据源聚合、离线缓存下载、实时弹幕互动等，支持Exoplayer视频渲染和Retrofit网络请求，兼容Android 8.0及以上系统。

核心技术亮点

• 采用Clean Architecture分层设计，确保代码模块化
• 支持M3U8格式流媒体播放与断点续传
• 集成自定义弹幕引擎，支持透明度/速度调节
• 多源数据解析器，自动切换可用资源

常见误区提醒

混淆Jetpack Compose与传统XML布局，建议优先熟悉Compose声明式语法再进行二次开发

环境兼容性检测

系统要求

• 开发环境：Android Studio Flamingo或更高版本
• JDK版本：1.8+（推荐Amazon Corretto 11）
• Gradle版本：7.4+
• 最低支持Android版本：Android 8.0（API 26）
• 建议设备配置：2GB RAM+，支持OpenGL ES 3.0

💡 小贴士：通过SDK Manager安装Android 13（API 33）模拟器可获得最佳测试体验

兼容性列表

Android版本	支持情况	已知问题
Android 13	✅ 完全支持	无
Android 12	✅ 完全支持	无
Android 11	✅ 完全支持	无
Android 10	✅ 部分支持	弹幕动画偶发卡顿
Android 9	⚠️ 有限支持	部分视频格式不兼容

常见误区提醒

忽略Gradle版本兼容性，建议严格按照项目根目录gradle-wrapper.properties指定版本配置

分步实施

步骤1：获取项目代码

打开终端执行克隆命令：

git clone https://gitcode.com/gh_mirrors/an/Animius

💡 小贴士：国内用户可使用镜像加速：

git clone https://gitcode.com/gh_mirrors/an/Animius --depth=1

[建议配图：Android Studio项目导入界面]

步骤2：配置开发环境

1. 启动Android Studio，选择"Open"导入项目
2. 等待Gradle同步完成（首次同步需10-15分钟）
3. 安装缺失的SDK组件（通过右下角提示自动安装）

步骤3：依赖管理方案

在线配置（推荐）

确保网络通畅，Gradle会自动下载依赖：

./gradlew build

离线依赖包配置（无网络环境）

1. 从项目release页面下载offline-deps.zip
2. 解压至~/.gradle/caches/modules-2/
3. 执行离线构建命令：

./gradlew build --offline

💡 小贴士：离线包有效期为30天，建议定期更新

常见误区提醒

频繁切换在线/离线模式导致依赖冲突，建议保持一种模式完成构建

问题排查

构建失败解决方案

1. 依赖下载超时：配置Gradle镜像仓库

   // 在项目根目录build.gradle添加
   maven { url 'https://maven.aliyun.com/repository/google' }
   

2. NDK版本不匹配：在local.properties指定版本

   ndk.version=25.1.8937393
   

3. 内存溢出：修改gradle.properties

   org.gradle.jvmargs=-Xmx4g -XX:MaxPermSize=2g
   

功能验证要点

• 视频播放测试：确认image/player.jpg所示弹幕功能正常
• 下载功能测试：检查download_list.jpg中的缓存管理界面
• 多源切换测试：验证不同数据源标识（如Silisili/Mxdm）的内容加载

常见误区提醒

直接运行release变体导致调试功能缺失，建议开发阶段使用debug变体