3. 启动链路打点方案

3.1 关键节点定义

热启动优化首先需要明确“启动链路”中哪些位置是耗时瓶颈。打点方案围绕 Application 初始化、ContentProvider 加载、Activity 生命周期 和 首帧渲染 四个阶段展开。下表列出标准热启动链路中的关键打点节点：

3.2 打点 API 实现

打点 API 采用轻量、线程安全的设计，使用 System.nanoTime() 获取高精度单调时间戳。核心类 TimeMarker 提供实例化方法与批量上报接口：

public class TimeMarker {
    private final String tag;
    private final long[] timestamps;
    private final String[] eventNames;
    private int index = 0;

    public TimeMarker(int capacity, String tag) {
        this.tag = tag;
        timestamps = new long[capacity];
        eventNames = new String[capacity];
    }

    public void mark(String eventName) {
        if (index < timestamps.length) {
            timestamps[index] = System.nanoTime();
            eventNames[index] = eventName;
            index++;
        }
    }

    public List<TraceEvent> flush() {
        List<TraceEvent> events = new ArrayList<>(index);
        for (int i = 0; i < index; i++) {
            events.add(new TraceEvent(tag, eventNames[i], timestamps[i]));
        }
        index = 0; // 重置可重用
        return events;
    }
}

3.3 时间戳采集与存储

打点数据需要快速落盘，避免阻塞主线程。推荐使用 MMKV 或 DataStore 进行低延迟写入。以下为基于 MMKV 的存储实现：

public class TraceStorage {
    private static final String KEY_TRACE = "trace_events";
    private final MMKV mmkv;

    public TraceStorage() {
        mmkv = MMKV.defaultMMKV();
    }

    public void save(List<TraceEvent> events) {
        JSONArray array = new JSONArray();
        for (TraceEvent e : events) {
            JSONObject obj = new JSONObject();
            obj.put("tag", e.tag);
            obj.put("event", e.eventName);
            obj.put("time", e.timestamp);
            array.put(obj);
        }
        mmkv.encode(KEY_TRACE, array.toString());
    }

    public List<TraceEvent> load() {
        String raw = mmkv.decodeString(KEY_TRACE, "[]");
        // 解析 JSON 并还原事件列表
        // ...
        return events;
    }
}

在应用启动早期（如 Application.attachBaseContext()）初始化 MMKV，避免首次写入因初始化造成额外耗时。存储采用 JSON 格式便于调试，生产环境可替换为 Protobuf 压缩。

3.4 调试与验证

开发阶段可通过 adb shell dumpsys 观察打点是否生效，或使用自定义日志输出。以下命令可快速验证打点次数：

adb logcat -s TimeMarker:D
# 过滤打点日志，检查每个关键节点是否出现

更严谨的做法是通过 自定义 Instrumentation 在 CI 中自动校验打点完整性：

// 在测试中加载存储的事件列表
TraceStorage storage = new TraceStorage();
List<TraceEvent> events = storage.load();
Set<String> actualEvents = events.stream()
        .map(e -> e.eventName)
        .collect(Collectors.toSet());

assertTrue(actualEvents.contains("APP_CREATE_START"));
assertTrue(actualEvents.contains("FIRST_FRAME"));
assertTrue(actualEvents.contains("MAIN_ACTIVITY_CREATE"));

3.5 常见错误与优化

• 打点遗漏：未在 ContentProvider.onCreate() 中调用 mark()，导致 Provider 阶段数据缺失。建议在自定义 Application 的构造函数中统一注册打点。
• 时间戳溢出：nanoTime() 可能回绕（约 292 年），在超长运行应用中需注意比较逻辑，推荐使用相对差值而非值。
• 存储读取冲突：多个打点同时 flush() 导致数据覆盖。解决方案：对存储操作加锁或使用队列缓冲区。
• 性能开销：每个 mark() 调用约 0.1μs，不应出现显著性能问题。但若在循环高频调用，建议批量打点。

3.6 启动链路打点流程图