# simple music

**Repository Path**: yangeliu/simple-music

## Basic Information

- **Project Name**: simple music
- **Description**: 一个简单的音乐播放器
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-20
- **Last Updated**: 2026-04-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Simple Music (简单音乐)

一个基于鸿蒙系统（HarmonyOS）开发的简单音乐播放器应用。

## 项目简介

Simple Music 是一个功能完善的音乐播放器应用，采用鸿蒙系统原生开发框架构建。应用提供了音乐播放、搜索、收藏推荐等核心功能，为用户带来流畅的音乐体验。

## 功能特性

- **音乐播放** - 支持播放音乐，提供播放控制栏
- **搜索功能** - 搜索喜欢的音乐
- **收藏管理** - 管理个人收藏的音乐
- **个性化推荐** - 根据用户偏好推荐音乐

## 技术栈

- **框架**：HarmonyOS
- **开发语言**：eTS (extended TypeScript)
- **UI框架**：ArkUI
- **构建工具**：Hvigor

## 项目结构

```
entry/
├── src/main/ets/
│   ├── components/       # UI组件
│   │   ├── MusicItem.ets     # 音乐项组件
│   │   └── PlayerBar.ets     # 播放控制栏组件
│   ├── pages/            # 页面
│   │   ├── Index.ets         # 首页
│   │   ├── PlayerPage.ets    # 播放页面
│   │   ├── SearchPage.ets    # 搜索页面
│   │   ├── FavoritePage.ets  # 收藏页面
│   │   └── RecommendPage.ets # 推荐页面
│   ├── model/            # 数据模型
│   │   └── Type.ets
│   ├── service/          # 服务层
│   │   └── MusicService.ets  # 音乐服务
│   ├── utils/            # 工具类
│   │   └── req.ets           # 网络请求
│   ├── entryability/     # 入口能力
│   │   └── EntryAbility.ets
│   └── entrybackupability/ # 备份能力
│       └── EntryBackupAbility.ets
└── src/main/resources/   # 资源文件
```

## 快速开始

### 环境要求

- HarmonyOS SDK
- DevEco Studio
- Node.js

### 安装部署

1. 克隆项目到本地
2. 使用 DevEco Studio 打开项目
3. 连接HarmonyOS设备或模拟器
4. 构建并运行项目

### 构建命令

```bash
# 安装依赖
ohpm install

# 构建项目
hvigor build
```

## 页面说明

| 页面 | 功能描述 |
|------|----------|
| Index | 应用首页，展示音乐列表 |
| PlayerPage | 音乐播放详情页面 |
| SearchPage | 音乐搜索功能 |
| FavoritePage | 收藏的音乐列表 |
| RecommendPage | 个性化音乐推荐 |

## 贡献指南

欢迎提交 Issue 和 Pull Request，共同完善该项目。

## 许可证

本项目仅供学习交流使用。