用途:为 OneKey 移动端提供深度启动性能分析,覆盖 JS 模块、HBC 主包与分段加载三层计时,帮助定位冷启动瓶颈。
主要能力:
- JS 模块层([StartupProfile.js])记录自耗时前 200 个模块及 moduleId→路径映射;self 为模块自身工厂耗时(不含嵌套 require),total 为含依赖的累计耗时,仅记录 ≥1ms 的模块。
- HBC 层([StartupProfile.hbc])记录主包 I/O 毫秒数与字节大小,解析+执行时间可由 ios.main_entry.evaluated 减去 io 推算。
- 分段层([StartupProfile.seg])记录每个 .seg.hbc 的总耗时、id、key 与相对路径。
使用方式:构建前设置 export ONEKEY_STARTUP_PROFILE=1,再执行 yarn app:android 或 yarn app:ios;EAS 构建可在 eas.json 的 build profile 中设置该环境变量,然后 eas build --profile profile-startup --platform android。iOS 开发也可在 Xcode Scheme 的环境变量中设置;Release iOS 可通过 Info.plist 添加 ONEKEY_STARTUP_PROFILE 键。启用后用 grep 'StartupProfile' app-latest.log 检查三类日志是否齐全。
适用场景:分析 Android/iOS 冷启动到 TTI 的耗时构成,识别慢模块、慢分段与主包 I/O 开销。
限制:该开关为构建期而非运行期,切换需重新构建;分段 I/O 与解析时间目前只能合并统计,拆分需修改 @onekeyfe/react-native-split-bundle-loader;HBC 探测会使包进入系统页缓存,影响后续 I/O 测量;Dev/Debug 构建数值约为 Release 的 2-3 倍,应以 Release 为基准。关闭时各层仅做一次布尔判断,生产包开销约等于零。