Xamarin.Forms Android 应用开发完整指南

在跨平台移动开发领域，Xamarin.Forms 为 C# 开发者提供了高效的 Android 应用开发方案。本文通过一个完整项目示例，详细解析从环境配置到功能实现的全流程技术要点。

核心架构与组件

Xamarin.Forms 项目主要由共享代码层和平台特定层两大核心模块组成。共享代码层定义了应用的主要逻辑和用户界面，而平台特定层则处理 Android 平台的适配工作。

以下是一个示例应用类，展示了应用程序的初始化过程和生命周期事件管理：

using Xamarin.Forms;

namespace SharedApp
{
    public partial class App : Application
    {
        public App()
        {
            InitializeComponent();
            MainPage = new MainPage(); // 设置主页面
        }
        // 生命周期事件
        protected override void OnStart() { }
        protected override void OnSleep() { }
        protected override void OnResume() { }
    }
}

应用的 XAML 资源定义用于设置主题颜色，确保界面风格一致：

<?xml version="1.0" encoding="utf-8"?>
<Application xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="SharedApp.App">
    <Application.Resources>
        <!-- 主题资源定义 -->
        <ResourceDictionary>
            <Color x:Key="Primary">#2196F3</Color>
            <Color x:Key="PrimaryDark">#1976D2</Color>
        </ResourceDictionary>
    </Application.Resources>
</Application>

Android 平台适配实现

平台特定层需要配置 AndroidManifest 文件并管理 Activity 生命周期。AndroidManifest 文件定义了应用的基本信息、权限和目标 SDK 版本：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.yourcompany.sharedapp">
    <uses-sdk android:minSdkVersion="21" android:targetSdkVersion="33" />
    <application android:label="SharedApp"
                 android:theme="@style/MainTheme">
    </application>
</manifest>

MainActivity 类继承自 FormsAppCompatActivity，负责在 Android 平台上初始化 Xamarin.Forms 并加载共享应用：

using Android.App;
using Android.Content.PM;
using Android.OS;
using Xamarin.Forms;

namespace SharedApp.Droid
{
    [Activity(
        Label = "SharedApp",
        Icon = "@mipmap/icon",
        Theme = "@style/MainTheme",
        MainLauncher = true,
        ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation)]
    public class MainActivity : FormsAppCompatActivity
    {
        protected override void OnCreate(Bundle savedInstanceState)
        {
            base.OnCreate(savedInstanceState);
            Forms.Init(this, savedInstanceState); // 初始化Xamarin.Forms
            LoadApplication(new App()); // 加载共享应用
        }
    }
}

项目配置与依赖管理

项目文件需要正确配置跨平台引用和依赖项。共享项目的 .csproj 文件指定了目标框架为 .NET 8.0 Android，并引用了 Xamarin.Forms 包：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0-android</TargetFramework>
    <OutputType>Library</OutputType>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Xamarin.Forms" Version="5.0.0.2545" />
  </ItemGroup>
</Project>

Android 平台的 .csproj 文件则引用共享项目，并设置为 Android 应用类型：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0-android</TargetFramework>
    <AndroidApplication>True</AndroidApplication>
  </PropertyGroup>
  <ItemGroup>
    <ProjectReference Include="..\SharedApp\SharedApp.csproj" />
  </ItemGroup>
</Project>

开发环境要求

开发 Xamarin.Forms Android 应用需要以下环境配置：

• Visual Studio 2022 并安装 Xamarin 工作负载
• Android SDK 33
• JDK 11 或更高版本

部署流程

将应用部署到 Android 设备的步骤包括：

1. 连接 Android 设备并启用 USB 调试模式。
2. 在 Visual Studio 中选择 Droid 项目作为启动项。
3. 选择目标设备后按 F5 键进行调试运行。

交互功能实现

基础 UI 交互示例展示了跨平台组件的使用方法。以下是一个主页面类和对应的 XAML 定义，实现了一个按钮点击事件，显示提示框：

using Xamarin.Forms;

namespace SharedApp
{
    public partial class MainPage : ContentPage
    {
        public MainPage()
        {
            InitializeComponent();
        }

        private void OnButtonClicked(object sender, System.EventArgs e)
        {
            DisplayAlert("提示", "你好，安卓！", "确定"); // 显示提示框
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             x:Class="SharedApp.MainPage"
             Title="Xamarin安卓应用">
    <StackLayout Padding="20" VerticalOptions="Center">
        <Label Text="欢迎使用Xamarin.Forms!"
               HorizontalOptions="Center"
               FontSize="Title"/>
        <Button Text="点击测试"
                Clicked="OnButtonClicked"
                BackgroundColor="{StaticResource Primary}"
                CornerRadius="10"/>
    </StackLayout>
</ContentPage>

这个示例演示了如何创建简单的用户界面并处理交互事件，突出了 Xamarin.Forms 在跨平台开发中的便利性。