startup_appspawn/docs/recon.md

Recon: appspawn 仓库结构发现

1. 项目标识

• 名称: appspawn
• 仓库路径: base/startup/appspawn
• 版本控制: Git

---

2. 目录树（前3层，排除 test/.git/doc）

appspawn/
├── common/
│   ├── appspawn_server.c
│   ├── appspawn_server.h
│   ├── appspawn_trace.cpp
│   └── appspawn_trace.h
├── docs/
│   ├── modules/
│   │   └── module_*.md (12 个模块详情)
│   ├── architecture.md
│   ├── decomposition.md
│   ├── index.md
│   ├── quality_report.md
│   └── recon.md
├── etc/
│   └── sandbox/
├── figures/
├── interfaces/
│   └── innerkits/
│       ├── client/
│       ├── dec_util/
│       ├── hnp/
│       ├── include/
│       └── permission/
├── lite/
│   ├── appspawn_message.c
│   ├── appspawn_message.h
│   ├── appspawn_process.c
│   ├── appspawn_service.c
│   ├── appspawn_service.h
│   └── main.c
├── modules/
│   ├── ace_adapter/
│   ├── asan/
│   ├── common/
│   ├── module_engine/
│   │   ├── include/
│   │   └── stub/
│   ├── modulemgr/
│   ├── native_adapter/
│   ├── nweb_adapter/
│   ├── sandbox/
│   │   └── normal/
│   ├── spm/
│   └── sysevent/
├── service/
│   ├── devicedebug/
│   │   ├── base/
│   │   └── kill/
│   └── hnp/
│       ├── base/
│       ├── installer/
│       └── pack/
├── standard/
│   ├── appspawn_appmgr.c
│   ├── appspawn_fd_manager.c
│   ├── appspawn_fd_manager.h
│   ├── appspawn_kickdog.c
│   ├── appspawn_kickdog.h
│   ├── appspawn_main.c
│   ├── appspawn_manager.h
│   ├── appspawn_msgmgr.c
│   ├── appspawn_service.c
│   ├── appspawn_service.h
│   └── pid_ns_init.c
├── util/
│   ├── include/
│   └── src/
├── BUILD.gn
├── appspawn.gni
├── appspawn.cfg
├── appspawn.rc
├── bundle.json
├── appdata-sandbox*.json (多个沙箱配置)
├── appspawn_preload.json
└── README_zh.md

---

3. 文件统计

扩展名	文件数	估计代码行数
.c	43	~6,804
.h	43	(含在上述中)
.cpp	19	~21,697
.gn	20	未统计
.gni	3	未统计
.json	16	配置文件
.xml	1	OAT.xml
.py	1	脚本

总代码行数（.c + .h + .cpp）: ~28,501 行

---

4. 构建系统

• 构建系统: GN/Ninja (OpenHarmony 标准构建系统)
• 构建配置文件: BUILD.gn（根目录及各子目录），appspawn.gni（全局变量定义）
• bundle描述: bundle.json
• 编译选项定义: appspawn.gni 定义了 appspawn_innerkits_path、appspawn_path 等路径变量
• 条件编译标志: WITH_SELINUX、WITH_SECCOMP、CUSTOM_SANDBOX、NORMAL_SANDBOX、ALLOW_DUMPABLE

---

5. 编程语言

• 主语言: C (43 .c 文件) 和 C++ (19 .cpp 文件)
• 头文件: 43 .h 文件
• 领域特定语言: GN 构建脚本 (.gn/.gni), JSON 配置文件 (沙箱配置、预加载配置等)
• 脚本: Python (1 文件)

---

6. 顶层目录描述

目录	文件数	描述
common/	4	通用服务端代码（服务注册、trace 追踪）
docs/	30+	代码知识库（架构/模块详情/质量报告）
etc/	6	沙箱配置等 etc 文件
figures/	-	README 图片资源
interfaces/	15	对外接口：客户端 API、HNP API、权限接口
lite/	7	小型系统 appspawn 实现
modules/	62	模块化组件：沙箱、SPM、适配器、模块引擎等
service/	26	独立服务：HNP（原生包管理）、设备调试
standard/	12	标准系统 appspawn 核心实现
util/	8	工具类：错误码、JSON 工具、parcel 工具

---

7. 关键文件

文件路径	说明
standard/appspawn_main.c	标准系统 appspawn 主入口
standard/appspawn_service.c	标准系统核心服务实现
standard/appspawn_msgmgr.c	消息管理器，处理 IPC 请求
standard/appspawn_manager.h	核心管理器头文件，定义关键数据结构
lite/main.c	小型系统 appspawn 主入口
lite/appspawn_service.c	小型系统服务实现
interfaces/innerkits/include/appspawn.h	对外公共 API 头文件
interfaces/innerkits/client/appspawn_client.c	客户端实现
interfaces/innerkits/client/appspawn_msg.c	客户端消息构造
modules/modulemgr/appspawn_modulemgr.c	模块管理器
modules/module_engine/include/appspawn_hook.h	Hook 机制头文件
modules/sandbox/normal/sandbox_core.cpp	沙箱核心逻辑
modules/spm/spm.c	SPM（软件包管理器）权限管理
appspawn.gni	全局构建变量定义
BUILD.gn	根构建文件
bundle.json	OpenHarmony 部件描述文件
appspawn.cfg	appspawn 服务配置（init 脚本）
appdata-sandbox.json	沙箱配置（主文件）
appspawn_preload.json	预加载库配置