# VHScopeCraft

**Repository Path**: wzp_harmony/VHScopeCraft

## Basic Information

- **Project Name**: VHScopeCraft
- **Description**: 以匠心雕琢鸿蒙场景，用 VScopeCraft 构建每一处细节
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-08-04
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 鸿蒙

## README

# VHScopeCraft ✨
VHScopeCraft 是基于 `6.0.0 (20)` 构建的高效基础框架，专为鸿蒙操作系统 (HarmonyOS) 量身打造！旨在提供一套清晰、高效的代码结构，让鸿蒙开发的每一步都有章可循，如德芙般丝滑 🚀

## 框架概述 🏗️
作为基于鸿蒙 `6.0.0 (20)` 构建的**三层结构**基础框架，它就像为开发者量身定制的「鸿蒙开发加速器」，模块化架构让功能搭建既高效又有序 🔄

🔥 生态同步 MAX：持续追更华为最新 SDK 版本，与鸿蒙生态前沿同频共振，永远站在开发第一线

🔧 组件强强联合：深度集成 VHKit 组件库、HMRouter 路由系统及 VHCore 核心引擎，开发效率直接拉满

🧩 架构灵活如魔方：以经典三层架构为骨架，既保证开发逻辑清晰如镜，又赋予系统扩展弹性如弹簧，复杂需求也能轻松拿捏

⚡ 开箱即用体验：开发者只需轻轻 Fork 项目，瞬间切入开发状态 —— 无论是遵循规范加速落地，还是定制专属开发范式，都能丝滑衔接

VHScopeCraft 以「匠心」为核，在鸿蒙生态的场景化开发中精雕细琢，用轻盈架构承载强韧性能，为高效构建稳定、高性能的应用筑牢根基 🏆

## 核心技术栈 🛠️
### 基础运行环境
- 鸿蒙系统版本：HarmonyOS 6.0.0 (API 20)
- 开发语言：ArkTS（鸿蒙原生开发语言）
- 核心依赖组件
  - VHKit：生态通用组件库（含刷新、导航、布局等高频 UI 组件）
  - HMRouter：鸿蒙页面路由管理系统（支持参数传递、页面栈管理）
  - VHCore：框架核心引擎（提供通用工具类、接口封装等能力）
- 架构设计
  - 三层架构：UI 层（页面 / 组件）、业务逻辑层（ViewModel/Service）、数据层（API / 本地存储）
  - 状态管理：基于鸿蒙状态V2，@Local/@Param....等响应式装饰器
  - 模块化设计：按功能拆分独立模块，支持组件化复用、按需集成
- 工程化能力
    - 开发规范：内置 ArkTS 编码规范、目录结构规范、提交规范
      - 📂 规范文档位置：guides/1、开发规范文档.md（项目根目录下）
      - 🚨 重要提醒：熟悉规范后可以吧这个guides目录删掉哦
    - 开源协议：Apache-2.0 许可证（自由使用、修改、分发）

## 使用说明📝

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/wzp_harmony/VHScopeCraft.git
   ```

2. 安装依赖：
   ```bash
   cd VHScopeCraft
   npm install
   ```

3. 构建项目：
   ```bash
   hvigor build
   ```

4. 运行应用：
   使用 DevEco Studio 打开项目并部署到设备或模拟器。📱💻
 

## 贡献指南🤝

欢迎贡献代码！请遵循以下步骤：
1. 点击 Fork 按钮，复制属于你的代码副本 🍴
2. 创建专属分支（建议用 feature/xxx 或 fix/xxx 命名），提交你的创意修改 ✨
3. 发起 Pull Request，附上修改说明，我们会火速查阅你的精彩贡献 👀
4. 代码审核通过后，你的提交将融入主分支，成为框架的一部分 🌟

## 许可证📜
本项目采用  [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0)  开源许可证，赋予你自由使用、修改和分发的权利 📚。

详情可查阅项目根目录的 LICENSE 文件，合法开发无顾虑，安心构建属于你的鸿蒙应用 🛡️
本项目采用许可证。