第 4 节 工程结构与配置文件深度剖析

40 阅读11分钟

第 4 节 工程结构与配置文件深度剖析

第 3 章读懂了三个文件,这一章把整个工程体系拆开:多模块、多产物、多 target、资源系统、Context 与沙箱路径。这是做架构设计(第 22 章)前必须掌握的地基。

4.1 模块(Module)与包(Package):两个不同的维度

鸿蒙工程有两个容易混淆的概念层次:

维度一:Module(源码组织单元)

type说明能否独立安装典型用途
entry应用主入口,一个 App 必须有且仅有一个(每个设备类型一个)是(HAP)主界面、启动逻辑
feature特性模块,可按需动态加载/独立分发是(HAP)大功能分包(如"直播模块""AR 模块")
shared动态共享模块,运行时被多个 HAP 共享否(HSP)公共基础库、UI 组件库、网络层

维度二:Package(产物形态)

产物后缀打包时机特点适用
HAP.hap构建产物可安装的模块包,含代码+资源+配置entry / feature
HAR.har编译期静态打包代码与资源被复制进每个依赖它的 HAP;多 HAP 依赖同一 HAR 会导致代码冗余通用工具、UI 组件、SDK 封装、对外发布的库
HSP.hsp运行时动态共享应用内只保留一份,多 HAP 共享;不能单独发布到 ohpm(应用内共享)应用内公共模块,减包体首选
App Pack.app最终产物由一个或多个 HAP + HSP 组成,上传 AGC 的格式上架分发

✅ 最佳实践:HAR vs HSP 怎么选?

决策树:
├─ 这个模块要被"外部工程"复用(发布到 ohpm)?        → HAR
├─ 这个模块只在本应用内被 ≥2 个 HAP 依赖,且体积 >200KB? → HSP(显著减包体)
├─ 这个模块只有 entry 依赖?                          → HAR(更简单,无运行时开销)
└─ 需要按 feature 动态下发/独立升级?                 → feature HAP + 动态加载

⚠️ 坑位:HAR 的资源冲突与代码膨胀

  • HAR 的资源会被合并到宿主,多个 HAR 出现同名资源会覆盖,且难以排查。HAR 内资源名建议加模块前缀(common_ic_back.png)。
  • HAR 内不能有 pages 路由页面被直接 @Entry 使用;HAR 中定义 @Entry 页面在宿主中无效(要用 @Component 导出,由宿主的页面包装)。
  • 三个 HAP 依赖同一个 500KB 的 HAR → 包体增加 1.5MB。改成 HSP 只增加 500KB。

🆕 API 26 / DevEco 26 新能力:多 HAR 合并打包 支持将字节码 HAR 及其所有依赖合并打包,生成一个无外部依赖、可直接使用的独立 HAR。这在对外发布 SDK 时非常有用:下游只需引入一个 HAR,不用处理传递依赖。同时 build-profile.json5 的 packOptions 新增 deduplicateSo 字段,构建 APP 时去除 HAP 与 HSP 中重复的 so 文件,直接减小包体。

4.2 工程级 build-profile.json5 完全解析

{
  "app": {
    "signingConfigs": [
      {
        "name": "default",
        "type": "HarmonyOS",
        "material": {
          "certpath": "C:/Users/dev/.ohos/config/default_HelloHarmony_xxx.cer",
          "storePassword": "0000001A...",           // ⚠️ IDE 加密存储,不要明文提交
          "keyAlias": "debugKey",
          "keyPassword": "0000001A...",
          "profile": "C:/Users/dev/.ohos/config/default_HelloHarmony_xxx.p7b",
          "signAlg": "SHA256withECDSA",
          "storeFile": "C:/Users/dev/.ohos/config/default_HelloHarmony_xxx.p12"
        }
      }
    ],
    "products": [
      {
        "name": "default",
        "signingConfig": "default",
        "compatibleSdkVersion": "5.0.0(12)",
        "compileSdkVersion": "26.0.0",
        "targetSdkVersion": "26.0.0",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "strictMode": {
            "caseSensitiveCheck": true,          // 资源名大小写敏感检查
            "useNormalizedOHMUrl": true          // 使用归一化 OHMUrl(多模块必需)
          }
        }
      }
    ],
    "buildModeSet": [
      { "name": "debug" },
      { "name": "release" }
    ],
    "packOptions": {
      "deduplicateSo": true                       // 🆕 去除 HAP/HSP 重复 so
    }
  },
  "modules": [
    {
      "name": "entry",
      "srcPath": "./entry",
      "targets": [
        { "name": "default", "applyToProducts": ["default"] }
      ]
    },
    {
      "name": "common",
      "srcPath": "./common"
    }
  ]
}

🔬 product / target / buildMode 三个维度

  • product:产品维度,一套完整的 SDK 版本 + 签名 + 配置组合。典型用法:default(国内版)、overseas(海外版,不同签名与配置)。
  • target:模块维度,同一个模块可以针对不同 product 编译不同代码(通过 src/<targetName>/ 源集切换)。
  • buildMode:构建模式,debug / release,决定混淆、调试信息、日志开关。

组合构建命令:

./hvigorw assembleHap --mode module -p product=default -p buildMode=release

🆕 DevEco 26 新能力:支持按 target、product、buildMode 维度个性化配置依赖,构建多目标产物——即不同 product 可以依赖不同版本的三方库,这对"国内版用 A 推送、海外版用 B 推送"这类需求非常实用。

4.3 模块级 build-profile.json5

{
  "apiType": "stageMode",
  "buildOption": {
    "arkOptions": {
      "runtimeOnly": {
        "packages": ["@ohos/axios"],       // 运行时才加载的包
        "sources": []
      },
      "obfuscation": {                     // 也可在此配置(与顶层二选一)
      }
    },
    "externalNativeOptions": {              // Native(C/C++)构建
      "path": "./src/main/cpp/CMakeLists.txt",
      "arguments": "-DCMAKE_BUILD_TYPE=Release",
      "cppFlags": "-std=c++17",
      "abiFilters": ["arm64-v8a", "armeabi-v7a", "x86_64"]
    },
    "napiLibFilterOption": {
      "excludes": ["**/libunneeded.so"]     // 排除不需要的 so
    }
  },
  "buildOptionSet": [
    {
      "name": "release",
      "arkOptions": {
        "obfuscation": {
          "ruleOptions": {
            "enable": true,
            "files": ["./obfuscation-rules.txt"]
          },
          "consumerFiles": ["./consumer-rules.txt"]   // 传递给依赖方的规则
        }
      },
      "nativeLib": {
        "debugSymbol": {
          "strip": true,                    // 发布版剥离符号表(减包体)
          "exclude": []
        }
      }
    }
  ],
  "targets": [
    { "name": "default" },
    { "name": "ohosTest" }
  ]
}

⚠️ abiFilters 与包体:只保留 arm64-v8a 可显著减包。鸿蒙设备绝大多数是 arm64;x86_64 主要用于模拟器。如果你只需要真机,就只留 arm64-v8a;需要模拟器调试则加 x86_64,但发布时用单独的 release target 排除掉。

4.4 oh-package.json5:依赖管理

工程级:

{
  "modelVersion": "26.0.0",
  "name": "helloharmony",
  "version": "1.0.0",
  "description": "demo",
  "dependencies": {},
  "devDependencies": {
    "@ohos/hypium": "1.0.24",           // 测试框架
    "@ohos/hamock": "1.0.0"             // Mock 框架
  },
  "overrides": {                        // 强制统一传递依赖版本(解决版本冲突)
    "@ohos/axios": "2.2.4"
  }
}

模块级(entry/oh-package.json5):

{
  "name": "entry",
  "version": "1.0.0",
  "main": "",                            // HAR/HSP 的入口文件(如 "./Index.ets")
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "@ohos/axios": "^2.2.4",             // 三方库
    "common": "file:../common",          // 本地模块依赖(HAR/HSP)
    "libentry.so": "file:./src/main/cpp/types/libentry"  // Native 模块
  },
  "dynamicDependencies": {}                 // 动态依赖(按需加载)
}

🔬 main 与 Index.ets 导出约定

HAR/HSP 模块需要在模块根目录提供入口文件(通常是 Index.ets)做统一导出:

// common/Index.ets —— 模块的公开 API 面
export { HttpClient, type HttpResponse } from './src/main/ets/network/HttpClient';
export { DateFormatter } from './src/main/ets/utils/DateFormatter';
export * from './src/main/ets/components';

✅ 最佳实践:用 Index.ets 控制模块边界 只导出真正需要公开的符号。内部实现细节不要 export——这不仅减少误用,也让 hvigor 的摇树优化(tree-shaking)能真正删掉未使用代码,直接减小包体。DevEco 26 对跨模块移动文件时的 import 适配做了优化,重构时 Index 会自动适配改动。

4.5 资源系统:$r、$rawfile 与限定目录

4.5.1 资源分类与目录

resources/
├── base/
│   ├── element/                  # 结构化资源(json 描述)
│   │   ├── string.json           # 字符串(支持复数、格式化)
│   │   ├── color.json            # 颜色
│   │   ├── float.json            # 尺寸/浮点
│   │   ├── integer.json          # 整数
│   │   ├── boolean.json
│   │   └── plural.json           # 复数形式
│   ├── media/                    # 图片(png/jpg/svg/webp/gif)、json(lottie)
│   ├── profile/                  # 配置文件
│   │   ├── main_pages.json       # @Entry 页面表
│   │   ├── route_map.json        # 🆕 Navigation 系统路由表
│   │   └── form_config.json      # 卡片配置
│   └── rawfile/                  # 原始文件,不参与资源编译,保持目录结构
├── zh_CN/element/string.json     # 简体中文覆盖
├── en_US/element/string.json
├── dark/element/color.json       # 深色模式覆盖
└── rawfile/

4.5.2 三种资源引用方式

// ① $r:引用 resources 下的编译型资源(最常用,支持限定目录自动匹配)
Text($r('app.string.hello'))
  .fontColor($r('app.color.text_primary'))
  .fontSize($r('app.font.size_body'))
Image($r('app.media.icon_back'))

// ② $rawfile:引用 rawfile 下的原始文件(返回 Resource 对象)
Image($rawfile('images/banner.png'))
// 读取 rawfile 文本内容
import { resourceManager } from '@kit.LocalizationKit';
const ctx = getContext(this) as common.UIAbilityContext;
const buf: Uint8Array = await ctx.resourceManager.getRawFileContent('data/config.json');
const text = buffer.from(buf).toString('utf-8');

// ③ 系统资源:$r('sys.xxx')
Text('确定').fontColor($r('sys.color.ohos_id_color_text_primary'))
Image($r('sys.media.ohos_ic_public_back'))

⚠️ app. 与 sys. 前缀的区别:app.string.xxx 是本应用资源,sys.color.xxx 是系统资源。优先使用系统资源做基础色值与图标,它们会自动适配深色模式、字号缩放与鸿蒙设计语言,且随系统升级保持一致。

4.5.3 字符串的复数与格式化

// base/element/string.json
{
  "string": [
    { "name": "app_name", "value": "阅界" },
    { "name": "hello_format", "value": "你好,%s!今天是%s" },
    { "name": "item_count", "value": "%d 条内容" }
  ]
}
// base/element/plural.json
{
  "plural": [
    {
      "name": "photo_count",
      "value": [
        { "quantity": "one", "value": "%d photo" },
        { "quantity": "other", "value": "%d photos" }
      ]
    }
  ]
}
// 格式化:getStringSync 支持占位符替换
const ctx = getContext(this) as common.UIAbilityContext;
const msg = ctx.resourceManager.getStringSync($r('app.string.hello_format').id, '张三', '周三');
const plural = ctx.resourceManager.getPluralStringSync($r('app.plural.photo_count').id, 3, 3);

4.5.4 资源管理器 API

import { common } from '@kit.AbilityKit';

const rm = (getContext(this) as common.UIAbilityContext).resourceManager;

rm.getStringSync($r('app.string.app_name').id);            // 同步取字符串
rm.getColorSync($r('app.color.bg_page').id);                // 同步取颜色(返回 number)
rm.getMediaByNameSync('icon_back');                         // 按名字取 media(返回 Uint8Array)
await rm.getRawFileContent('data/seed.db');                  // 异步取 rawfile
rm.getConfigurationSync();                                  // 当前配置(语言/深色/分辨率)

🔬 配置变化的响应:系统语言、深色模式、屏幕分辨率变化时,AbilityStage.onConfigurationUpdate(newConfig) 会被回调,同时资源引用会自动重新匹配限定目录(UI 会自动刷新)。如果你缓存了 $r() 解析后的具体值(例如把颜色存成 number 变量),就不会自动更新——这是"切换深色模式后部分界面还是白的"的典型原因。

4.6 Context 与沙箱路径:文件到底存在哪

4.6.1 Context 分层

ApplicationContext(应用级,跨模块,进程唯一)
   └── AbilityStageContext(模块级,HAP 维度)
          └── UIAbilityContext(组件级,最常用,能拉起其他 Ability、申请权限)
          └── ExtensionContext(扩展组件级)
                 └── FormExtensionContext / ServiceExtensionContext …
          └── Context(UIContext,UI 维度,ArkUI 内部使用)

获取方式:

import { common } from '@kit.AbilityKit';

// 在 UI 组件中(推荐)
const uiCtx = this.getUIContext().getHostContext() as common.UIAbilityContext;

// 兼容写法(在 @Entry 组件内)
const ctx = getContext(this) as common.UIAbilityContext;

// 应用级
const appCtx = uiCtx.getApplicationContext();

// 在 UIAbility 中
const ctx = this.context;   // UIAbilityContext

⚠️ 坑位:getContext(this) 在自定义组件中的可用性 在非 @Entry 的自定义组件里 getContext(this) 可能拿到的是上层 Context;DevEco 26 的推荐做法是 this.getUIContext().getHostContext(),它明确表达"我所在 UI 实例的宿主 Context",在弹窗、子窗口、卡片等场景更可靠。此外,不要在 struct 的成员初始化时调用 getContext(此时组件尚未挂载),要在 aboutToAppear 中获取。

4.6.2 沙箱目录

每个应用有独立沙箱,路径按安全级别(el1/el2)与模块划分:

/data/app/el1/100/base/<bundleName>/          # EL1:设备级加密,开机前即可访问(极少用)
/data/app/el2/100/base/<bundleName>/          # EL2:用户级加密,首次解锁后可访问(默认)
    ├── files/            # ⭐ 应用私有文件(持久,会被备份)
    ├── cache/            # 缓存(可被系统清理,不备份)
    ├── temp/             # 临时(进程退出可能清理)
    ├── preferences/      # Preferences 存储目录
    ├── database/         # RelationalStore 数据库目录
    ├── files/Account/    # 账号相关
    └── haps/<moduleName>/{files,cache,temp,preferences,database}   # 按模块隔离
/data/storage/el2/base/          # 应用内看到的"相对视图"路径
/data/app/el2/100/hmdfs/...      # 分布式文件系统(跨设备)

代码获取:

const ctx = this.context;   // UIAbilityContext
ctx.filesDir;         // .../files           持久私有文件(推荐存业务数据)
ctx.cacheDir;         // .../cache           缓存(图片、临时下载)
ctx.tempDir;          // .../temp            临时文件
ctx.preferencesDir;   // .../preferences     首选项
ctx.databaseDir;      // .../database        数据库
ctx.bundleCodeDir;    // 安装包代码目录(只读)
ctx.distributedFilesDir;  // 分布式文件目录
ctx.area;             // EL1 / EL2

✅ 最佳实践:什么放哪

数据类型目录理由
用户产生的业务数据(笔记、草稿)filesDir持久,参与备份
数据库databaseDir(由 RelationalStore 管理)系统统一管理路径
图片/视频缓存、下载中文件cacheDir可被系统回收,不占备份空间
解压中间产物、临时上传文件tempDir生命周期最短
轻量 KV 配置Preferences(preferencesDir)内部走 files,API 更简单
敏感凭据不要落盘,用 HUKS 密钥库或 Asset Kit第 17 章

⚠️ 磁盘配额与清理:cacheDir 超过阈值时系统会在存储紧张时清理;如果你把重要数据放 cache,会遭遇"用户切了个 App 数据就没了"。用户数据一律 filesDir 或数据库。

4.6.3 文件操作(Core File Kit)

import { fileIo as fs } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

const ctx = this.getUIContext().getHostContext() as common.UIAbilityContext;
const path = `${ctx.filesDir}/notes.json`;

try {
  // 写文件
  const file = fs.openSync(path, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE | fs.OpenMode.TRUNC);
  fs.writeSync(file.fd, JSON.stringify({ title: '第一篇笔记' }));
  fs.closeSync(file);

  // 读文件
  const stat = fs.statSync(path);
  const buf = new ArrayBuffer(stat.size);
  const rf = fs.openSync(path, fs.OpenMode.READ_ONLY);
  fs.readSync(rf.fd, buf);
  fs.closeSync(rf);
  const text = new TextDecoder().decodeToString(new Uint8Array(buf));   // ArkTS 推荐 API

  // 目录操作
  fs.mkdirSync(`${ctx.filesDir}/images`, 0o775);
  const list = fs.listFileSync(`${ctx.filesDir}`);
  fs.unlinkSync(path);                     // 删除
  fs.copyFileSync(src, dst);
  fs.renameSync(oldPath, newPath);

  // 异步版本(大文件务必用异步,避免阻塞主线程)
  await fs.write(file.fd, data);
} catch (e) {
  const err = e as BusinessError;
  hilog.error(0x0000, 'FS', 'code=%{public}d msg=%{public}s', err.code, err.message);
}

⚠️ 坑位

  • TextDecoder 用 decodeToString()(decodeWithStream 已废弃)。
  • 大文件读写必须用异步 API 或放到 TaskPool(第 15 章),主线程 IO 会造成丢帧甚至冻屏(AppFreeze)。
  • 应用无法直接访问其他应用沙箱或公共目录,读写用户相册/文档必须走 Picker(安全控件)或申请对应权限(第 16、17 章)。

4.7 页面路由表与系统路由表:两套机制

main_pages.jsonroute_map.json
服务对象@Entry 页面(router / loadContent)Navigation 的 NavDestination
位置resources/base/profile/main_pages.jsonresources/base/profile/route_map.json(自定义名,在 module.json5 的 routerMap 字段声明)
是否支持跨模块否(模块内)是(系统自动扫描各模块的路由表,实现模块解耦)
动态加载否是(HSP 中的页面按需加载)
推荐度仅用于 loadContent 的首页⭐ 官方推荐

route_map.json 示例:

{
  "routerMap": [
    {
      "name": "ArticleDetailPage",
      "pageSourceFile": "src/main/ets/pages/ArticleDetailPage.ets",
      "buildFunction": "articleDetailBuilder",
      "data": { "description": "文章详情" }
    },
    {
      "name": "UserProfilePage",
      "pageSourceFile": "src/main/ets/pages/UserProfilePage.ets",
      "buildFunction": "userProfileBuilder"
    }
  ]
}

在 module.json5 中声明:

"module": {
  "routerMap": "$profile:route_map",
  ...
}

页面侧提供 @Builder:

// pages/ArticleDetailPage.ets
@Builder
export function articleDetailBuilder() {
  ArticleDetailPage()
}

@ComponentV2
export struct ArticleDetailPage {
  build() {
    NavDestination() { /* ... */ }
      .title('文章详情')
  }
}

第 11 章会给出完整的路由架构(含拦截器、动态加载、参数传递、返回结果)。

4.8 hvigorfile.ts:可编程的构建脚本

工程级:

import { appTasks } from '@ohos/hvigor-ohos-plugin';

export default {
  system: appTasks,
  plugins: []
}

模块级(可插入自定义任务):

import { hapTasks } from '@ohos/hvigor-ohos-plugin';
import { HvigorPlugin } from '@ohos/hvigor';

function genBuildInfoPlugin(): HvigorPlugin {
  return {
    pluginId: 'gen-build-info',
    init(task) {
      // 在构建前生成 BuildInfo.ets(版本号、构建时间、commit id)
      const fs = require('fs');
      const content = `export const BUILD_INFO = {
  version: '${process.env.npm_package_version ?? '1.0.0'}',
  buildTime: ${Date.now()},
  commit: '${process.env.GIT_COMMIT ?? 'unknown'}'
};`;
      fs.writeFileSync('./src/main/ets/common/BuildInfo.ets', content);
    }
  };
}

export default {
  system: hapTasks,
  plugins: [genBuildInfoPlugin()]
}

✅ 实战价值:把版本号、commit、构建时间注入代码,线上崩溃日志一眼定位到具体构建;也可在构建期做资源压缩、敏感信息扫描、依赖审计。

4.9 .gitignore 标准模板

# 依赖与构建产物
/oh_modules/
**/oh_modules/
/build/
**/build/
/.hvigor/
**/.hvigor/
/.idea/
**/.idea/
.cxx/
**/.cxx/
*.har
*.hap
*.hsp
*.app

# 预览与测试产物
**/.preview/
**/.test/
/coverage/

# 签名材料(红线:绝不入库)
*.p12
*.p7b
*.cer
*.csr
**/signing/
local.properties

# 系统与日志
.DS_Store
Thumbs.db
*.log
/captures/

# 本地配置
/local.properties
**/src/main/cpp/.cxx/

⚠️ oh-package-lock.json5 必须入库(保证团队构建一致),oh_modules/ 必须忽略。

4.10 一个真实的多模块工程蓝图

以第 37~39 章的实战项目为例,推荐的工程结构:

MyApp/
├── AppScope/
├── entry/                     # HAP(entry):仅装配,不写业务
│   └── src/main/ets/
│       ├── entryability/      # UIAbility、AbilityStage
│       ├── pages/             # @Entry 首页容器(Navigation 根)
│       └── startup/           # 启动任务编排(第 25 章)
├── feature_home/              # HSP:首页业务
├── feature_article/           # HSP:文章详情业务
├── feature_user/              # HSP:用户中心业务
├── common_ui/                 # HAR/HSP:UI 组件库(按钮、列表项、空态、骨架屏)
├── common_network/            # HSP:网络层(RCP 封装、拦截器、错误码映射)
├── common_data/               # HSP:数据仓库(Repository)+ 持久化
├── common_model/              # HAR:纯数据模型与工具(无 UI、无 Context 依赖)
├── common_ai/                 # HSP:端侧 AI 能力封装(第 32 章)
└── build-profile.json5        # 统一版本、签名、混淆

依赖方向(严格单向,禁止环):

entry ──▶ feature_* ──▶ common_ui / common_data / common_ai ──▶ common_model

第 22 章会把这套结构落地为可运行的工程,并讲解如何用 HSP + 动态加载做"按需下发"。

4.11 本章小结

  • Module 三类型(entry/feature/shared)与产物四形态(HAP/HSP/HAR/App Pack)是两个维度;HAR 编译期复制、HSP 运行时共享,应用内公共模块优先 HSP。
  • 工程配置的核心是 build-profile.json5 的 product × target × buildMode 三维组合,以及 SDK 三版本字段。
  • 依赖用 oh-package.json5 + overrides 统一版本;HAR/HSP 通过 Index.ets 控制导出边界。
  • 资源系统靠限定目录实现多语言、深色模式、多设备自动适配;base 必须有兜底;优先用 sys.* 系统资源。
  • Context 分层(Application → AbilityStage → UIAbility → UI)与沙箱目录(files/cache/temp/preferences/database)是数据落盘的基础;用户数据只放 filesDir 或数据库。
  • 路由有两套表:main_pages.json(@Entry)与 route_map.json(Navigation),新项目只用后者。

4.12 常见错误自查

现象原因解法
某设备上图标/文案缺失base 缺兜底资源每个资源在 base 下都放一份
深色模式部分界面不变色缓存了 $r() 解析结果,或硬编码色值统一用 $r('app.color.*'),在 dark 目录覆盖
包体莫名增大多个 HAP 依赖同一个大 HAR改 HSP;开启 deduplicateSo
多模块编译报模块找不到useNormalizedOHMUrl 未开启或依赖未在模块 oh-package 声明开启 strictMode;补依赖声明
数据在存储紧张时丢失写到了 cacheDir改 filesDir 或数据库
Navigation 页面跳转失败只登记了 main_pages.json配置 route_map.json + module.json5 的 routerMap
release 崩溃堆栈是混淆名未保留符号表构建产物中保存 mapping,用 hstack 还原(第 24 章)
团队构建结果不一致oh-package-lock.json5 未入库提交锁文件

4.13 动手练习

  1. 把模板工程改造成 4.10 节的多模块结构(先建 common_model(HAR)与 common_ui(HSP)),让 entry 依赖它们并成功编译运行。
  2. 创建 resources/zh_CN/element/string.json 与 resources/en_US/element/string.json,切换模拟器语言,验证文案自动变化。
  3. 创建 resources/dark/element/color.json,覆盖 bg_page,切换深色模式验证。
  4. 写一个 hvigorfile.ts 插件,在构建时生成 BuildInfo.ets(版本 + 时间戳),并在首页显示出来。
  5. 打印 ctx.filesDir / cacheDir / tempDir / preferencesDir / databaseDir 的真实路径,用 hdc shell ls 去设备上确认目录存在,并往 filesDir 写一个文件后 hdc file recv 拉回来。
  6. 把同一个 500KB 的 HAR 分别配置为 HAR 与 HSP,构建两次,对比 .app 包体积差异,把数据记录下来(第 25 章包体优化会用到)。

下一章:ArkTS 语言本体——为什么它不是 TypeScript,以及所有 arkts-no-* 错误的正确改写方式。