SuperAPI AI 工具集

build-android

部署与运维

查看项目

更新于 10-16 02:33

技能介绍

用途:面向 XerahS 移动端(Kotlin/Mobile.Kt、Avalonia、MAUI)的 Android 构建与部署,覆盖前置条件、模拟器/设备处理、APK 输出路径和部署命令。

主要能力与用法:Kotlin 项目根为 src/mobile/android,需先设置 JAVA_HOME 再执行 .\gradlew.bat assembleDebug,APK 位于 app\build\outputs\apk\debug\app-debug.apk,用 adb install -r 安装。MAUI 与 Avalonia 推荐使用脚本 .\build\android\build-and-deploy-android-maui.ps1 和 .\build\android\build-and-deploy-android-ava.ps1,可加 -Clean;脚本使用 -m:1 单节点构建以避免文件锁竞争。

常见问题:JAVA_HOME 未设置、Compose KeyboardOptions 需从 androidx.compose.foundation.text 导入并为模块添加 compose.foundation 依赖、adb 不在 PATH 时用完整路径。构建停滞时先检查输出与进程状态,停止构建、释放锁(如 .NET Host 或 VBCSCompiler 占用 APK/DLL),再清理重建。MAUI 需设置 EmbedAssembliesIntoApk 为 true 才能用 adb 独立安装;白屏可在 MainActivity.cs 延迟约 400ms 调用 InitializeCoreAsync;Avalonia 不要将宿主 Content 置为 null。

限制:不得并发运行两个 Android 或解决方案构建;不要设置固定超时,仅在确认停滞时停止;部署时需有已连接设备或模拟器,否则改用手动安装/启动。