startup_appspawn/docs/modules/module_server_common.md

Module: server_common

返回: 索引

Overview

server_common 模块提供 appspawn 的通用服务端功能，包括服务创建（socket 监听）和性能追踪（HiTrace）。

Source Location

• Directory: common/
• Files: 2 C/C++ 源文件, 2 头文件
• Estimated LOC: ~600

Dependencies

• Depends on: util, interfaces/innerkits
• Used by: standard, lite

---

KP-1: AppSpawnContent 与服务创建

Priority: P2

Summary

appspawn_server.h 定义了 AppSpawnContent 结构体，这是 appspawn 服务的核心内容载体。AppSpawnCreateContent() 负责创建 socket 服务并初始化。

Key Code

AppSpawnContent 结构体

// common/appspawn_server.h:98
typedef struct AppSpawnContent {
    char *longProcName;
    uint32_t longProcNameLen;
    uint32_t sandboxNsFlags;
    int wdgOpened;
    bool isLinux;
    int sandboxType;
    RunMode mode;
    int signalFd;
    char *propertyBuffer;       // 共享内存映射（prefork 用）
    pid_t reservedPid;          // prefork 预留 PID
    int enablePerfork;          // 是否启用 prefork
    struct TagSandboxQueue *permissionQueue;
    // 函数指针表
    void (*runAppSpawn)(struct AppSpawnContent *, int, char *const []);
    void (*notifyResToParent)(struct AppSpawnContent *, AppSpawnClient *, int);
    int (*runChildProcessor)(struct AppSpawnContent *, AppSpawnClient *);
    int (*coldStartApp)(struct AppSpawnContent *, AppSpawnClient *);
} AppSpawnContent;

AppSpawnContent 使用函数指针表实现多态：不同的孵化模式（appspawn/nwebspawn/cold run）设置不同的函数实现。

---

KP-2: 性能追踪

Priority: P2

Summary

appspawn_trace.cpp 提供 HiTrace 集成，用于性能分析。

Key API

• StartAppspawnTrace(name): 开始 trace 区间
• FinishAppspawnTrace(): 结束 trace 区间

---

Key Data Structures

Structure	File	Purpose
AppSpawnContent	appspawn_server.h:98	服务内容（函数指针表模式实现多态）
RunMode	appspawn_server.h:33	运行模式枚举
AppSpawnClient	appspawn_server.h:66	客户端标识

Cross-Module Interactions

Interaction	With Module	Mechanism	Direction
创建服务	standard	AppSpawnCreateContent	Incoming
函数指针回调	standard	runAppSpawn/runChildProcessor	Outgoing

---

Related Modules

Module	Relationship	Link
standard	used_by	module_standard.md
util	depends_on	module_util.md

另见: 本模块与上述模块存在依赖关系。具体交互细节请参考 系统架构 中的跨模块关系章节。