# 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**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HarmonyOS WanAndroid

这是一个基于 HarmonyOS 的 WanAndroid 应用程序，旨在为用户提供便捷的 WanAndroid 网站内容浏览体验。WanAndroid 是一个面向 Android 开发者的知识分享平台，提供丰富的技术文章、项目实战、面试经验等内容。

## 特性

- **多模块架构**：应用采用模块化设计，包含首页、热门、分类、我的等多个功能模块，便于维护和扩展。
- **网络请求封装**：使用统一的网络请求封装，简化 API 调用流程。
- **数据模型统一**：提供统一的数据模型和 ViewModel，便于数据管理和页面间通信。
- **组件化设计**：常用 UI 组件（如标题栏、列表项、加载视图等）封装为可复用组件。
- **页面路由管理**：支持页面跳转和导航管理，提升用户体验。
- **日志与缓存工具**：提供日志打印和本地缓存功能，便于调试和数据持久化。

## 技术栈

- **HarmonyOS SDK**：基于 HarmonyOS 进行开发，充分利用其多端协同能力。
- **ETS (Extended TypeScript)**：使用 ETS 进行应用逻辑开发，提升开发效率和代码可维护性。
- **JSON 配置**：使用 JSON 文件进行资源配置和模块管理。
- **Http 网络请求**：基于内置 Http 模块进行网络通信，支持异步数据加载。
- **ViewModel + LiveData 架构**：使用 ViewModel 管理 UI 数据，结合 LiveData 实现响应式更新。

## 目录结构

```
├── entry/                        # 应用入口模块
├── features/                     # 功能模块（首页、热门、分类、我的等）
├── libs/                         # 公共库模块（通用组件、工具类、网络请求等）
├── AppScope/                     # 应用全局资源配置
├── oh-package.json5              # 应用依赖配置文件
└── hvigorfile.ts                 # 构建配置文件
```

## 快速开始

### 环境准备

- 安装 [DevEco Studio](https://developer.harmonyos.com/cn/tools)
- 配置 HarmonyOS SDK 环境
- 安装 Node.js 和相关构建工具

### 构建与运行

1. 克隆项目：
   ```bash
   git clone https://gitee.com/ccxb/HarmonyOSWanAndroid.git
   ```

2. 打开项目：
   使用 DevEco Studio 打开项目根目录。

3. 构建并运行：
   在 DevEco Studio 中点击运行按钮，选择模拟器或真机设备进行调试。

## 使用说明

- **首页**：展示推荐文章、问答、项目等内容，支持 Banner 轮播。
- **热门**：展示热门文章列表。
- **分类**：按分类浏览文章，支持二级分类。
- **我的**：用户个人中心，包含收藏、登录状态、设置等功能。
- **文章详情**：支持文章内容展示和 WebView 加载。

## 贡献指南

欢迎贡献代码和文档。请遵循以下步骤：

1. Fork 本仓库
2. 创建新分支 (`git checkout -b feature/your-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/your-feature`)
5. 创建 Pull Request

## 协议

本项目采用 Apache-2.0 协议。详情请参阅 [LICENSE](LICENSE) 文件。

## 联系方式

如有任何问题或建议，请提交 Issue 或联系项目维护者。