第 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.json | route_map.json | |
|---|---|---|
| 服务对象 | @Entry 页面(router / loadContent) | Navigation 的 NavDestination |
| 位置 | resources/base/profile/main_pages.json | resources/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 动手练习
- 把模板工程改造成 4.10 节的多模块结构(先建
common_model(HAR)与common_ui(HSP)),让 entry 依赖它们并成功编译运行。 - 创建
resources/zh_CN/element/string.json与resources/en_US/element/string.json,切换模拟器语言,验证文案自动变化。 - 创建
resources/dark/element/color.json,覆盖bg_page,切换深色模式验证。 - 写一个
hvigorfile.ts插件,在构建时生成BuildInfo.ets(版本 + 时间戳),并在首页显示出来。 - 打印
ctx.filesDir / cacheDir / tempDir / preferencesDir / databaseDir的真实路径,用hdc shell ls去设备上确认目录存在,并往 filesDir 写一个文件后hdc file recv拉回来。 - 把同一个 500KB 的 HAR 分别配置为 HAR 与 HSP,构建两次,对比
.app包体积差异,把数据记录下来(第 25 章包体优化会用到)。
下一章:ArkTS 语言本体——为什么它不是 TypeScript,以及所有
arkts-no-*错误的正确改写方式。