示例与开发指南
本页是 HiDiTingV100 示例入口。建议先选择开发环境并完成 Hello World,再根据场景进入 Native 或 JS 工程。每个工程目录均提供 README,工程代码和目标配置是构建行为的最终依据。
选择开发环境
| 开发环境 | 适用场景 | 使用指南 |
|---|---|---|
| 一站式 CLI(推荐) | 快速完成目标选择、构建、烧录和串口监视 | 一站式 CLI 开发环境使用指南 |
| HiSpark Studio for VS Code | 图形化编辑、编译、烧录和调试 | HiSpark Studio for VS Code 开发环境使用指南 |
| WSL 与 Docker | 在 Windows 上使用一致的 Linux 容器构建环境 | WSL 与 Docker 环境使用指南 |
Native 工程按选定环境构建 diting-community;JS 工程使用 HiSpark Studio for VS Code 或兼容的 OpenHarmony IDE 导入、签名、构建和安装。
Native 示例
JS 应用示例
| 示例 | 能力 | 工程说明 |
|---|---|---|
| ACTS Validator | 兼容性验证 | /samples/js_samples/acts_validator/README.md |
| AI 手势识别 | AI 识别与结果展示 | /samples/js_samples/AIGestureDemo/README.md |
| 应用压缩 | 应用资源压缩 | /samples/js_samples/AppCompressSample/README.md |
| BLE | 低功耗蓝牙扫描、连接与数据交互 | /samples/js_samples/bleSample/README.md |
| Cipher | AES/RSA 加解密、摘要、HMAC、Base64、ECC、安全随机数与密钥存储 | /samples/js_samples/CipherSample/README.md |
| Hello World | 最小 JS 应用 | /samples/js_samples/helloworld/README.md |
| HTTP | HTTP 请求与响应 | /samples/js_samples/httptest/README.md |
| 按键输入 | 按键事件处理 | /samples/js_samples/keyinput_sample/README.md |
| 地图 | 地图页面与服务接入 | /samples/js_samples/map_sample/README.md |
| 跑马灯 | 文本滚动与动画 | /samples/js_samples/marqueesample/README.md |
| 音乐 | 音频播放控制 | /samples/js_samples/music/README.md |
| 网络 DFX | 网络诊断 | /samples/js_samples/netDFXSample/README.md |
| Socket | TCP/UDP 数据交互 | /samples/js_samples/sockettest/README.md |
| 天气 | 网络数据与页面绑定 | /samples/js_samples/weather/README.md |
| WebSocket | WebSocket 连接与收发 | /samples/js_samples/websockettest/README.md |
| 电子木鱼 | 事件、状态、动画与音效 | /samples/js_samples/woodenfish/README.md |
Cipher 示例的本地密钥准备
Cipher 示例在运行时生成 AES/HMAC 密钥、IV、ECC 协商盐值和 NV 测试数据。RSA 测试密钥由开发者在调试时自行准备,不在示例中提供固定值,避免测试材料被误用于产品。RSA 接口需要调用者提供 PEM 公钥和私钥,且不以 X.509 证书作为接口入参;HAP 应用签名证书也不能替代 RSA 业务密钥。
验证 RSA 前,在独立测试目录中使用 OpenSSL 生成 2048、3072、4096 位测试密钥,再用 PowerShell 的 Get-Content -Raw <PEM文件> | ConvertTo-Json -Compress 生成包含换行转义的 JavaScript 字符串,在应用调试时临时填入 CipherSample/entry/src/main/js/MainAbility/app.js 的六个空变量。完整命令和验收方法参见 Cipher 密码能力示例 README。测试完成后清除变量内容和临时 PEM 文件。
js_samples/helper 是 JS 示例辅助资源,不是可独立构建和安装的应用。
按主题查阅开发指南
| 主题 | 分类入口 |
|---|---|
| 应用开发 | 应用开发指南 |
| 无线与网络连接 | 连接开发指南 |
| 多媒体 | 多媒体开发指南 |
| 操作系统与系统服务 | 系统与服务开发指南 |
| 外设与板级能力 | 外设与板级能力开发指南 |
| 安全 | 安全开发指南 |
| AI 场景 | AI 开发指南 |
| 测试、认证与维护 | 测试、认证与维护指南 |