# CodingLearn-Android

**Repository Path**: wu-jening/coding-learn-android

## Basic Information

- **Project Name**: CodingLearn-Android
- **Description**: 安卓课程学习App（前端+后端），包含登录、课程展示、学习统计等功能
- **Primary Language**: Kotlin
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-09
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Android, Kotlin, SpringBoot, 课程学习

## README

# CodingLearn - 安卓课程学习App

## 项目介绍
一款面向编程学习者的安卓App，集成课程展示、学习进度跟踪、用户登录、积分体系、学习统计等核心功能，支持前后端分离架构，后端提供RESTful API接口，前端适配安卓14+系统。

## 技术栈
### 前端（Android）
- 开发工具：Android Studio 2025.1.3
- 开发语言：Kotlin（主力）+ Java（兼容）
- 核心框架/库：
  - Jetpack组件：DataStore（登录状态存储）、Lifecycle（生命周期管理）、ViewBinding（视图绑定）、Coroutines（协程）
  - 网络请求：Retrofit + OkHttp（RESTful API调用）
  - UI组件：Material Design 3、RecyclerView（列表展示）、CardView
  - 其他：Gson（JSON解析）、Parcelable（数据传递）
- 最低兼容版本：Android 14（API 34）

### 后端  链接：https://gitee.com/wu-jening/coding-learn-backend
- 开发工具：IntelliJ IDEA 2024.3.3
- 开发语言：Java
- 核心框架：Spring Boot（2.7.x）
- 数据存储：MySQL（8.0+）
- 接口规范：RESTful API
- 其他：MyBatis（ORM）、Lombok（简化代码）

## 功能列表
### 核心功能
1. 用户模块：登录/注册、退出登录、用户信息展示
2. 课程模块：课程列表展示、课程详情、章节列表、学习进度跟踪
3. 学习统计：学习时长、连续学习天数、积分体系、成就系统
4. 个人中心：用户资料、积分记录、退出登录

## 运行步骤
### 前端（Android）
1. 环境准备：
   - 安装Android Studio 2025.1.3
   - 配置Android SDK 34（或更高）
   - 模拟器/真机（Android 14+）
2. 操作步骤：
   - 克隆仓库：`git clone https://gitee.com/你的用户名/CodingLearn-Android.git`
   - 打开Android Studio，选择「Open」→ 导入克隆的项目
   - 等待Gradle同步完成（首次同步可能需要下载依赖）
   - 修改后端接口地址：在`RetrofitClient.kt`中修改`BASE_URL`为你的后端服务地址（本地测试用`http://10.0.2.2:8080`，真机用后端IP）
   - 点击「Run」（绿色三角），选择模拟器/真机运行

### 后端
1. 环境准备：
   - 安装IntelliJ IDEA 2024.3.3
   - 安装JDK 1.8+/17（推荐17）
   - 安装MySQL 8.0+
   - 配置Maven/Gradle
2. 操作步骤：
   - 克隆仓库：`git clone https://gitee.com/你的用户名/CodingLearn-Backend.git`
   - 打开IDEA，导入后端项目
   - 配置数据库：修改`application.yml`中的数据库地址、用户名、密码
   - 创建数据库：在MySQL中执行`CREATE DATABASE coding_learn;`（数据库名和配置文件一致）
   - 运行后端项目：点击IDEA的「Run」按钮，启动Spring Boot应用
   - 验证接口：访问`http://localhost:8080/api/courses`，能返回JSON数据则启动成功

## 项目结构（前端）
com.example.codinglearn/
├── data/ # 数据层：DataStore 存储、Repository
├── model/ # 实体类：User、Course、LoginRequest 等
├── network/ # 网络层：RetrofitClient、API 接口
├── ui/ # 界面层：
│ ├── auth/ # 登录 / 注册界面
│ ├── main/ # 主界面（底部导航 + Fragment）
│ ├── home/ # 首页（课程列表）
│ ├── learn/ # 学习页（我的课程）
│ ├── profile/ # 个人中心
├── utils/ # 工具类：Validator、AnimationUtils 等
└── CodingLearnApp.kt # 应用入口

## 常见问题
1. 网络请求失败：检查后端是否启动、接口地址是否正确、模拟器/真机是否能访问后端IP；
2. Gradle同步失败：检查Android Studio的Gradle版本、网络（需下载依赖）；
3. 数据库连接失败：检查MySQL服务是否启动、配置文件中的用户名/密码是否正确；
4. 登录状态不生效：确认DataStore的`saveLoginState`方法是否正确调用，退出登录是否执行`clearLoginState`。

## 作者信息
- 作者：
- 邮箱：
- 备注：本项目为学习用途，仅供参考