篇章

主题

读完能得到什么

01

项目跑起来

完成工程导入、SDK、权限和真机运行检查

02

源码导览

看懂 entry、staticlibrary、dynamiclibrary 的边界

03

Stage 入口

理解 EntryAbility 和首页加载流程

04

首页工作台

掌握 Tab、摘要和最近记录刷新

05

拍照水印

把时间、定位和备注写进照片

06

录音留证

完成录音、播放和归档

07

水印样式

管理模板、颜色和字段显示

08

记录管理

实现筛选、详情和媒体回看

09

统计复盘

让图表从真实数据里长出来

10

真机交付

整理构建、签名、缓存和验收清单

{
  "name": "entry",
  "dependencies": {
    "dynamiclibrary": "file:../dynamiclibrary",
    "staticlibrary": "file:../staticlibrary"
  }
}

模块

主要内容

后续章节会怎么用

entry

页面、Ability、资源、权限

首页、拍照页、录音页和记录页都从这里进入

staticlibrary

WorkRecord、WatermarkTemplate、AppStorageKeys

后面章节直接复用统一数据结构

dynamiclibrary

WorkClockService、状态持久化、统计汇总

首页、记录和统计都从这里取数据

{
  "products": [
    {
      "name": "default",
      "signingConfig": "default",
      "targetSdkVersion": "6.1.0(23)",
      "compatibleSdkVersion": "6.0.2(22)",
      "runtimeOS": "HarmonyOS"
    }
  ]
}

配置项

当前值

为什么要先看它

targetSdkVersion

6.1.0(23)

决定工程按哪个目标版本编译

compatibleSdkVersion

6.0.2(22)

决定可兼容的设备范围

runtimeOS

HarmonyOS

确认不是其它运行时

modules

entry / staticlibrary / dynamiclibrary

确认完整 app 包要一起构建

{
  "module": {
    "name": "entry",
    "type": "entry",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone"
    ],
    "pages": "$profile:main_pages"
  }
}

"requestPermissions": [
  { "name": "ohos.permission.CAMERA" },
  { "name": "ohos.permission.MICROPHONE" },
  { "name": "ohos.permission.APPROXIMATELY_LOCATION" },
  { "name": "ohos.permission.LOCATION" }
]

权限

用途

对应场景

CAMERA

拍摄现场照片

拍照留证

MICROPHONE

录制现场语音

录音留证

APPROXIMATELY_LOCATION

粗略定位兜底

水印地址

LOCATION

定位写入记录

水印地址和记录归档

{
  "app": {
    "bundleName": "com.example.project027",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "buildVersion": "1",
    "icon": "$media:layered_image",
    "label": "$string:app_name"
  }
}

{
  "name": "default",
  "type": "HarmonyOS",
  "material": {
    "storeFile": "<local-cert-path>",
    "storePassword": "******",
    "keyAlias": "<alias>",
    "keyPassword": "******",
    "profile": "<profile-path>",
    "certpath": "<cert-path>"
  }
}

需要脱敏的内容

推荐写法

原因

证书路径

<local-cert-path>

避免暴露本机目录

密码字段

******

避免泄露签名材料

profile/certpath

<profile-path>/<cert-path>

避免暴露文件位置

设备信息

<device-id>

避免把真机标识写进正文

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    this.context.getApplicationContext()
      .setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
    WorkClockService.getInstance().bootstrap(this.context);
  }

  onWindowStageCreate(windowStage: window.WindowStage): void {
    windowStage.loadContent(Routes.MAIN_PAGE, (err) => {
      if (err.code) {
        hilog.error(DOMAIN, 'testTag',
          'Failed to load the content. Cause: %{public}s', JSON.stringify(err));
        return;
      }
      hilog.info(DOMAIN, 'testTag', 'Succeeded in loading the content.');
    });
  }
}

检查点

通过标准

先看哪里

工程导入

DevEco 能识别完整项目结构

项目目录和 Sync Project

依赖同步

entry 能引用两个本地库模块

entry/oh-package.json5

构建

assembleApp 能输出完整安装包

hvigor 构建日志

安装

真机签名校验通过

bundleName、profile、UDID

启动

EntryAbility 能加载首页

Routes.MAIN_PAGE 和 HiLog

权限

相机、麦克风、定位按需申请

module.json5 和权限弹窗

内容

处理方式

目的

证书路径

替换为占位符

避免暴露本机目录

密码字段

替换为 ******

避免泄露签名材料

UDID/设备名

不要进入正文

避免暴露设备信息

build/oh_modules

不作为正文重点

避免读者误把生成目录当源码

检查项

对应文件

读者收益

目标/兼容 SDK

build-profile.json5

先确认编译和安装基线一致

入口与权限

module.json5

确认首页启动和相机/麦克风/定位声明可用

应用标识与资源

AppScope/app.json5

避免包名、图标和名称不一致

真机安装链路

签名配置与设备授权

减少“能编译不能安装”的误判

{
  "module": {
    "name": "entry",
    "type": "entry",
    "mainElement": "EntryAbility",
    "pages": "$profile:main_pages",
    "requestPermissions": [
      { "name": "ohos.permission.CAMERA" },
      { "name": "ohos.permission.MICROPHONE" },
      { "name": "ohos.permission.APPROXIMATELY_LOCATION" },
      { "name": "ohos.permission.LOCATION" }
    ]
  }
}

环节

对应代码

这一环要看什么

启动能力

EntryAbility.onCreate() -> WorkClockService.bootstrap(context)

先把服务和 AppStorage 基线初始化好

首页刷新

Index.refreshAllData()

读取 overview、actions、records、recentRecords、settings

记录写入

WorkClockService.saveRecord()

normalizeRecord 之后再 persist

统计重算

WorkClockService.getStatsSummary(range)

从同一份 records 重建 metrics、trend 和 categories

版本刷新

AppStorageKeys.WORKCLOCK_VERSION

记录变化后触发页面重刷

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
    WorkClockService.getInstance().bootstrap(this.context);
  }
}

private refreshAllData(resetCalendarDate: boolean): void {
  const storedTab: string | undefined = AppStorage.get(AppStorageKeys.MAIN_TAB) as string | undefined;
  if (storedTab && storedTab.length > 0) {
    this.currentTab = storedTab;
  }

  this.overview = this.service.getOverviewSnapshot();
  this.actions = this.service.getHomeActions();
  this.records = this.service.getRecords();
  this.recentRecords = this.service.getRecentRecords();
}

saveRecord(record: WorkRecord): void {
  const payload: WorkRecord = this.normalizeRecord(record);
  const index: number = this.records.findIndex((item: WorkRecord) => item.id === payload.id);
  if (index >= 0) {
    this.records[index] = payload;
  } else {
    this.records.unshift(payload);
  }
  this.persist();
}