用途:该技能指导安装并操作 skydoves/compose-stability-analyzer 的 IntelliJ / Android Studio 插件,让开发者在编辑 @Composable 时即时获得稳定性反馈,而不必等构建完成后再看 Compose Compiler 报告。插件基于 Kotlin K2 Analysis API,评估规则与编译器一致。
主要能力:边栏彩色图标标记每个 @Composable;悬停显示逐参数稳定性表格与建议修复;内联提示在参数类型旁显示彩色徽章;UnstableComposable 弱警告检查(组 Compose)标出含不稳定参数、不可跳过的组合函数;Alt+Enter 提供 @Suppress("NonSkippableComposable")、@Suppress("ParamsComparedByRef") 抑制意图,以及 Add @TraceRecomposition 意图。
使用方式:克隆仓库并构建插件:git clone https://github.com/skydoves/compose-stability-analyzer;cd compose-stability-analyzer;./gradlew :compose-stability-analyzer-idea:buildPlugin。产物位于 compose-stability-analyzer-idea/build/distributions/*.zip。在 IDE 中打开 Settings → Plugins → ⚙ → Install Plugin from Disk… 选择该 ZIP 并重启。随后在 Settings → Tools → Compose Stability Analyzer 确认 isStabilityCheckEnabled 开启,并按需调整 showGutterIconsOnlyForUnskippable、showOnlyUnstableHints 等开关;将 stabilityConfigurationPath 指向项目使用的 stability_config.conf,使编辑器与编译器分类一致。
适用场景:编辑时实时查看稳定性、本地审查 PR、新人快速识别不可跳过的组合函数、排查 UnstableComposable 弱警告。
限制:需要 Android Studio 2024.2+ 或 IntelliJ IDEA 2024.2+(构建范围 242 至 261),IDE 插件运行时需 Kotlin 2.3.0,项目需已接入 Compose Compiler Gradle 插件。插件目前需从磁盘安装,JetBrains Marketplace 上架仍在审核中。该检查为弱警告,不会阻断构建或 CI;CI 门禁、构建期报告分析、运行时追踪等应使用其他对应技能。不要使用文件级 @file:Suppress("UnstableComposable"),也不应全局关闭检查来消除噪音。