要在手机上运行Avalonia应用，需分别完成Android和iOS的构建、签名与部署：Android依赖.NET 8+、JDK 17+及Android SDK，通过VS真机调试或生成APK；iOS必须配对macOS并用Xcode签名，依赖Apple开发者证书；两者共用同一套XAML和ViewModel，核心难点在于环境配置与签名流程。
要在手机上运行 Avalonia 应用，核心是分别完成 Android 和 iOS 平台的构建、签名与部署。两者流程不同，但都依赖 .NET 工作负载和平台 SDK 支持。下面分平台说明关键步骤和常见注意事项。
Android：真机调试与 APK 安装
Android 环境相对成熟，支持模拟器和实体机两种方式：
- 必备工具链：安装 .NET 8+ SDK、JDK 17+、Android SDK（含 platform-tools、build-tools、Android API 34+）、Visual Studio 2022（启用 “Mobile development with .NET” 工作负载）
-
项目配置：确保 Android 项目（如
MyApp.Android）引用Avalonia.Android包，.csproj中目标框架为net8.0-android，并设置<supportedosplatformversion>34.0</supportedosplatformversion> - 真机调试：开启手机 USB 调试 → 用 USB 连接电脑 → 在 VS 中选择设备 → 右键项目 → “设为启动项目” → 按 F5 直接部署运行；首次会自动安装 APK 并启动
-
生成独立 APK：右键项目 → “发布” → 选择“文件夹”目标 → 使用 CLI 命令：
dotnet publish -c Release -f net8.0-android -r android-arm64 --self-contained true，输出在bin/Release/net8.0-android/android-arm64/publish/下
iOS：需 macOS 配对 + Xcode 签名
iOS 构建无法纯 Windows 完成，必须通过网络配对一台运行 macOS 的机器（黑苹果或 Mac），由其调用 Xcode 编译和签名：
-
Mac 端准备：macOS 15+、Xcode 16+、已登录 Apple ID；VS 会自动安装
dotnet workload install ios所需组件 - Windows 配对：VS → “工具” → “选项” → “Xamarin” → “iOS Settings”，填入 Mac IP 和登录凭据 → 点击 Connect 等待加载完成
-
签名配置：iOS 项目中打开
Info.plist设置 Bundle Identifier（如com.yourname.myapp）；在项目属性 → “签名”页选择 Manual Provisioning，并填入证书名称（从 Mac 钥匙串复制） - 真机部署：连接 iPhone → 在 VS 中选择设备 → 启动调试；应用会自动安装并运行。注意：未加入 Apple 开发者计划时，证书仅有效期 7 天，到期需重连重装
共性要点：UI 适配与启动逻辑
无论 Android 还是 iOS，Avalonia 都通过统一入口抽象处理平台差异：
-
Android：主 Activity 继承
AvaloniaMainActivity<app></app>，重写CustomizeAppBuilder注册平台服务（如字体、触摸事件） -
iOS：
AppDelegate继承AvaloniaAppDelegate<app></app>，Main方法调用UIApplication.Main启动 -
安全区域适配：在页面 OnAttachedToVisualTree 中读取
TopLevel.GetTopLevel(this)?.InsetsManager.SafeAreaPadding，动态设置 Padding，避免刘海/圆角遮挡内容 -
手势与导航：移动端默认不带导航栏，需自行实现返回按钮或使用
INavigationService（配合 CommunityToolkit.Mvvm）管理页面栈
只要环境配置到位，Avalonia 的跨平台能力能让同一套 XAML 和 ViewModel 代码，在 Android 和 iOS 上原生运行，无需重写 UI 层。难点不在逻辑，而在初始环境打通和签名流程。
