# HarmonyOSWanAndroid

**Repository Path**: ccxb/HarmonyOSWanAndroid

## Basic Information

- **Project Name**: HarmonyOSWanAndroid
- **Description**: 初始化
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-03
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HarmonyOS WanAndroid

This is a HarmonyOS-based WanAndroid application designed to provide users with a convenient browsing experience for WanAndroid website content. WanAndroid is a knowledge-sharing platform for Android developers, offering rich technical articles, project tutorials, interview experiences, and more.

## Features

- **Multi-module Architecture**: The app adopts a modular design with functional modules such as Home, Popular, Categories, and Mine, facilitating maintenance and expansion.
- **Network Request Encapsulation**: A unified network request wrapper simplifies API call workflows.
- **Unified Data Models**: Provides consistent data models and ViewModels to streamline data management and inter-page communication.
- **Componentized Design**: Common UI components (e.g., title bars, list items, loading views) are encapsulated as reusable components.
- **Page Routing Management**: Supports page navigation and routing management to enhance user experience.
- **Logging and Caching Tools**: Includes logging output and local caching functionality for easier debugging and data persistence.

## Technology Stack

- **HarmonyOS SDK**: Developed based on HarmonyOS, leveraging its multi-device collaboration capabilities.
- **ETS (Extended TypeScript)**: Uses ETS for application logic development, improving development efficiency and code maintainability.
- **JSON Configuration**: Employs JSON files for resource configuration and module management.
- **HTTP Network Requests**: Utilizes the built-in HTTP module for network communication, supporting asynchronous data loading.
- **ViewModel + LiveData Architecture**: Uses ViewModel to manage UI data and LiveData for reactive updates.

## Directory Structure

```
├── entry/                        # Application entry module
├── features/                     # Feature modules (Home, Popular, Categories, Mine, etc.)
├── libs/                         # Common library modules (universal components, utility classes, network requests, etc.)
├── AppScope/                     # Global application resource configuration
├── oh-package.json5              # Application dependency configuration file
└── hvigorfile.ts                 # Build configuration file
```

## Quick Start

### Environment Preparation

- Install [DevEco Studio](https://developer.harmonyos.com/cn/tools)
- Configure the HarmonyOS SDK environment
- Install Node.js and related build tools

### Build and Run

1. Clone the project:
   ```bash
   git clone https://gitee.com/ccxb/HarmonyOSWanAndroid.git
   ```

2. Open the project:
   Use DevEco Studio to open the project root directory.

3. Build and run:
   Click the run button in DevEco Studio and select an emulator or physical device for debugging.

## Usage Instructions

- **Home**: Displays recommended articles, Q&A, projects, etc., with banner carousel support.
- **Popular**: Shows a list of popular articles.
- **Categories**: Browses articles by category, supporting secondary classification.
- **Mine**: User personal center featuring favorites, login status, settings, and more.
- **Article Detail**: Supports article content display and WebView loading.

## Contribution Guidelines

Contributions to code and documentation are welcome. Please follow these steps:

1. Fork this repository
2. Create a new branch (`git checkout -b feature/your-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin feature/your-feature`)
5. Create a Pull Request

## License

This project is licensed under the Apache-2.0 license. See the [LICENSE](LICENSE) file for details.

## Contact

For any questions or suggestions, please submit an Issue or contact the project maintainers.