title: App 启动路径、监控与度量 chapter: '21.1' section: '21.1' status: finalized applicable_versions: Android 10 (API 29) - Android 17 (API 37) last_verified: '2026-09-01' last_verified_against: AOSP android-17.0.0_r1 / Android 17 (API 37); ActivityThread/ViewRootImpl/ApplicationStartInfo/ActivityManager/AppStartInfoTracker timestamp boundaries; Android Developers launch-time, StartupTimingMetric, ApplicationStartInfo, ActivityManager and FullyDrawnReporter docs; PerfettoSQL standard library checked 2026-09-01; no Android 18/API 38+ conclusions confidence: medium-high sources:

• type: aosp path: frameworks/base/core/java/android/view/ViewRootImpl.java
• type: official path: https://developer.android.com/topic/performance/vitals/launch-time
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/app/ActivityThread.java
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/view/ViewRootImpl.java
• type: official path: https://developer.android.com/topic/performance/benchmarking/macrobenchmark-overview
• type: official path: https://developer.android.com/topic/performance/appstartup/analysis-optimization
• type: official path: https://developer.android.com/reference/androidx/benchmark/macro/StartupTimingMetric
• type: official path: https://developer.android.com/reference/android/view/ViewTreeObserver
• type: official path: https://perfetto.dev/docs/data-sources/atrace
• type: official path: https://perfetto.dev/docs/analysis/stdlib-docs
• type: official path: https://developer.android.com/reference/android/app/Activity#reportFullyDrawn()
• type: official path: https://developer.android.com/topic/performance/tracing/profiling-manager/how-to-capture
• type: aosp path: frameworks/base/core/java/android/app/ApplicationStartInfo.java (android-17.0.0_r1)
• type: aosp path: frameworks/base/core/java/android/app/ActivityManager.java (android-17.0.0_r1)
• type: official path: https://developer.android.com/reference/android/app/ApplicationStartInfo
• type: official path: https://developer.android.com/reference/android/app/ActivityManager
• type: official path: https://developer.android.com/reference/androidx/activity/FullyDrawnReporter
• type: aosp path: frameworks/base/core/java/android/app/Activity.java (android-17.0.0_r1)
• type: aosp path: frameworks/base/services/core/java/com/android/server/am/AppStartInfoTracker.java (android-17.0.0_r1)
• type: official path: https://perfetto.dev/docs/analysis/stdlib-docs#android-startup-startups
• type: clippings-structure-ref path: Clippings/Android 性能优化 - 原理：重新认识应用的速度优化.md
• type: clippings-structure-ref path: Clippings/Android 性能优化 - 如何通过 GC 抑制来提升启动速度？.md
• type: clippings-structure-ref path: Clippings/Android 性能优化 - CPU 优化（下）：减少 CPU 闲置时刻和等待，提升利用率.md
• type: clippings-structure-ref path: Clippings/Android 性能优化 - 任务调度优化：线程+CPU，提升任务调度优先级.md tags:
• cold-start
• warm-start
• hot-start
• ttid
• ttfd
• startup-trace
• perfetto
• startup-monitoring
• metrics
• p50
• p90
• regression
• android-vitals related_chapters:
• '8.2'
• '8.3'
• '1.5'
• '1.3'
• '21.2'
• '26.1'
• '16.3' pipeline_stage: finalized task6_state: reviewed task9_state: reviewed task2b_state: fixed last_idle_audit_at: '2026-09-01T14:41:39+08:00' last_idle_audit_run_id: 20260901-143528-idle-audit-653f8d66 last_consolidated_at: '2026-08-24' consolidated_from:
• src/part5-app/ch21-startup/17-startup-insights-api-observability.md
• src/part5-app/ch21-startup/09-startup-case-studies.md#一份可直接使用的复盘模板
• src/part5-app/ch21-startup/01-startup-analysis.md
• src/part5-app/ch21-startup/08-startup-monitoring.md

App 启动路径、监控与度量

从应用进程一侧分析启动，需要确认系统什么时候把执行权交给应用、关键路径包含哪些阶段，以及 Trace（带时间轴的执行跟踪）中一段区间究竟代表什么。系统侧的进程创建、任务与窗口管理另见 8.2 节；初始化依赖治理、Baseline Profile 和首帧渲染分别在后续章节展开。

平台源码锚点为 Android 17 / API 37 / android-17.0.0_r1。AndroidX 与 Perfetto 属于独立发布的工具链，相关内容会明确它们与平台版本的边界。

应用启动从用户或系统请求开始，经过进程创建、bindApplication、组件生命周期和首帧显示。监控需要同时记录启动类型、起止点、关键阶段和设备状态，避免只上报一个总时长。

进程创建、初始化与首帧阶段

1. 冷、温、热描述的是启动前状态

Android 应用启动文档把启动分为 cold、warm、hot。三者概括的是启动前进程、Activity 和 UI 对象是否仍然存在；生命周期回调会随任务状态变化。

同一个入口在不同时间可能落入不同类型。用户从桌面点击、通知跳转、深链、最近任务恢复，也可能命中不同 Activity 和任务栈。只看 onCreate() 是否调用，无法可靠判断平台记录的启动类型。

工程上要区分两件事：

• 实验分类：Macrobenchmark 的 StartupMode.COLD/WARM/HOT 用固定前置条件构造可比较样本。
• 线上分类：使用平台或 Play 的启动指标，并按入口、进程、版本和设备分组；Android 15+ 的 ApplicationStartInfo 可提供系统记录的启动类型，应用自有“进程首次启动”标记只能辅助解释。采集方法见本文后半篇。

不要用“温启动一定是冷启动的某个百分比”或“热启动一定小于一帧”作为基线。后台回收、配置变化、首屏数据、CPU 调频和页面重绘都会改变成本。

2. Android 17 冷启动的 App 侧路径

2.1 从启动请求到应用主线程

冷启动开始时，系统解析启动请求、准备任务与 starting window（应用首帧完成前由系统显示的启动窗口），并请求 Zygote fork 应用进程。Zygote 是预加载常用框架类的进程模板，fork 会从它派生新的 Linux 应用进程。这个阶段已经计入用户看到的启动等待，但应用自己的 Application 埋点还没有运行。

子进程进入 ActivityThread.main() 后，会准备主线程 Looper（按顺序取出并分发消息的事件循环）、创建 ActivityThread，再通过 Binder（Android 跨进程调用机制）向 system_server（承载主要系统服务的进程）登记。后续绑定信息和生命周期事务被送回应用主线程。对应用开发者而言，这段路径有两个含义：

1. Application.attachBaseContext() 不是整个冷启动的起点，早于它的系统与进程初始化同样消耗 TTID。
2. 只汇总应用内埋点会漏掉进程创建、调度等待、系统服务和跨进程通信时间。

2.2 ContentProvider 早于 Application.onCreate()

Android 17 的 ActivityThread.handleBindApplication()按以下关键顺序执行：

创建并 attach Application
        ↓
installContentProviders(app, data.providers)
        ↓
Instrumentation.onCreate(...)
        ↓
Instrumentation.callApplicationOnCreate(app)

这段顺序说明，自动初始化 Provider 的 onCreate() 位于应用 Application.onCreate() 之前。Instrumentation 是框架用来创建和驱动应用组件的入口。仅给 Application.onCreate() 计时会漏掉 App Startup、第三方 SDK 或业务 Provider 的成本。

Application.attachBaseContext() 到 Application.onCreate() 之间可能包含：

• Provider 类加载、静态初始化与 onCreate()；
• 配置和资源初始化；
• instrumentation 初始化；
• 主线程上的 Binder、文件、数据库和锁等待。

Provider 治理见 ContentProvider 启动优化。多进程应用还要核对每个 Provider 的 android:process：默认进程的 Provider 不会自动在每个子进程各运行一次，声明到某个进程的组件只随对应进程安装。

2.3 Application 阶段

Application.onCreate() 在主线程同步执行。适合保留在这里的工作应同时满足：

• 当前进程需要；
• 当前入口需要；
• 在 Activity 或首帧之前必须完成；
• 能在给定主线程预算内结束；
• 不依赖不受控的网络或长时间锁等待。

常见长任务包括 SDK 初始化、同步数据库打开、反序列化大配置、原生库加载和批量对象构造。把它们全部提交到后台线程也可能延迟启动：主线程若随后等待结果，关键路径没有缩短；如果不等待，后台 CPU、I/O 和类加载仍会与首帧争用资源。

对于 minSdkVersion >= 21 的应用，平台原生支持从多个 DEX 加载类，不需要在 Application 中调用旧版 MultiDex.install()。只有仍支持 API 20 及以下的应用才需要单独审视这条兼容路径。

2.4 Activity 创建与 UI 构建

应用收到启动 Activity 的 lifecycle transaction（系统发给应用主线程的一组生命周期操作）后，框架创建 Activity，并根据目标状态执行 onCreate()、onStart()、onResume() 等回调。不要把这串回调当作所有启动的恒定路径；已有 Activity 回前台、配置变化和任务恢复会走不同组合。

View UI 的 setContentView() 会触发布局 XML 解析、View 创建和属性解析。Compose UI 则在 setContent 后经历初始 composition（执行 Composable 并建立 UI 结构）、layout 和 draw。两种 UI 技术都要关注：

• 是否在主线程读取磁盘或等待 Binder；
• 图片解码、字体和资源是否进入首帧关键路径；
• 首屏不可见区域是否提前创建；
• 自定义 View 构造、onMeasure()、onLayout()、onDraw() 是否执行重活；
• Compose 的首轮 composition 是否创建过多对象或读取未准备好的状态。

View 数量、布局深度或 Composable 数量都没有通用的危险阈值。Trace 中的耗时和调用路径才是优化依据。ViewStub（需要时才展开布局的占位 View）、条件 composition、懒加载或异步 inflate（在允许范围内把 View 创建移出主线程）也各有语义限制，采用前要验证线程安全、状态恢复和首屏交互。

2.5 第一帧从 traversal 到系统确认绘制

主线程在 VSync（显示刷新节奏信号）驱动下进入 Choreographer#doFrame，执行 traversal，也就是对 View 树完成 measure、layout 和 draw。硬件加速路径中，UI 线程记录绘制命令，RenderThread 与 GPU 继续处理渲染，图形 buffer 再交给系统合成路径。

Android 17 的 ViewRootImpl在首次绘制请求完成后走 reportDrawFinished(...) 路径，窗口系统据此结束对应的启动绘制等待。需要区分几个相邻观测点：

帧预算取决于刷新率、FrameTimeline deadline（这一帧应完成的时间点）和渲染流水线阶段，不能一律写成 16 ms。120 Hz 显示器的节奏与 60 Hz 不同，一次 traversal 跨过某个 VSync 也要结合目标时间线和实际时间线判断是否错过 deadline。

3. TTID 与 TTFD 回答不同问题

3.1 TTID：首个 UI 帧

TTID（Time To Initial Display）从系统收到启动请求开始，直到目标 Activity 的第一帧被记录为已显示。它包含冷启动时的进程创建，也包含冷/温启动时的 Activity 创建和首帧工作。

TTID 很短只能说明用户很快看到一个应用帧。该帧可能仍是骨架、空列表或占位内容。系统 SplashScreen 的持续时间、应用第一帧和主要内容可用时间也不能混为一个数字。

Logcat 中的 Displayed ... +...、adb shell am start -W 和 Perfetto 都能帮助本地诊断。命令行结果会受到任务栈、是否 force-stop、编译状态和设备状态影响，不应把一次 am start -W 当成发布门禁。

Android vitals（Google Play 汇总的真实设备质量指标）当前把冷启动 5 秒、温启动 2 秒、热启动 1.5 秒及以上列为 excessive。它们是 Play 的告警边界，不是优秀体验的目标值。应用自己的预算应按入口、设备档位和产品体验设得更严格。

3.2 TTFD：由应用声明“主要内容可用”

TTFD（Time To Fully Drawn）从同一启动请求开始，到应用调用 reportFullyDrawn()，并完成包含该报告的帧。StartupTimingMetric 的 timeToFullDisplayMs 在 API 29 以前可能不可用；API 29 是该指标的适用起点。

平台不知道每个产品何时“可用”，因此团队必须先定义完成条件。例如：

• 首页主列表已经展示本地缓存或网络数据；
• 关键按钮可点击，必要依赖已经准备好；
• 错误态或离线态也已形成可操作界面；
• 不影响首要任务的推荐、广告或二级卡片不进入条件。

下面的示例把“关键数据就绪”和“主内容完成布局”作为报告条件：

class MainActivity : ComponentActivity() {
    private var criticalDataReady = false
    private var mainContentLaidOut = false
    private var fullyDrawnReported = false

    private fun maybeReportFullyDrawn() {
        if (criticalDataReady &&
            mainContentLaidOut &&
            !fullyDrawnReported
        ) {
            fullyDrawnReported = true
            reportFullyDrawn()
        }
    }
}

criticalDataReady 和 mainContentLaidOut 应由对应状态与布局回调更新，每次更新后调用 maybeReportFullyDrawn()。报告只发送一次；完成条件应覆盖成功、离线和可恢复错误，避免网络失败后永远没有 TTFD。若调用发生在首帧之前，平台会以系统检测到的首帧时间为下限，因此提前调用不会生成比 TTID 更早的有效 TTFD。

AndroidX ComponentActivity 的 Fully Drawn 支持可协调多个组件或异步条件。无论使用平台方法还是 AndroidX 封装，团队都要把“fully drawn”定义写进测试，避免不同页面各自解释。

3.3 自定义里程碑：解释 TTID/TTFD 内部时间

TTID 和 TTFD 是端到端指标，无法直接说明慢在哪里。应用可补充少量稳定里程碑：

• Application attach；
• 每个必要初始化器的开始和结束；
• Activity 创建、UI 状态提交；
• 关键数据可用；
• 主要内容完成布局；
• reportFullyDrawn() 请求。

区间计时优先使用单调时钟，也就是只向前推进、不受用户改时或网络校时影响的时钟。SystemClock.uptimeNanos() 不计深度休眠，适合进程内 CPU/主线程工作区间；elapsedRealtimeNanos() 计入深度休眠，并在同一设备上提供自开机以来的时间基准。System.nanoTime() 只保证用于计算同一运行环境中的时间差，不应依赖它的绝对起点。

埋点名称要稳定，可能出现的名称数量也要受控；监控系统把这种取值数量称为基数。不要把用户 ID、URL 或动态参数写入 Trace 名称。线上事件还需采样，并记录启动入口、应用版本、设备档位、编译状态和进程名。

4. 用 Macrobenchmark 建立启动基线

Macrobenchmark从目标应用进程外驱动启动，并为每轮采集 Perfetto Trace。它比在 Application 内自行计时更适合端到端回归。目标应用需要可 profile，即通过 android:profileable 允许性能工具读取接近发布配置的跟踪数据。

下面的基准用于测量带有 Baseline Profile 的冷启动：

@LargeTest
@RunWith(AndroidJUnit4::class)
class StartupBenchmark {
    @get:Rule
    val rule = MacrobenchmarkRule()

    @Test
    fun coldStart() = rule.measureRepeated(
        packageName = TARGET_PACKAGE,
        metrics = listOf(StartupTimingMetric()),
        compilationMode = CompilationMode.Partial(
            baselineProfileMode = BaselineProfileMode.Require,
        ),
        startupMode = StartupMode.COLD,
        iterations = 10,
        setupBlock = {
            pressHome()
        },
    ) {
        startActivityAndWait()
    }
}

StartupTimingMetric输出 timeToInitialDisplayMs；应用正确报告 fully drawn 时，还会输出 timeToFullDisplayMs。十次迭代只是一组起始配置，应根据噪声、设备数量和需要检测的回归幅度调整。

每次对比必须固定：

• 同一 release 配置和构建工具链；
• 相同 CompilationMode 与 Baseline Profile 条件；
• 相同入口 Intent、账号、数据和网络桩（测试中返回固定结果的网络替身）；
• 相同设备型号、系统版本、电量与温度范围；
• 相同冷/温/热模式。

Debug 包、模拟器、低电量或温度降频样本不适合建立发布阈值。遇到 profileable、Baseline Profile 或编译模式配置错误时，应让测试失败并修正配置，不能忽略错误后继续使用结果。

冷、温、热三组结果要分别保存。页面结构或首屏数据变化时，还要同时检查 TTFD 和帧指标，防止用更早展示空壳换取较短 TTID。

5. 自定义 Trace 应围绕业务边界

应用控制的初始化入口可以用 androidx.tracing 补充切片。下面的示例用于区分配置解析与崩溃监控初始化：

fun initializeRequiredComponents() {
    trace("startup/config") {
        configStore.loadLocalSnapshot()
    }
    trace("startup/crash-reporter") {
        crashReporter.start()
    }
}

Perfetto 中会显示两个命名切片；切片是时间轴上带开始、结束和名称的一段区间。它要包住同步工作本身；如果代码只提交异步任务，切片结束仅代表“已提交”，不能代表初始化完成。等待异步结果时，应在生产者和消费者两端记录可关联的 async trace，或用 flow（连接两个切片的因果箭头）标出任务从提交到执行的关系，并控制关联 ID 的数量。

Trace 本身有开销。不要为每个小方法加切片，也不要只凭一个总切片判定责任。较好的层级是：

1. 启动端到端指标；
2. Application、Provider、Activity、首帧等阶段；
3. 少量可行动的业务或 SDK 边界；
4. 出现回归后再采集方法栈、Binder 或 I/O 细节。

6. Perfetto 启动分析实战

6.1 获取一条可复现的 Trace

推荐路径是运行 Macrobenchmark，并打开某次迭代生成的 .perfetto-trace。这样启动模式、编译模式和操作脚本与指标结果属于同一个样本。

需要手工捕获时，可以在 Perfetto UI 或设备“系统跟踪”中启用 sched、freq、am、wm、gfx、view、binder_driver、dalvik 等设备支持的类别，并指定目标应用。这些类别分别提供调度、CPU 频率、Activity/Window、图形、View、Binder 和 ART 等事件；应用自定义 Trace 切片还要通过 atrace_apps 指定允许采集的包名。

下面的 pbtxt（Protocol Buffer 文本配置）是一份诊断起点，目标包名应替换为被测应用：

duration_ms: 15000
buffers {
  size_kb: 65536
  fill_policy: RING_BUFFER
}
data_sources {
  config {
    name: "linux.ftrace"
    ftrace_config {
      ftrace_events: "sched/sched_switch"
      ftrace_events: "sched/sched_wakeup"
      ftrace_events: "power/cpu_frequency"
      ftrace_events: "binder/binder_transaction"
      ftrace_events: "binder/binder_transaction_received"
      atrace_categories: "am"
      atrace_categories: "wm"
      atrace_categories: "gfx"
      atrace_categories: "view"
      atrace_categories: "dalvik"
      atrace_apps: "com.example.app"
    }
  }
}

把配置通过 adb shell perfetto --txt -c - -o /data/misc/perfetto-traces/startup.perfetto-trace 传入后，在另一终端按明确前置条件启动应用，再 pull Trace。pbtxt 文本模式适合诊断；Perfetto 文档提示它不是面向生产的稳定接口，自动化基准优先使用 Macrobenchmark。

类别和 tracepoint（内核或系统组件预先定义的跟踪事件）受设备内核及版本影响。采集前用 Perfetto UI 或设备支持列表确认，缺少某个事件时不要把它解释为对应工作没有发生。

6.2 先选中 Android App Startups

打开 Trace 后，先找到 Android App Startups 派生轨道。派生轨道是 Trace Processor 根据原始事件计算出的分析结果；选中目标包的启动 slice，再固定该时间窗口。它给出的启动边界比手工搜索第一个 performTraversals 更可靠。

随后按这条顺序阅读：

1. system_server：启动请求、进程创建、任务和窗口事件。
2. 应用主线程：bindApplication、Provider/Application、自定义切片、Activity lifecycle。
3. 线程状态：Running、Runnable、Sleeping、Blocked 以及对应唤醒者。
4. RenderThread 与 FrameTimeline：首帧的 CPU/GPU 工作和 deadline。
5. 相关线程/进程：Binder 对端、I/O、编译、GC 或 SDK 工作线程。

平台 slice 名称是诊断实现，不是公开 API。名字在不同 Android/Perfetto 版本间可能变化，自动化查询应优先使用 Trace Processor 标准库和自有稳定切片。

6.3 分解主线程的“运行”和“等待”

看到一段长主线程 slice 后，先展开 thread state：

• Running：线程正在 CPU 上运行，继续查看调用栈、类加载或计算。
• Runnable：线程可运行但未获 CPU，检查 CPU 竞争、优先级、频率与其他活跃线程。
• Sleeping：可能在等待 Binder、futex（内核提供的用户态同步等待机制）、I/O 或条件变量，要沿唤醒关系找生产者。
• Uninterruptible Sleep：常与内核 I/O 等待有关，需要结合块设备和文件事件。

不存在“Runnable 低于 70% 就是异常”这类通用判据。主线程同步等待 5 ms 可能卡住关键路径，后台线程消耗大量 CPU 也可能让主线程长时间处于 Runnable。判断依据是关键路径上的墙钟时间，也就是现实经过时间，以及任务之间的依赖关系。

6.4 阅读 bind、Activity 和首帧

bindApplication 较长时，依次检查：

• Provider 自动初始化；
• Application attach/onCreate 自定义切片；
• 类加载、验证、静态初始化；
• GC、锁等待和 Binder；
• 主线程文件 I/O；
• 同期后台线程的 CPU/I/O 竞争。

Activity 阶段较长时，检查 View inflate 或 Compose 初始 composition、图片/字体、同步状态恢复和首屏数据绑定。单看 Activity.onCreate() 总时间不够，应该把可修改的业务边界标出来。

首帧阶段同时观察主线程 Choreographer#doFrame/traversal、RenderThread 和 FrameTimeline。performTraversals 结束只能当作主线程 traversal 的边界，不能作为 TTID 终点；也不能默认第一次同名 slice 就属于目标窗口。

6.5 用标准库批量列出启动

当前 Trace Processor 标准库提供 android.startup.startups 模块。标准库是随 trace_processor 版本发布的一组 PerfettoSQL 表、视图和函数。下面的查询用于列出目标包在一条 Trace 中的启动类型和持续时间：

INCLUDE PERFETTO MODULE android.startup.startups;

SELECT
  startup_id,
  package,
  startup_type,
  dur / 1e6 AS duration_ms
FROM android_startups
WHERE package = 'com.example.app'
ORDER BY ts;

这个查询使用派生启动表，不依赖 bindApplication 等裸 slice 是否存在。结果是 Trace Processor 对启动窗口的解析，仍应与 Macrobenchmark 报告和界面中的目标启动核对。

下面的查询用于查看目标启动窗口内耗时较长的主线程 slice：

INCLUDE PERFETTO MODULE android.startup.startups;

SELECT
  s.startup_id,
  s.slice_name,
  s.slice_dur / 1e6 AS duration_ms
FROM android_thread_slices_for_all_startups AS s
JOIN android_startups AS a USING (startup_id)
WHERE a.package = 'com.example.app'
  AND s.is_main_thread
  AND s.slice_dur >= 5e6
ORDER BY s.startup_id, s.slice_dur DESC;

5 ms 只是缩小诊断结果的查询过滤器，不是性能合格线。当前标准库文档已把 android_thread_slices_for_all_startups 标为通常不应直接使用的底层视图；上面的查询适合固定 trace_processor_shell 版本后的临时排查。长期 CI 应优先采用 android_slices_for_startup_and_slice_name(...)、android_startup_opinionated_breakdown 等公开函数或表，并为查询 schema（列名与类型约定）编写测试。

7. ClassLoader、编译状态与 DEX 布局

7.1 类首次使用仍可能进入启动关键路径

应用类通常由 ClassLoader（按名称查找并装入类定义的加载器）按需加载。首次主动使用一个类时，运行时可能需要查找定义、加载、验证、解析，并在需要时执行 <clinit>（类的静态初始化方法）。其中一部分工作可由安装期 AOT（提前编译）、运行时缓存或已有编译产物减少，但静态初始化中的应用代码仍会执行。

启动阶段要关注：

• 反射或 ServiceLoader 扫描大量类；
• 一个入口触发长依赖链的类初始化；
• <clinit> 读取文件、创建线程或加载 native library；
• 多个 SDK 同时加载重复的框架与序列化类型；
• 编译条件不同导致解释执行、JIT（运行时即时编译）或 AOT 路径不同。

ApplicationLoaders 的缓存属于进程内状态。冷启动意味着旧应用进程不存在，不能依靠它让下一次冷启动“直接命中”。多次冷启动越来越快，可能来自 Linux page cache（内核保留的文件页缓存）、ART 编译产物、应用磁盘缓存、设备频率或数据状态变化，因此基准必须控制编译与缓存条件。

7.2 Baseline Profile 与 Startup Profile 分工

两类 profile 解决的问题不同：

• Baseline Profile向 ART 提供关键类和方法，帮助安装/后台优化时进行 AOT 编译，减少关键路径上的解释与 JIT。
• Startup Profile面向 DEX 布局，把启动所需代码组织到主 DEX 的相邻区域；读取相邻数据所需的文件页更集中，这就是这里的读取局部性。

Baseline Profile 不会跳过业务初始化，也不会消除磁盘、Binder、锁或网络等待；Startup Profile 也不等于“把类放到文件前面就会进入 CPU cache”。它影响的是 DEX 文件组织和读取局部性，收益要用固定编译模式的启动基准验证。

两者的实践统一见 Baseline Profile 与 Startup Profile 实战。启动期 ART/GC 行为见 ART GC 启动期开销与分配治理。

8. 从 Trace 到修复的判断顺序

面对一条慢启动样本，可以按以下顺序推进：

1. 确认启动类型、入口、编译模式、设备状态和 TTID/TTFD。
2. 选中 Android App Startups 时间窗，判断延迟位于系统、bind、Activity 还是首帧。
3. 查看主线程是 Running、Runnable 还是等待，并追到依赖线程或 Binder 对端。
4. 用自定义切片、调用栈、I/O 或 GC 数据缩小到可修改代码。
5. 判断工作是否属于首屏必要条件；能移除就移除，能按需就按需，必须保留才考虑并发和局部优化。
6. 运行同配置 A/B Macrobenchmark，并检查 TTID、TTFD、帧和功能正确性。
7. 在小流量发布的线上数据中，按入口、设备、版本和启动类型确认回归消失。

启动优化不能只追求更早撤掉 SplashScreen。用户需要的是更快看到可理解、可操作且状态正确的内容；TTID、TTFD 和关键页面帧必须一起看。

启动类型、时间点与线上指标

启动路径给出可测阶段，监控系统负责稳定采集并按冷、温、热启动和版本分层。TTID 与 TTFD 也要分开。

为什么启动监控需要独立设计

启动监控要回答两个问题：改动发布后，用户启动体验是否变差；出现变化后，怎样定位到版本、入口、设备和初始化任务。

只在 Application.onCreate() 入口与出口记录时间不够。这个区间看不到系统收到启动请求、创建进程、调用 bindApplication、安装 ContentProvider（内容提供者）和显示首帧的过程，也无法表达首屏核心内容何时可用。完整方案需要三类数据互相校准：

冷启动表示系统需要从头创建 App 进程；热启动时进程和目标 Activity 仍在内存中，只需把它带回前台；温启动介于两者之间，系统保留了部分状态，但仍要重新执行部分 Activity 或进程创建工作。三种状态走过的代码不同，必须分开统计。

线上监控负责发现耗时分布变化；Macrobenchmark（AndroidX 宏基准测试库）负责在固定设备和条件下重复对比；Perfetto（Android 系统级时间线分析工具）负责解释一次启动中的线程、Binder 进程间调用、I/O（存储读写）和调度证据。三者用途不同：一条线上 P90（90% 的样本不超过的耗时）曲线不能代替时间线，一次时间线也不能代表全量用户的耗时分布。

1. 先固定测量契约

这里的“测量契约”指一项指标固定不变的定义：起点、终点、适用启动类型、缺失条件和失败样本处理方式都要写清。名称相同但边界不同的数据不能放进同一条曲线。

1.1 TTID、TTFD 与业务 ready

TTID 是 Time to Initial Display，即从启动请求到首次显示；TTFD 是 Time to Full Display，即从启动请求到 App 声明主要内容已完整可用。它们都是 Android 的平台口径，“业务 ready”则是团队为某个页面定义的可用条件。

TTID 只说明第一帧出现。骨架屏、空列表或不可点击的占位页也可能已有 TTID。TTFD 需要团队给每个首屏入口定义“可用”：例如首页主导航可操作且首批必要数据已展示，支付页已完成本地安全状态检查，拍摄页预览已可用。广告、推荐流后续分页和不影响首个操作的后台刷新通常不应延长 TTFD。

Activity.reportFullyDrawn() 是一次性启动信号。Android 17 的 Activity 实现由内部标记 mDoReportFullyDrawn 控制：第一次有效调用会经 ActivityClient 报给系统，后续调用被忽略。若调用发生在系统确认第一帧之前，平台会把 TTFD 记为 TTID，因此过早上报会让两个值相同，失去“内容完成”的区分能力。

1.2 使用同一种时钟

耗时计算使用单调时钟，即只向前推进、不受用户改时间或时区变化影响的计时源。Android 17 的 ApplicationStartInfo 系统时间戳在 Activity launch、fork、bindApplication、首帧和 fully drawn 路径中使用 SystemClock.uptimeNanos()；通过 ActivityManager.addStartInfoTimestamp() 写入同一启动记录的自定义点也应使用同一时基。只在 App 自有遥测内计算同设备会话耗时时，可以另用 SystemClock.elapsedRealtimeNanos()，但不要把它和平台启动记录中的 uptimeNanos() 节点相减。System.nanoTime() 只保证用于计算同一运行环境中的时间差，不应依赖它的绝对起点。

System.currentTimeMillis() 会受到用户改时、网络校时和时区变化影响，适合记录事件发生的墙钟时间，不适合相减得到启动耗时。一个事件可以同时保存：

• event_wall_ms：用于版本发布、分批放量（灰度）和配置变更对齐；
• event_elapsed_ns：用于同一台设备本次启动内的阶段耗时；
• duration_ms：端侧完成边界检查后生成，服务端不跨设备相减单调时钟。

1.3 启动样本的身份

同一设备可能由桌面图标、deep link（直接打开特定页面的链接）、通知、桌面小组件 Widget、Service、Broadcast 或 Provider 启动；多进程 App 还会产生多个进程启动记录。每条样本至少携带：

入口 URL、Intent extras（附加参数）、用户 ID 和页面原始参数不应上传。路由、设备和任务名应转换成有限的受控枚举；确需用哈希关联事件时，应使用服务端可轮换密钥生成的伪匿名标识，并评估它是否仍属于个人数据，不能把普通哈希当成匿名化。更完整的采集规则见 性能指标采集与上报。

2. 端侧埋点怎样放

2.1 不为“更早”新增 Provider

ContentProvider 会在 Application.onCreate() 之前安装。若为了“尽早监控”新增自动初始化 Provider，监控 SDK（Software Development Kit，软件开发工具包）的类加载和初始化也会进入每次冷启动的关键路径。已有 Provider 即使负责记录最早入口，也只应保存一个时间戳和必要身份；序列化、压缩、网络发送与扩展设备信息都应延后。

推荐点位如下：

onResume() 不等于首帧。ViewTreeObserver.OnPreDrawListener 发生在即将绘制之前；Choreographer.FrameCallback 是 UI 帧调度回调。两者都不能证明 SurfaceFlinger 已经把像素显示到屏幕。App 可以把它们当作自定义近似点，但事件名必须写成 pre_draw 或 frame_callback，不能冒充平台 TTID。

2.2 准确上报 fully drawn

在多处直接调用 reportFullyDrawn()，很容易由最早完成的模块提前上报。ComponentActivity 的 FullyDrawnReporter 可以登记多个 reporter（“尚未就绪”的占位计数）；所有 reporter 都释放后，它才在下一动画帧调用平台 API。至少使用一次 addReporter() 或 reportWhenComplete()，这个协调器才会代为上报。

下面的 ViewModel（跨配置变化保存页面状态的 Jetpack 组件）示例用于等待首屏核心数据完成，再由 FullyDrawnReporter 安排上报：

class HomeActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_home)

        lifecycleScope.launch {
            fullyDrawnReporter.reportWhenComplete {
                viewModel.uiState
                    .filterIsInstance<HomeUiState.Ready>()
                    .first()
            }
        }
    }
}

reportWhenComplete 会在挂起任务执行期间持有一个 reporter，等到 Ready 后释放；全部 reporter 都释放后，FullyDrawnReporter 在下一动画帧调用 reportFullyDrawn()。异常与永久 loading（一直停留在加载态）必须有业务降级或超时，否则 TTFD 会长期缺失。缺失样本要单独统计，不能悄悄从总样本数中删除。

Jetpack Compose 首屏可以把同一条 ready 规则放进 ReportDrawnWhen；它会在条件为 true 前延迟 fully drawn 上报：

@Composable
fun HomeRoute(state: HomeUiState) {
    ReportDrawnWhen {
        state is HomeUiState.Ready &&
            state.primaryItems.isNotEmpty()
    }

    HomeScreen(state)
}

这个条件应表示用户已能完成首个核心操作。若空列表是合法结果，判断条件要表达“数据请求已完成”，不能用 isNotEmpty() 让合法空态永远不报告。

2.3 慢任务需要时间线，不只需要总耗时

每个启动任务应记录受控的任务名、调度线程、依赖、开始/结束、结果和是否位于首帧前。对高频短任务，记录动作本身可能比任务还耗时，可以只保留汇总计数，或只在被抽中的慢启动诊断样本里记录细节。

自定义 trace 与统计事件分工如下：

• 统计事件保留每次启动的稳定字段与耗时，用于计算全体样本的分布；
• Trace.beginSection() / Trace.endSection() 或 AndroidX Tracing 在系统时间线上标记阶段，用于在 Perfetto 中对齐主线程、Binder、I/O 和调度；
• 不上传任意类名、SQL、URL 或用户内容作为 trace 名；
• section 必须严格配对，名称集合要有上限；若把用户输入或 URL 拼进名称，会产生近乎无限的不同值，使存储和聚合失控。

采集器不能在首帧前创建大线程池、扫描完整设备信息或同步写日志文件。启动事件先写入内存队列或受控的小型本地记录，首帧后批量编码；网络发送由既有后台上报机制处理。

3. Android 17 的 ApplicationStartInfo

Android 15（API 35）加入 ApplicationStartInfo：它是一份由系统逐步补全的进程启动记录，App 可通过 ActivityManager 查询。到 Android 17 / API 37，这组 API 可以给出 App 自己难以准确记录的系统侧信息：

• getProcessName()、PID（进程编号）与 UID（Linux 用户身份）；
• getReason()：启动 Activity、Service、Provider、Broadcast、Job、Push、闹钟、备份等触发原因；
• getStartType()：cold、warm、hot；
• getStartupState()：记录仍在启动、发生错误或已经画出首帧；
• getStartupTimestamps()：launch、fork、bindApplication、Application.onCreate、first frame、fully drawn 等单调时间戳；
• getStartComponent()：Android 16（API 36）加入，用于区分 Activity、Service、Broadcast 和 Provider。
• getLaunchMode()、wasForceStopped() 与去除 extras 的启动 Intent：用于补充 Activity 任务和进程状态；原始 Intent、URI 与 referrer（来源页面）默认不进入遥测。

reason 与 start component 不应混用：前者表示触发原因，后者表示哪类组件引发进程创建。原因枚举并不等同于 Activity、Service、Broadcast、Provider 四大组件分类；Android 16 起应使用 getStartComponent() 判断组件类型。

3.1 Android 15、16、17 的能力边界

这组 API 的主体在 Android 15 已经提供。本文用 Android 17 的源码核对实现，但不能把 Android 15 已有的能力写成 Android 17 新增功能。

API 35 没有 getStartComponent()，调用前必须检查系统版本。官方文档还注明，Service 启动的 LAUNCH 时间戳在 Android 16（Baklava / API 36）及更早版本可能不准确；Android 17 不在这个已知限制范围内。

3.2 记录形成与状态

system_server（承载 Android 核心系统服务的进程）中的 AppStartInfoTracker 先建立启动记录，随后由进程创建、应用绑定、首帧和 fully drawn 等路径逐步补入字段。App 通过 ActivityManager 读到的是某一时刻的记录副本，也就是快照；它不会自动更新，也不包含线程调度、Binder 和 I/O 的完整时间线。

平台没有 FULLY_DRAWN 状态；fully drawn 只是依赖 App 调用 reportFullyDrawn() 的可选时间戳。完成监听的“complete”表示记录进入 FIRST_FRAME_DRAWN，不表示 TTFD 已完成。Android 17 的 tracker 也只在加入 FIRST_FRAME 节点时触发回调，因此错误记录和没有 Activity 首帧的纯 Service、Broadcast 或 Provider 进程启动不能依赖该回调；“没有回调”本身不能证明启动失败。

八个系统时间戳的常量编号也不代表发生顺序：

3.3 时间戳不是每项都保证存在

getHistoricalProcessStartReasons(maxNum) 返回保存在有限容量历史队列中的启动记录，也可能包含尚未完成的记录。读取前要检查 getStartupState()，读取时间戳 Map 时也要检查 key 是否存在，不能把“字段尚未写入”解释成数值 0。

首帧完成状态保证可获得 LAUNCH、BIND_APPLICATION、APPLICATION_ONCREATE 和 FIRST_FRAME；其他时间戳要逐项判断。FULLY_DRAWN 依赖 App 调用 reportFullyDrawn()，任何版本都不能假设它一定存在。addApplicationStartInfoCompletionListener() 在首帧完成时异步回调，不等待 fully drawn，因此回调里的快照经常没有 FULLY_DRAWN。需要 TTFD 时，应在上报后重新查询历史记录并取得新副本。

跨版本还要保留一个限制：官方 API 文档说明，Service 触发的 START_TIMESTAMP_LAUNCH 在 Android 16（Baklava / API 36）及以下可能不准确。Android 17 锚点已越过这个限制；分析 Android 15–16 存量设备时仍需标记该样本，不能用这项时间戳做精确 Service 启动回归。

3.4 读取当前进程的正确记录

历史列表还会混入同一 App 近期的其他进程或相邻启动。选择当前记录时至少按 PID、进程名过滤，再按 LAUNCH 取最新项；不能无条件取列表第 0 项。

@RequiresApi(35)
fun latestCurrentProcessStart(
    activityManager: ActivityManager,
    maxRecords: Int = 16,
): ApplicationStartInfo? = activityManager
    .getHistoricalProcessStartReasons(maxRecords)
    .asSequence()
    .filter { info ->
        info.pid == Process.myPid() &&
            info.processName == Application.getProcessName()
    }
    .maxByOrNull { info ->
        info.startupTimestamps[
            ApplicationStartInfo.START_TIMESTAMP_LAUNCH
        ] ?: Long.MIN_VALUE
    }

生产采集还应核对 launch 时间与当前启动会话，避免 PID 复用或相邻记录造成误配。需要 FULLY_DRAWN 时，在业务条件满足并调用 reportFullyDrawn() 后重新查询；首帧回调中的旧副本通常没有这个节点。

3.5 把业务点写进平台启动记录

API 35 起，ActivityManager.addStartInfoTimestamp() 允许 App 使用 21～30 的保留 key 添加自定义单调时间戳。它能把 route_resolved（路由决定完成）这类业务点与系统的 launch、fork、bind 和 first frame 放进同一份记录。

这里存在公开契约与 Android 17 r1 实现的差异。当前 ActivityManager API 文档写明：相同 key 会覆盖旧值，只有在 reportFullyDrawn() 之后添加的时间戳才会被丢弃；但 android-17.0.0_r1 的 AppStartInfoTracker 会拒绝重复 key，并在记录进入 FIRST_FRAME_DRAWN 后拒绝开发者 key。App 不应把某个版本的内部 tracker 行为当成长期 API 保证。兼容两种行为的写法是：每个开发者 key 在首帧前只写一次；回读时若该 key 不存在，就按缺失处理。通常发生在首帧后的 content_ready 继续使用应用遥测（App 自己采集并上报的事件），再由 reportFullyDrawn() 表达约定的完成边界。

下面的代码注册首帧完成监听，并用保留区第一个 key 写入首帧前的路由决策完成点：

@RequiresApi(35)
class PlatformStartInfoCollector(
    private val activityManager: ActivityManager,
    private val callbackExecutor: Executor,
) {
    companion object {
        const val TIMESTAMP_ROUTE_RESOLVED =
            ApplicationStartInfo
                .START_TIMESTAMP_RESERVED_RANGE_DEVELOPER_START
    }

    fun register(
        onFirstFrameRecord: (ApplicationStartInfo) -> Unit,
    ) {
        activityManager.addApplicationStartInfoCompletionListener(
            callbackExecutor,
        ) { info ->
            onFirstFrameRecord(info)
        }
    }

    fun markRouteResolved() {
        activityManager.addStartInfoTimestamp(
            TIMESTAMP_ROUTE_RESOLVED,
            SystemClock.uptimeNanos(),
        )
    }

    fun latestCurrentProcessRecord(): ApplicationStartInfo? {
        return activityManager
            .getHistoricalProcessStartReasons(8)
            .asSequence()
            .filter { info ->
                info.pid == Process.myPid() &&
                    info.processName == Application.getProcessName()
            }
            .maxByOrNull { info ->
                info.startupTimestamps[
                    ApplicationStartInfo.START_TIMESTAMP_LAUNCH
                ] ?: Long.MIN_VALUE
            }
    }
}

监听回调由指定 Executor（决定任务在哪个线程执行的调度接口）异步执行，里面只应复制必要字段并交给采集队列。历史列表覆盖 App 近期多个进程启动，不能无条件取第 0 项；示例按当前 PID 和进程名过滤，生产代码还应核对最新 launch 时间与当前启动会话。业务 key 的编号和含义要随监控 schema 固定，避免不同版本把同一个 key 解释成不同事件。

ApplicationStartInfo 适合校准系统起点和启动分类，Android 10–14 仍需兼容自建埋点。完整 API 设计见ApplicationStartInfo。

3.6 阶段耗时必须防守缺失与乱序

不要把缺失 key 补成 0，也不要按常量编号排序。只有起止节点都存在且终点不早于起点时，区间才有效：

fun startupDurationMs(
    info: ApplicationStartInfo,
    fromKey: Int,
    toKey: Int,
): Double? {
    val startNs = info.startupTimestamps[fromKey] ?: return null
    val endNs = info.startupTimestamps[toKey] ?: return null
    if (endNs < startNs) return null
    return (endNs - startNs) / 1_000_000.0
}

采集端应保留原始节点、字段是否存在以及 startupState。这样即使 schema 调整或后续发现平台差异，服务端仍能重新计算区间，无须依赖端侧已经算好的单一耗时。

4. 线上聚合不能只画平均值

启动耗时通常呈右偏长尾分布：多数样本集中在较短区间，少数慢样本向更长耗时方向拖出一条“尾巴”。低端设备、升级迁移、磁盘繁忙、首次读取配置和编译状态都会制造这类慢样本。均值容易被少数极慢值拉高，也可能被大量热启动样本稀释。

常用分位数回答不同问题：

分位数必须从同一 cohort（版本、启动类型等条件一致的一组样本）的原始数据或可合并分布摘要计算。不能让每台设备先算 P90，再把各设备 P90 求平均；也不能把每日 P90 平均成周 P90。数据量大时可用直方图，或 t-digest、KLL 这类近似分位数摘要；无论选择哪种方案，都要固定直方图区间边界或算法版本，并保留样本数、最小值、最大值和缺失率。

4.1 先分组，再看分位数

最低限度需要按以下维度拆分：

• cold、warm、hot；
• 首屏路由与入口来源；
• 普通启动、首次安装启动、升级后启动；
• App 版本、实验组与远程配置版本；
• Android 版本、ABI、设备性能档位；
• 主进程与远程进程；
• Profile 安装/编译状态能够可靠获得时，单独分组。

分组过细会让每组样本太少。看板应支持从“版本 × 启动类型”逐级查看页面和设备，告警只选择样本量足够、含义长期稳定的 cohort。

4.2 把缺失和退出当成结果

TTFD 上报容易出现幸存者偏差，即只看到了成功完成启动的会话。启动期间退出、崩溃、ANR（Application Not Responding，应用无响应）、进程被杀或长期 loading 的会话没有 TTFD 数值。如果只统计成功上报样本，慢到无法完成的会话会被排除，严重问题反而可能让 TTFD 曲线看起来更好。

每个窗口应同时展示：

• 启动请求或可观测会话数；
• TTID 有效样本数；
• TTFD 有效样本数与完成率；
• fully drawn 超时数；
• 首屏前崩溃、ANR、主动退出和进程死亡；
• 采样率、上传成功率、去重率与 schema 版本。

采样策略也要进入总样本数的解释。普通样本可以做稳定随机采样，慢样本与失败样本可以提高诊断采样率；但后者被采到的概率更高，两类数据不能直接混算总体分位数。用于告警的指标数据和用于定位的高采样诊断数据应分开保存；若必须合并，应按每类样本被采中的概率加权。

5. 回归检测与归因

固定写死“P90 上升 15% 就拦截发布”，会在基线很低、样本很少或日常波动明显时产生误报。发布门槛应同时考虑增加了多少毫秒、相对增幅、样本量和统计不确定性。

一条可执行的规则可以写成：

同 cohort、同统计窗口：
  样本量达到该指标的最低要求
  AND P90 绝对增量超过产品预算
  AND P90 相对增量超过历史噪声带
  AND 差异的置信区间不跨过“无影响”边界
  AND 连续两个窗口成立
=> 暂停灰度并进入归因

这段规则中的“预算”是产品允许增加的毫秒数，“历史噪声带”是指标在没有代码变化时通常波动的范围。高流量版本可以用 bootstrap（从现有样本反复有放回抽样）估计置信区间，也就是变化可能落入的范围；低流量灰度可先看中位数、MAD（各样本与中位数偏差的中位数）、样本明细和线下 benchmark（固定条件的基准测试），避免把样本不足的 P99 当成发布结论。实验统计细节见 性能实验统计。

5.1 归因顺序

发现回归后，按以下顺序缩小范围：

1. 核对 schema、采样率、TTFD 完成率与启动类型占比，排除测量变化。
2. 对齐灰度开始、构建发布时间、远程配置、服务端接口和实验开关。
3. 按入口、页面、设备档位、Android 版本、ABI、安装状态分组。
4. 比较初始化 task 出现率和耗时，检查是否新增 Provider、SDK 或主线程 I/O。
5. 在可复现设备上运行同编译模式的 Macrobenchmark，并打开 Perfetto。
6. 把长耗时区间映射到具体提交和模块所有者，修复后按同一 cohort 回看。

常见信号可以这样解释：

ApplicationStartInfo 的系统节点用来确定区间，应用 task 事件说明责任模块，Perfetto 用来确认线程当时在运行、睡眠、I/O 还是锁等待。缺少后两层证据时，不应仅凭一个长区间判断根因。

6. Android Vitals 怎样对标

Google Play Android Vitals 使用 TTID 判断 excessive startup，即启动耗时达到平台定义的“过慢”范围。当前官方公开阈值为：

这些数值是 Play 用来识别明显过慢启动的风险线，不代表理想体验。团队内部预算通常要更严格，并按核心入口、设备档位和用户任务设置。Google 的性能测量总览还提供更积极的目标参考，但项目不能脱离页面复杂度、设备和编译条件直接承诺统一毫秒数。

Vitals 与自建监控应同时保留：

两边数据不一致时，检查版本覆盖、启动类型、统计窗口、渠道、设备分布、采样条件和 TTFD 完成率。不要通过乘一个固定系数把自建 TTID“换算”为 Vitals。

Android Vitals 的专项边界和 Play Console 使用方式见Android Vitals 与 Play Console。

7. 线下与线上怎样互证

一条启动问题从发现到验收，建议保留四层证据：

Macrobenchmark 必须记录 StartupMode（启动状态）、CompilationMode（ART 预编译状态）、设备、温度、电量和重复次数。StartupMode.COLD 会在测量前杀掉 App 进程，但默认不等于清空内核 page cache（把文件内容缓存在内存中的页缓存）。若实验要包含从存储重新读取文件的成本，应在支持的测试环境中显式使用 dropKernelPageCache()，并把这一条件写进报告。Baseline Profile 实验还要区分 Profile 是否安装，避免把编译差异误归给业务代码。

Perfetto 中先找 Android App Startups 派生轨道（由 trace 数据计算出的启动区间），再与 App 的自定义 trace 对齐。一个任务从开始到结束持续 80 ms，不代表它占用了 80 ms CPU；线程可能在等待 Binder、锁、I/O 或 CPU 调度。结论要由对应时间线证明。下面的 PerfettoSQL 会加载官方 android.startup.startups 标准库模块，列出 trace 中识别出的启动；dur / 1e6 把纳秒转换成毫秒。取得目标 startup_id 后，再查询对应线程、Binder、I/O、GC（垃圾回收）和帧事件：

INCLUDE PERFETTO MODULE android.startup.startups;

SELECT startup_id, package, startup_type, dur / 1e6 AS duration_ms
FROM android_startups
ORDER BY ts;

Android 15+ 还可用 ProfilingManager 请求 system trace 或 stack sampling（定期采集线程调用栈）。请求会被系统限流，也不保证每次执行；结果会写入 App 数据目录，并按平台规则做脱敏。它比读取 ApplicationStartInfo 成本高，只适合问题版本或受控样本，还要限制采集频率、设备开销和上传范围。官方也建议大多数 App 优先使用能正确构造参数的 AndroidX 高层封装。

8. 用同一份模板记录复盘

复盘要把现象、证据、假设、改动和结果分开，避免把一次“同时发生”写成因果关系。下面的最小模板可直接用于 PR（Pull Request，代码合并请求）或性能专项。模板里的 commit 是代码提交标识，release variant 是用于发布的构建变体，R8 是 Android 代码优化与压缩工具，owner 是后续事项负责人；这些工程字段保留原名，便于和构建系统、代码仓库对照。

# <入口 / 问题> 启动优化复盘

## 1. 范围
- App commit / versionCode、release variant、R8、编译模式：
- 设备 / Android / RAM / ABI / 温度与电量：
- 入口 / 账号 / 数据 / 网络、cold / warm / hot 定义：
- 统计窗口、样本量、采样率：

## 2. 用户症状
- TTID / TTFD 的 P50、P90 与完成率：
- 首屏前 ANR / Crash / 退出、受影响 cohort：

## 3. 证据
- ApplicationStartInfo 区间、Macrobenchmark、Perfetto：
- task / Provider / manifest、首次出现的版本或配置：

## 4. 根因假设
- 假设、支持证据、反证、仍未知：

## 5. 单变量改动
- 改动、目标区间、风险、灰度与回滚开关：

## 6. 验证
- 线下 before / after 分布：
- 线上同 cohort 的 TTID / TTFD / frame / ANR / Crash / 业务护栏：
- 结果是否超过历史噪声与产品预算：

## 7. 后续
- 门禁、owner、截止时间、回滚条件：

若无法写出“哪条证据会推翻当前假设”，通常说明结论还停留在猜测。“单变量改动”指一次验证尽量只改变一个待检验因素；当代码、Profile、服务端配置和样本结构同时改变时，结果只能说明整个版本组合发生变化，不能把收益归给其中一项。

检查清单

• TTID、TTFD、content ready 和 Application 局部耗时各有独立名称与边界。
• 耗时使用单调时钟，墙钟只用于事件对齐。
• 没有为监控新增自动初始化 Provider 或首帧前重型 SDK。
• onResume、pre-draw 与 frame callback 没有被命名成平台 TTID。
• 每个首屏入口都定义了可测试的 fully drawn 条件和超时/降级。
• TTFD 缺失、启动中退出、崩溃与 ANR 进入分母和数据质量看板。
• cold/warm/hot、安装状态、入口和设备 cohort 分开统计。
• 分位数从可合并分布计算，没有平均客户端或每日分位数。
• 告警同时检查绝对差、相对差、样本量、不确定性和连续窗口。
• Android 15–16 Service 启动的 LAUNCH 时间戳限制已标记。
• ApplicationStartInfo completion callback 没有被当成 fully drawn callback。
• Vitals 阈值只作外部风险线，内部预算由产品基线确定。
• Macrobenchmark、Perfetto、平台时间戳和线上样本可以按同一启动入口互相对齐。

小结

启动分析先把系统请求、进程创建、Provider/Application、Activity 和首帧放进同一条时间线，再根据线程运行/等待状态与业务切片定位关键路径。启动监控则依赖一份稳定的测量契约：平台 TTID 告诉我们第一帧何时显示，reportFullyDrawn() 给出约定的首屏可用边界，ApplicationStartInfo 补齐 Android 15+ 的系统起点、启动分类和触发原因，App 事件负责解释任务与业务状态。服务端再按条件一致的样本组计算分位数、完成率和失败率，用绝对预算与统计不确定性共同判断是否变慢。

当一条告警能够回答“哪个版本、哪种启动、哪个入口、哪类设备、哪个阶段开始变慢”，启动监控才具备工程价值。

参考资料

• Android 应用启动时间

• 启动分析与优化

• Macrobenchmark 概览

• StartupTimingMetric API

• ViewTreeObserver.registerFrameCommitCallback

• Perfetto ATrace 数据源

• PerfettoSQL 标准库

• AOSP Android 17 ActivityThread

• AOSP Android 17 ViewRootImpl

• Android 17 ApplicationStartInfo.java：启动原因、类型、组件、状态和系统/开发者时间戳。

• Android 17 ActivityManager.java：历史启动记录、首帧完成监听与 addStartInfoTimestamp()。

• Android 17 Activity.java：reportFullyDrawn() 的一次性上报与首帧边界。

• Android 17 AppStartInfoTracker.java：启动记录补全、完成回调和时间戳接受条件。

• App startup time：TTID、TTFD、fully drawn 与 Android Vitals 阈值。

• App startup analysis and optimization：Macrobenchmark、Perfetto 与启动区间分析。

• ApplicationStartInfo API reference：字段可用性、时间戳和跨版本限制。

• ActivityManager API reference：启动记录查询、completion listener 与自定义时间戳。

• Activity.reportFullyDrawn() API reference：调用语义及过早、过晚上报的影响。

• FullyDrawnReporter API reference：多条件 fully drawn 协调。

• Macrobenchmark overview：启动基准测试和 StartupTimingMetric。

• ProfilingManager API reference：采集类型、回调、限流和结果交付规则。

• PerfettoSQL android.startup.startups：android_startups 表的字段和启动分析函数。