# 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**: 3
- **Created**: 2025-11-18
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Heimayun Music Player

## Project Introduction
Heimayun Music is a music player application developed based on HarmonyOS. It's a replica version that provides music playback, collection, playlist management and other features, adopting modern UI design and smooth user experience.

## Technology Stack
- **Development Framework**: HarmonyOS SDK
- **Programming Language**: TypeScript/ARKTS
- **UI Framework**: ArkUI
- **Build Tool**: Hvigor
- **Package Manager**: Ohpm

## Project Structure
```
├── .gitignore           # Git ignore file configuration
├── AppScope/            # Application global configuration
│   ├── app.json5        # Application configuration file
│   └── resources/       # Global resource files
├── entry/               # Main entry module
│   ├── src/main/        # Source code directory
│   │   ├── ets/         # ETS business code
│   │   └── resources/   # Module resource files
│   ├── build-profile.json5  # Module build configuration
│   └── hvigorfile.ts    # Module build script
├── hvigor/              # Hvigor build tool configuration
├── build-profile.json5  # Project build configuration
└── oh-package.json5     # Project dependency configuration
```

## Software Architecture
- **Modular Design**: Adopts HarmonyOS modular architecture, dividing functionality into different modules
- **Component-based Development**: Builds reusable UI components based on ArkUI componentization ideas
- **MVC/MVVM Pattern**: Follows modern frontend development patterns to separate data and view
- **Resource Management**: Unified resource management mechanism supporting multi-device adaptation

## Installation and Running

### Environment Requirements
- DevEco Studio 4.0+ 
- HarmonyOS SDK 3.1.0+ 
- Node.js 16.x+
- Ohpm package manager

### Installation Steps
1. Clone this repository: `git clone https://gitee.com/xmmb/heimayun.git`
2. Open the project with DevEco Studio
3. Configure HarmonyOS SDK and development environment
4. Execute `ohpm install` to install project dependencies
5. Compile and run the project on HarmonyOS simulator or physical device

## Features
- Music playback (play/pause/previous/next)
- Playlist management
- Music collection and favorite functions
- Playback progress control and volume adjustment
- Sound quality settings
- Dark/light theme switching
- Multi-device adaptive interface

## Usage Instructions
1. After launching the application, browse recommended music on the home page
2. Click on a song to enter the playback interface
3. Use the bottom playback bar to quickly control playback status
4. Access different functional modules through the sidebar or bottom navigation

## Contribution Guidelines
1. Fork this repository
2. Create a Feat_xxx branch
3. Ensure code passes code inspection before submission
4. Submit a Pull Request to the main branch

## Development Standards
- Code style follows ESLint standards
- Commit messages use standard Git commit message format
- New feature development requires adding corresponding unit tests
- UI design should follow HarmonyOS design specifications

## License
This project is licensed under the MIT License - see the LICENSE file for details