CardHarmonyOS

CardHarmonyOS 是期货首页卡片的 HarmonyOS ArkTS 示例工程，使用 ArkUI 声明式 UI 实现 AI 观点、市场排名和 AI 选期三张业务卡片。首页入口为 entry/src/main/ets/pages/Index.ets。

环境要求

• DevEco Studio（支持 HarmonyOS API 20 及以上）
• HarmonyOS SDK 6.0.0 或更高版本
• ohpm
• HarmonyOS 手机或模拟器

项目目标 SDK 为 HarmonyOS 6.1.0（API 23），兼容 SDK 为 6.0.0（API 20）。

快速开始

1. 使用 DevEco Studio 打开仓库根目录。
2. 执行 ohpm install 安装依赖。
3. 在 File > Project Structure > Signing Configs 中配置本机调试签名。
4. 选择 entry 模块和 default product。
5. 连接设备或启动模拟器，点击 Run 构建并安装应用。

单元测试位于 entry/src/test/，设备测试位于 entry/src/ohosTest/，可在 DevEco Studio 中右键测试文件执行。

目录结构

AppScope/                         应用级配置与资源
entry/src/main/ets/
├── pages/                        首页及详情页
├── ai-view/                      AI 观点卡片
├── market-ranking/               市场排名卡片
├── ai-pick/                      AI 选期卡片
└── common/                       卡片容器、数据模型及行情字段常量
entry/src/main/resources/         文案、颜色、图片和页面配置
doc/                              HTTP 与 4106 行情接口文档

业务卡片通常由 Models、DataFetcher、NodeComponent 和 Mock 数据组成。 市场排名与 AI 选期分别通过独立的 HqRequestClient 构造行情订阅参数，共享 common/HqFieldId.ets 中的 4106 字段 ID。

数据与接口

当前 HTTP Fetcher 仅构造请求参数，行情客户端也尚未连接真实客户端桥接层；页面使用 Mock 数据并以 2.5 秒间隔模拟行情更新。接入真实服务前请阅读：

• 市场排名接口
• AI 选期接口

不要在源码或提交中新增 Cookie、Token、证书、私钥或本机签名密码。签名材料应通过 DevEco Studio 在本机配置。

开发约定

• 使用 ArkTS 显式类型，组件采用 ArkUI 声明式写法。
• 类型和类使用 PascalCase，变量和方法使用 camelCase，常量使用 UPPER_SNAKE_CASE。
• 公共行情字段统一维护在 HqFieldId，避免在业务卡片中硬编码字段 ID。
• 新增接口或修改 4106 参数时，同步更新 doc/ 下对应文档。