AtomUI/docs/engineering/platforms/android/overview.md

Android 工程环境

状态：预实现架构。本文定义已批准的目标契约，不表示当前仓库已经包含或发布 AtomUI.Mobile.Controls。

本文是 AtomUI/Avalonia Android Host 的工程文档入口。当前仓库没有 Android Mobile Gallery Host、已执行构建命令、Emulator/ 真机或 Release 证据，因此本目录只定义工具链、签名、Host/adapter、验证和排障责任，不声明版本组合或平台可用性。

范围

• Android SDK、JDK、.NET Android workload 和本地/CI ownership。
• Application identity、keystore/signing identity 和 secret 边界。
• Emulator/physical device 的发现、部署、启动、日志、截图和场景证据。
• Debug/Release、target framework、ABI/RID、package、trim/AOT 和启动验证。
• Activity recreation、system back、system bars、IME、multi-window 和 TalkBack。

Mobile Control API、Viewport/Overlay/Gesture 状态机和 Gallery content 分别由 Mobile 系统架构、 Mobile Controls 模块和 Mobile Gallery拥有。

Host 与 Adapter 边界

Android Host 拥有应用生命周期、启动、资源/manifest、部署和 Android capability adapter 注册。Adapter 把 system bars、 input pane、system back、haptic、font scale、Reduce Motion/accessibility environment、foreground/background 与 Activity recreation 投射到统一 Mobile Runtime contract。Control 不读取 Android OS 名称或平台 SDK 类型。

当前没有 Host 或 adapter 源码；任何目标类型名、项目路径和命令必须等真实实现出现后再补写。

阅读顺序

文档	职责
工具链与签名	SDK/JDK/workload、keystore、secret 和版本证据门禁
Emulator 与真机	AVD/device、部署、日志、截图、输入、返回、旋转和 TalkBack 证据
构建与验证	Debug/Release、TFM、ABI/RID、package、trim/AOT、Activity recreation 和发布门禁
排障	按 owner 和证据组织的诊断框架，不提供未经执行的修复配方

当前证据矩阵

维度	当前状态	提升要求
Design	能力已纳入总体设计	Host、adapter 和构建边界评审完成
Source	未实现	Android Host、adapter、manifest/resources 和注册入口存在
Compile	未验证	真实 target framework 与 ABI/RID 编译通过
Emulator	未验证	安装、启动、system back、IME、旋转、system bars 和生命周期场景有记录
Physical device	未验证	真机触摸、IME、前后台、multi-window/设备差异和日志证据存在
TalkBack	未验证	真机阅读顺序、焦点、state/action 和 modal 语义证据存在
Activity recreation	未验证	重建后 navigation/session/viewport 不重复提交或泄漏
Release	未验证	trim/AOT 产物构建、安装并启动，资产可发现
Publication	未发布	可追溯包或应用版本与发布日期存在

Compile、Emulator、真机、TalkBack、Activity recreation、Release 和 Publication 互不替代。iOS 证据也不能提升 Android 状态。

非目标

• 不发布未经验证的标准命令、推荐 SDK/JDK/workload 版本或机器路径。
• 不把 Android compile 描述为 Emulator/真机支持。
• 不把 Headless adapter 描述为 system back、IME、TalkBack 或 Activity 生命周期验证。
• 不定义 Play Store、企业分发或产品 entitlement/permission 策略。