# 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` | 预加载库配置 |