# FragrantLanguage

**Repository Path**: wang-qingzhou4/FragrantLanguage

## Basic Information

- **Project Name**: FragrantLanguage
- **Description**: 基于HarmonyOS NEXT开发的个人生活助手，涵盖记账统计、待办管理与随手感想，用碎片化记录，拼出完整的自己。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-25
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Based on the code map, this is an OpenHarmony (HarmonyOS) application project. Let me create a comprehensive README for this project.

# FragrantLanguage

芳香语言 - 一个基于 OpenHarmony 框架开发的应用程序

## 项目简介

本项目是一个基于 OpenHarmony 框架开发的应用程序，采用 ArkTS 语言编写。应用包含主入口 Ability、备份 Ability 以及主页面，旨在展示 OpenHarmony 应用开发的基本架构和功能。

## 技术栈

- **框架**: OpenHarmony / HarmonyOS
- **开发语言**: ArkTS
- **IDE**: DevEco Studio
- **目标平台**: OpenHarmony 标准系统

## 项目结构

```
FragrantLanguage/
├── AppScope/                    # 应用全局配置
│   ├── app.json5              # 应用配置文件
│   └── resources/             # 全局资源
│       ├── base/element/      # 基础元素配置
│       └── base/media/       # 媒体资源
├── entry/                       # 应用入口模块
│   ├── src/main/
│   │   ├── ets/
│   │   │   ├── entryability/  # 主 Ability
│   │   │   ├── entrybackupability/ # 备份 Ability
│   │   │   └── pages/         # 页面
│   │   │       └── Index.ets  # 主页面
│   │   ├── module.json5       # 模块配置
│   │   └── resources/        # 模块资源
│   ├── hvigorfile.ts         # 构建配置
│   └── oh-package.json5     # 依赖配置
├── hvigor/                     # 构建工具配置
├── hvigorfile.ts              # 根构建配置
└── oh-package.json5          # 根依赖配置
```

## 功能特性

- **主 Ability**: 应用的主要入口，负责应用生命周期管理
- **备份 Ability**: 提供应用数据备份能力
- **主页面**: 应用的主界面展示
- **资源管理**: 支持深色模式、多语言等资源管理

## 开发环境配置

### 环境要求

- **操作系统**: Windows 10/11 或 macOS
- **Node.js**: 16.x 或更高版本
- **JDK**: 11.x 或更高版本
- **DevEco Studio**: 3.1.0 或更高版本
- **OpenHarmony SDK**: 3.2.0 或更高版本

### 安装步骤

1. **下载 DevEco Studio**
   
   访问 [华为开发者联盟](https://developer.harmonyos.com/cn/develop/deveco-studio) 下载 DevEco Studio

2. **配置开发环境**
   
   - 安装 JDK 11+
   - 配置 Node.js 环境
   - 导入 OpenHarmony SDK

3. **导入项目**
   
   - 打开 DevEco Studio
   - 选择 File > Open Project
   - 选择项目根目录

## 编译构建

### 开发调试

1. 连接调试设备（真机/模拟器）
2. 点击 DevEco Studio 右上角 Run 按钮
3. 选择运行目标设备
4. 应用将自动安装并运行

### 发布构建

1. 点击 Build > Build HAP(s)
2. 选择发布签名配置
3. 等待构建完成
4. 构建产物位于 `entry/build/outputs/hap` 目录

## 资源说明

### 图片资源

- `background.png`: 应用背景图
- `foreground.png`: 应用前景图
- `startIcon.png`: 启动图标

### 颜色配置

- 应用颜色定义位于 `entry/src/main/resources/base/element/color.json`
- 深色模式颜色定义位于 `entry/src/main/resources/dark/element/color.json`

### 字符串配置

- 字符串资源位于 `entry/src/main/resources/base/element/string.json`

## 测试

项目包含单元测试和集成测试，位于 `entry/src/test` 和 `entry/src/ohosTest` 目录。

运行测试：
```bash
hv test
```

## 许可证

本项目基于 LICENSE 文件中指定的许可证开源。

## 相关文档

- [OpenHarmony 官方文档](https://www.openharmony.cn/)
- [ArkTS 语言教程](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/arkts-overview-00000000000453775)
- [DevEco Studio 使用指南](https://developer.harmonyos.com/cn/docs/documentation/doc-quick-start/deveco-studio-user-guide-0000001262888436)

## 贡献指南

欢迎提交 Issue 和 Pull Request 来帮助改进本项目。