技能介绍

解决原生工程编译验证的痛点

在开发基于原生 Kotlin/Compose 重写的 APP_android 工程时，修改源码后往往需要立即在真机上验证效果。然而，手动执行编译和装机不仅步骤繁琐，还极易踩中环境配置的暗坑。本技能专为纯原生工程打造，提供一条全程命令行的编译装机流水线，让代码改动到真机运行的链路变得可靠且可重复。

核心能力与执行流程

技能通过四个核心步骤自动完成构建与部署：

前置校验：自动检查 gradle-wrapper.jar 是否存在，并确保 local.properties 就绪（缺失时自动生成）。
Gradle 编译：调用 gradlew.bat assembleDebug 执行编译，并精准回显 BUILD 结果或关键错误信息。
产物校验：确认 app-debug.apk 成功生成，并记录其文件时间戳以确认是最新产物。
装机与验证：通过 adb install -r 安装到连接的手机，并校验设备上的 versionName 与 lastUpdateTime 确保安装成功。

适用边界与避坑指南

本技能仅适用于 APP_android 纯原生工程，不可用于 UniApp 工程（需走 HBuilderX 流程）或纯固件项目（需走 idf.py 流程）。在执行过程中，请务必注意以下关键环境限制：

JDK 版本：AGP 8.7.3 强制要求 JDK 17+，脚本会将 JAVA_HOME 指向 Android Studio 的 JBR (OpenJDK 21)，手动执行时需保持一致。
Wrapper 缺失：若 gradle-wrapper.jar 丢失，由于它是二进制文件，需从 UniApp 壳工程直接拷贝。
PowerShell 兼容：在 PowerShell 5.1 下，原生命令的 stderr 可能被误报为 ErrorRecord。判断成功与否必须看 $LASTEXITCODE 和 BUILD SUCCESSFUL，切勿被红字误导。
包名与签名：工程固定包名为 com.boling.device，若与旧版签名不一致导致覆盖失败，需先卸载旧包。此外，因与 UniApp 包名相同，两者无法在设备上共存。