# heimayun

**Repository Path**: dev_gitee/heimayun

## Basic Information

- **Project Name**: heimayun
- **Description**: 黑马云音乐 复刻版 
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-11-18
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 黑马云音乐 (heimayun)
## 嘎嘎嘎
### 点点star

## 项目介绍
黑马云音乐是基于HarmonyOS开发的音乐播放器应用复刻版，提供音乐播放、收藏、歌单管理等功能，采用现代化UI设计和流畅的用户体验。

## 技术栈
- **开发框架**: HarmonyOS SDK
- **编程语言**: TypeScript/ARKTS
- **UI框架**: ArkUI
- **构建工具**: Hvigor
- **包管理**: Ohpm

## 项目结构
```
├── .gitignore           # Git忽略文件配置
├── AppScope/            # 应用全局配置
│   ├── app.json5        # 应用配置文件
│   └── resources/       # 全局资源文件
├── entry/               # 主入口模块
│   ├── src/main/        # 源代码目录
│   │   ├── ets/         # ETS业务代码
│   │   └── resources/   # 模块资源文件
│   ├── build-profile.json5  # 模块构建配置
│   └── hvigorfile.ts    # 模块构建脚本
├── hvigor/              # Hvigor构建工具配置
├── build-profile.json5  # 项目构建配置
└── oh-package.json5     # 项目依赖配置
```

## 软件架构
- **模块化设计**: 采用HarmonyOS模块化架构，将功能划分为不同模块
- **组件化开发**: 基于ArkUI组件化思想，构建可复用UI组件
- **MVC/MVVM模式**: 遵循现代前端开发模式，实现数据与视图分离
- **资源管理**: 统一的资源管理机制，支持多设备适配

## 安装与运行

### 环境要求
- DevEco Studio 4.0+ 
- HarmonyOS SDK 3.1.0+ 
- Node.js 16.x+
- Ohpm包管理器

### 安装步骤
1. 克隆本仓库: `git clone https://gitee.com/xmmb/heimayun.git`
2. 使用DevEco Studio打开项目
3. 配置HarmonyOS SDK和开发环境
4. 执行`ohpm install`安装项目依赖
5. 编译并运行项目到HarmonyOS模拟器或真机

## 功能特性
- 音乐播放（播放/暂停/上一曲/下一曲）
- 播放列表管理
- 音乐收藏与喜欢功能
- 播放进度控制与音量调节
- 音质设置选项
- 深色/浅色主题切换
- 多设备适配界面

## 使用说明
1. 启动应用后，进入首页浏览推荐音乐
2. 点击歌曲进入播放界面
3. 使用底部播放栏快速控制播放状态
4. 通过侧边栏或底部导航进入不同功能模块

## 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码前请确保通过代码检查
4. 提交 Pull Request 到主分支

## 开发规范
- 代码风格遵循ESLint标准
- 提交信息使用规范的Git提交信息格式
- 新功能开发需添加相应的单元测试
- UI设计需遵循HarmonyOS设计规范

## 许可证
本项目采用MIT许可证 - 详情请查看LICENSE文件