# hmShop

**Repository Path**: simple.tcp.server/hm-shop

## Basic Information

- **Project Name**: hmShop
- **Description**: 鸿蒙开源免费商城，arkts arkui
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-21
- **Last Updated**: 2025-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hmShop · 鸿蒙购物应用

> 现代化、模块化的 HarmonyOS/ArkTS 购物示例应用

---

作者信息
- 开发者: songxinfeng
- 最近修改时间: 2025-08-29

---

## 项目概览

hmShop 是基于 HarmonyOS Next（ArkTS）构建的购物应用示例，覆盖主页、分类、商品详情、购物车、用户地址管理等核心电商场景，并提供完善的页面导航、状态管理与组件复用示例，适合学习与二次开发。

## 功能特性

- 基础页面
  - 主页、消息、个人中心、多 Tab 导航（`MainTabsPage.ets`）
  - 分类与商品列表（`CategoryProductListPage.ets`）
  - 商品详情（`ProductDetailPage.ets`）
  - 购物车（`CartPage.ets`）
  - 用户地址列表/新增编辑（`UserAddressPage.ets`、`UserAddressAddOrEditPage.ets`）
- 认证与登录
  - 手机号输入校验，预留短信验证码与华为账号登录接入点（`pages/Login.ets`）
- 组件与样式
  - 通用加载/空态/卡片组件（`components/Enhanced*`）
  - 统一构建器与样式增强（`components/Shared*`、`utils/UIEnhancement.ets`）
- 数据与模型
  - 商品与地址实体、仓库层封装（`models/`）
  - 环境与 Mock 数据服务（`services/`）
- 测试
  - 覆盖页面、组件、流程与性能的测试用例（`entry/src/main/test/ets`、`ohosTest/`）

## 目录结构（节选）

```
entry/src/main/
├── ets/
│   ├── apijs/                 # API 与网络封装
│   ├── components/            # 可复用 UI 组件
│   ├── entryability/          # 应用入口能力
│   ├── models/                # 领域模型与仓库
│   ├── pages/                 # 业务页面
│   ├── services/              # 业务服务
│   ├── types/                 # 类型定义
│   ├── utils/                 # 工具与增强
│   ├── view/                  # 视图层辅助
│   └── viewmodels/            # MVVM ViewModel
└── resources/                 # 资源（语言、图片、配置）
```

更多细节可参考根目录文档：`SHARED_COMPONENTS_GUIDE.md`、`SHARED_COMPONENTS_IMPLEMENTATION.md`、`MAINTABS_NAVIGATION.md`、`PRODUCT_DETAIL_MODULE.md`、`PROJECT_SUMMARY.md`。

## 快速开始

前置条件
- DevEco Studio 4.0+（或兼容版本）
- HarmonyOS SDK 已安装并配置
- Node.js 16+

步骤
1. 使用 DevEco Studio 打开本项目
2. 选择 `entry` 模块为运行配置
3. 连接模拟器或真机，点击运行按钮调试

## 构建与打包

- 调试构建：使用 DevEco Studio 直接运行 `entry` 模块
- 生成 HAP：构建配置参考 `entry/build/config/buildConfig.json` 与 `entry/build/outputs/default/`
- 混淆：参考 `entry/obfuscation-rules.txt`

## 测试

- 测试目录：
  - 单元与集成：`entry/src/main/test/ets`、`entry/src/ohosTest/ets`
  - 覆盖：页面流程、组件、性能与导航
- 在 DevEco Studio 中选择对应测试配置运行

## 配置与环境

- 应用配置：`AppScope/app.json5`、`entry/src/main/module.json5`
- 构建配置：`build-profile.json5`、`entry/build-profile.json5`
- 运行环境切换：`ets/apijs/EnvironmentApi.ets`、`services/EnvironmentService.ets`

## 注意事项

- 华为账号与短信登录需接入真实 SDK 与证书（当前示例保留扩展点）
- 网络权限与域名配置需在 `module.json5` 与相关安全配置中开启
- 资源与国际化示例位于 `resources/base/element/`，可按需扩展暗色与多语种

## 变更记录（摘要）

- 2025-08-29：重构 README 结构，补充目录、测试与打包说明；统一作者信息

---

## 作者信息

- 开发者: songxinfeng
- 创建时间: 2024-12-19
- 最近修改时间: 2025-08-29