时钟应用
简介
Clock 是 OpenHarmony 系统中的基础时钟应用，提供闹钟、秒表、倒计时和世界时钟四大核心功能。该应用采用 ArkTS 语言开发，基于 OpenHarmony Stage 模型，支持 Phone 和 Tablet 多种设备形态，具备响应式布局、多设备适配和无障碍支持等特性。
Clock 包含以下常用功能：
- 闹钟功能：支持创建、编辑、删除闹钟，支持重复设置（工作日、周末、自定义等），提供贪睡功能和多种铃声选择。
- 世界时钟：支持添加多个城市的时区时钟，提供全球主要城市的时间显示，支持添加和删除城市。
- 秒表功能：支持计时的开始、暂停、复位，支持计次功能（记录多个时间点），提供精确的毫秒级计时显示。
- 计时器功能：支持设置倒计时时间，提供预设时间选项，支持开始、暂停、复位操作，倒计时结束时通过通知提醒用户。
- 多设备适配：支持手机、平板等多种设备形态，自动适配不同屏幕尺寸。
- 国际化支持：支持简体中文、繁体中文、英文、藏文、维吾尔文等多种语言。
系统架构
图 1 时钟应用系统架构图
模块功能说明
整体架构采用模块化设计，划分为产品层、特性层和公共层。
-
产品定制层 (Product Layer)
- Phone Entry: 手机/平板设备入口模块，负责应用的 Ability 生命周期管理、页面路由和设备特定适配。
-
特性层 (Feature Layer)
- 闹钟: 包含闹钟卡片、闹钟管理页面、全屏闹钟界面、闹钟服务管理器等核心组件。
- 世界时钟: 提供世界时钟列表和卡片组件，支持城市管理和时区显示。
- 秒表: 提供秒表表盘 UI、计时控制器和计次功能。
- 计时器: 包含模拟计时器、时间选择器、倒计时控制器和倒计时管理器。
-
公共层 (Common Layer)
- 组件库: 提供时钟表盘、数字时钟、添加按钮、卡片、对话框、标题栏等通用 UI 组件。
- 管理器: 包含数据库管理、闹钟管理、计时器管理、资源管理、状态管理、音频管理等核心业务逻辑。
- 工具类库: 提供时间格式化、事件上报、通知管理、WantAgent 等基础功能。
关键交互流程
闹钟触发流程
- 闹钟设置: 用户通过闹钟管理页面创建或编辑闹钟，设置时间和重复规则。
- 数据存储: 通过
AlarmManager将闹钟信息保存到关系型数据库。 - 时间监听: 系统监听时间变化，当到达闹钟设置时间时触发闹钟。
- 闹钟服务:
AlarmServiceManager接收闹钟触发事件，启动闹钟服务。 - 音频播放: 通过
AudioManager和SoundPool播放闹钟铃声。 - 界面显示: 显示全屏闹钟界面或横幅通知，用户可以停止或贪睡。
- 贪睡处理: 如果用户选择贪睡，通过
SnoozeManager计算下次触发时间。
秒表计时流程
- 开始计时: 用户点击开始按钮，控制器启动计时器。
- 时间更新: 计时器每 10 毫秒更新一次显示时间。
- 计次记录: 用户点击计次按钮，记录当前时间点到计次列表。
- 暂停计时: 用户点击暂停按钮，计时器停止更新。
- 复位操作: 用户点击复位按钮，清除所有计次记录，重置时间为零。
计时器流程
- 时间设置: 用户通过时间选择器设置倒计时时间。
- 开始倒计时: 用户点击开始按钮，倒计时管理器启动系统计时器。
- 时间更新: 每秒更新剩余时间显示，支持后台运行。
- 时间结束: 倒计时结束时，通过通知提醒用户。
- 全屏提醒: 显示全屏提醒界面，用户可以停止或重新开始。
目录
项目目录结构如下：
applications_clock-master/ # 时钟应用根目录
├── AppScope/ # 应用全局配置
│ └── resources/ # 全局资源文件
│ ├── base/ # 基础资源
│ ├── zh_CN/ # 简体中文资源
│ ├── en/ # 英文资源
│ └── dark/ # 深色主题资源
├── common/ # 公共 HAR 模块
│ ├── src/main/ets/
│ │ ├── components/ # 通用组件
│ │ │ ├── Clock/ # 时钟组件
│ │ │ │ ├── ClockHands.ets # 时钟指针
│ │ │ │ ├── Dial.ets # 表盘
│ │ │ │ ├── DigitalClock.ets # 数字时钟
│ │ │ │ └── Scale.ets # 刻度
│ │ │ ├── AddButton/ # 添加按钮
│ │ │ ├── Card/ # 卡片组件
│ │ │ ├── CommonDialog/ # 通用对话框
│ │ │ ├── TitleBar/ # 标题栏
│ │ │ └── RingtoneSelection/ # 铃声选择
│ │ ├── manager/ # 管理器
│ │ │ ├── DatabaseManager.ets # 数据库管理基类
│ │ │ ├── AlarmManager.ets # 闹钟管理
│ │ │ ├── TimerManager.ets # 计时器管理
│ │ │ ├── ResourceManager.ets # 资源管理
│ │ │ ├── SoundPool.ets # 音频播放池
│ │ │ ├── SnoozeManager.ets # 贪睡管理
│ │ │ └── FormManager.ets # 卡片管理
│ │ ├── utils/ # 工具类
│ │ │ ├── TimeUtil.ets # 时间工具
│ │ │ ├── CommonUtil.ets # 通用工具
│ │ │ ├── LogUtil.ets # 日志工具
│ │ │ └── EventReportUtil.ets # 事件上报
│ │ └── types.ets # 类型定义
│ └── build-profile.json5 # 模块构建配置
├── feature/alarmclock/ # 闹钟功能 HAR 模块
│ ├── src/main/ets/
│ │ ├── components/ # 组件
│ │ │ ├── AlarmCard/ # 闹钟卡片
│ │ │ ├── ArraySlider/ # 时间滑块
│ │ │ └── Form/ # 卡片组件
│ │ ├── pages/ # 页面
│ │ │ ├── ManageAlarmClock/ # 闹钟管理
│ │ │ ├── FullScreenAlarm/ # 全屏闹钟
│ │ │ └── BannerAlarm/ # 横幅闹钟
│ │ ├── manager/ # 管理器
│ │ │ ├── AlarmServiceManager.ets # 闹钟服务管理
│ │ │ └── AudioManager.ets # 音频管理
│ │ └── utils/ # 工具类
│ │ └── NotificationUtil.ets # 通知工具
│ └── build-profile.json5 # 模块构建配置
├── feature/stopwatch/ # 秒表功能 HAR 模块
│ ├── src/main/ets/
│ │ ├── components/ # 组件
│ │ │ └── StopwatchDial/ # 秒表表盘
│ │ ├── pages 页面
/ #│ │ │ └── index.ets # 秒表主页面
│ │ └── SoundManager/ # 音频管理
│ │ └── SoundPoolManager.ets # 音频池管理
│ └── build-profile.json5 # 模块构建配置
├── feature/timer/ # 倒计时功能 HAR 模块
│ ├── src/main/ets/
│ │ ├── components/ # 组件
│ │ │ ├── AnalogTimer.ets # 模拟计时器
│ │ │ ├── TimerPicker.ets # 时间选择器
│ │ │ └── TimerView.ets # 计时器视图
│ │ ├── controller/ # 控制器
│ │ │ └── TimerController.ets # 计时器控制器
│ │ ├── manager/ # 管理器
│ │ │ ├── timerManager.ets # 倒计时管理
│ │ │ └── timerAudioPlayer.ets # 音频播放
│ │ ├── pages/ # 页面
│ │ │ ├── index.ets # 倒计时主页面
│ │ │ └── FullScreenTimer/ # 全屏倒计时
│ │ └── utils/ # 工具类
│ │ └── timerNotificationUtil.ets # 通知工具
│ └── build-profile.json5 # 模块构建配置
├── feature/worldclock/ # 世界时钟 HAR 模块
│ ├── src/main/ets/
│ │ ├── components/ # 组件
│ │ └── pages/ # 页面
│ └── build-profile.json5 # 模块构建配置
├── product/phone/ # 手机/平板 Entry 模块
│ ├── src/main/ets/
│ │ ├── pages/ # 页面
│ │ │ ├── index.ets # 主页面
│ │ │ ├── ManageAlarmClock.ets # 闹钟管理
│ │ │ ├── AddCity.ets # 添加城市
│ │ │ ├── EditCities.ets # 编辑城市
│ │ │ └── FullScreenTimer.ets # 全屏倒计时
│ │ ├── MainAbility/ # 主 Ability
│ │ │ └── MainAbility.ets # 主 Ability
│ │ ├── ForegroundAbility/ # 前台服务
│ │ │ └── ForegroundAbility.ets
│ │ ├── FullScreenAbility/ # 全屏 Ability
│ │ │ └── FullScreenAbility.ets
│ │ ├── ServiceExtAbility/ # 服务扩展
│ │ │ ├── AlarmService.ets # 闹钟服务
│ │ │ └── TimerService.ets # 计时器服务
│ │ ├── IntentAbility/ # 意图处理
│ │ │ ├── CreateAlarm.ets # 创建闹钟
│ │ │ ├── DeleteAlarm.ets # 删除闹钟
│ │ │ └── ViewAlarm.ets # 查看闹钟
│ │ ├── BackupExtension/ # 备份扩展
│ │ │ └── BackupExtension.ets # 数据备份
│ │ └── subscriber/ # 静态订阅者
│ │ └── AlarmInitSubscriber.ets # 闹钟初始化
│ ├── src/ohosTest/ # 测试代码
│ │ └── ets/test/ # 单元测试
│ │ ├── Ability.test.ets # 能力测试
│ │ └── List.test.ets # 列表测试
│ └── build-profile.json5 # 模块构建配置
├── oh-package.json5 # 依赖管理
├── build-profile.json5 # 项目构建配置
├── hvigorfile.js # 构建脚本
└── README_zh.md # 中文说明文档
编译构建
根据不同的目标平台，使用以下命令进行编译：
基于 DevEco Studio 构建
- 在 DevEco Studio 打开项目工程
- 选择 Build → Build Haps(s)/APP(s) → Build Hap(s)
- 编译完成后，hap 包会生成在
build/outputs目录下
基于命令行构建
编译时钟应用
./build.sh --product-name rk3568 --ccache --build-target clock
安装 hap 包
hdc_std install "hap包路径"
说明：
--product-name: 产品名称，例如rk3568、Hi3516DV300等。--ccache: 编译时使用缓存功能。--build-target: 编译的部件名称。
使用说明
接口说明
Clock 应用主要使用以下 OpenHarmony API：
表 1 主要接口说明
| 接口名称 | 功能描述 |
|---|---|
| @ohos.data.relationalStore | 关系型数据库，用于存储闹钟和世界时钟数据 |
| @ohos.data.preferences | 持久化配置和状态 |
| @ohos.notification | 通知管理，用于闹钟和倒计时提醒 |
| @ohos.multimedia.audio | 音频管理，用于播放铃声 |
| @ohos.alarm | 闹钟管理，用于设置系统闹钟 |
| @ohos.backgroundTasks | 后台任务，用于计时器后台运行 |
开发步骤
以下演示开发时钟应用的关键步骤：
- 创建项目结构：按照模块化设计创建项目目录。
- 实现数据库管理：继承
DatabaseManager实现闹钟和世界时钟的数据持久化。 - 构建 UI 组件：使用 ArkTS 声明式 UI 构建时钟界面。
- 实现状态管理：使用
@State、@StorageLink等装饰器管理应用状态。 - 实现闹钟功能：使用系统闹钟 API 设置闹钟触发时间。
- 实现计时功能：使用系统计时器实现秒表和倒计时。
- 多设备适配：使用断点系统实现响应式布局。
- 添加无障碍支持：为关键 UI 元素添加无障碍标识。
代码示例
示例 1：创建闹钟管理页面
@Entry
@Component
struct ManageAlarmClock {
@State alarmList: Array<AlarmInfo> = []
private alarmManager: AlarmManager = AlarmManager.getInstance()
aboutToAppear() {
this.loadAlarms()
}
build() {
Column() {
// 标题栏
TitleBar({ title: '闹钟' })
// 闹钟列表
List() {
ForEach(this.alarmList, (alarm: AlarmInfo) => {
ListItem() {
AlarmCard({ alarmInfo: alarm })
}
})
}
.layoutWeight(1)
// 添加按钮
AddButton({ onClick: () => this.addAlarm() })
}
.width('100%')
.height('100%')
}
private loadAlarms() {
this.alarmManager.getAllAlarms((alarms: Array<AlarmInfo>) => {
this.alarmList = alarms
})
}
private addAlarm() {
// 跳转到添加闹钟页面
}
}
示例 2：实现秒表计时功能
@Component
struct Stopwatch {
@State elapsedTime: number = 0
@State isRunning: boolean = false
private timer: number = -1
build() {
Column() {
// 时间显示
Text(this.formatTime(this.elapsedTime))
.fontSize(48)
.fontWeight(FontWeight.Bold)
// 控制按钮
Row() {
Button(this.isRunning ? '暂停' : '开始')
.onClick(() => this.toggleTimer())
Button('复位')
.onClick(() => this.resetTimer())
}
}
}
private toggleTimer() {
if (this.isRunning) {
this.pauseTimer()
} else {
this.startTimer()
}
}
private startTimer() {
this.isRunning = true
this.timer = setInterval(() => {
this.elapsedTime += 10
}, 10)
}
private pauseTimer() {
this.isRunning = false
clearInterval(this.timer)
}
private resetTimer() {
this.pauseTimer()
this.elapsedTime = 0
}
private formatTime(ms: number): string {
// 格式化时间显示
return TimeUtil.timeFormat(ms)
}
}
示例 3：保存闹钟到数据库
// 使用 AlarmManager 保存闹钟
const alarmManager = AlarmManager.getInstance()
const alarmInfo: AlarmInfo = {
id: 0,
hour: 7,
minute: 30,
repeatDays: [1, 2, 3, 4, 5], // 工作日
enabled: true,
ringtone: 'default_ringtone.mp3',
label: '工作闹钟'
}
alarmManager.insertAlarm(alarmInfo, (success: boolean) => {
if (success) {
LogUtil.info('闹钟保存成功')
}
})
注意事项
- 数据库操作：
AlarmManager继承自DatabaseManager，采用单例模式确保数据库连接的唯一性。 - 状态管理：使用
PersistentStorage.persistProp()持久化关键状态，确保应用重启后状态保持。 - 闹钟触发：使用系统闹钟 API
@ohos.alarm设置闹钟，确保应用在后台也能正常触发。 - 音频管理：使用
SoundPool管理音频播放，避免频繁创建和销毁音频播放器。 - 后台运行：倒计时功能需要使用后台任务管理，确保应用在后台也能正常运行。
- 内存管理：及时释放不再使用的资源，避免内存泄漏。
- 无障碍支持：为所有可交互的 UI 元素设置
id和适当的accessibilityText。
约束
-
开发环境
- DevEco Studio for OpenHarmony: 版本号大于 3.1.1.101
- SDK 版本: OpenHarmony SDK API Version 23
- 编译 SDK: API Version 23
- 兼容 SDK: API Version 23
- 语言版本: ArkTS
-
依赖库
- @ohos/hypium: 1.0.6（测试框架）
-
平台限制
- 仅支持标准系统上运行
- 支持 default 和 tablet 设备形态