使用 Azure 移动应用构建 Xamarin.Android 应用

项目
01/16/2024

本教程介绍如何使用 Xamarin 和 Azure 移动应用后端，将基于云的后端服务添加到 Android 移动应用。同时创建一个新的移动应用后端和一个简单的 Todo 列表 应用，用于在 Azure 中存储应用数据。

开始学习有关使用 Azure 应用服务中的移动应用功能的其他 Xamarin Android 教程之前，必须先完成本教程。

先决条件

要完成本教程，您需要：

具有以下工作负载的 Visual Studio 2022 。
- ASP.NET 和 Web 开发
- Azure 开发
- 使用 .NET 的移动开发
一个 Azure 帐户。
Azure CLI。
- 在开始之前，使用 az login 并选择适当的订阅登录。
（可选） Azure 开发人员 CLI。
Android 虚拟设备，具有以下设置：
- 电话：任何手机图像 - 我们使用像素 5 进行测试。
- 系统图像：Android 11（使用 Google API 的 API 30）

下载示例应用

在浏览器中打开 azure-mobile-apps 存储库。
打开 “代码 ”下拉列表，然后选择“ 下载 ZIP”。
下载完成后，打开 “下载” 文件夹并找到 azure-mobile-apps-main.zip 该文件。
右键单击下载的文件，然后选择“ 全部提取...”。

如果愿意，可以使用 PowerShell 扩展存档：
```
C:\Temp> Expand-Archive azure-mobile-apps-main.zip
```

这些示例位于 提取文件内的 samples 文件夹中。快速入门示例命名 TodoApp。可以通过双击 TodoApp.sln 文件在 Visual Studio 中打开示例。

Screenshot of the file explorer for the solution.

将后端部署到 Azure

注意

如果已从另一个快速入门部署后端，则可以使用相同的后端并跳过此步骤。

若要部署后端服务，我们将：

将Azure App 服务和Azure SQL 数据库预配到 Azure。
使用 Visual Studio 将服务代码部署到新创建的Azure App 服务。

使用 Azure 开发人员 CLI 完成所有步骤

TodoApp 示例配置为支持 Azure 开发人员 CLI。若要完成所有步骤（预配和部署）：

安装 Azure 开发人员 CLI。
打开终端并将目录更改为包含 TodoApp.sln 该文件的文件夹。此目录还包含 azure.yaml。
运行 azd up。

如果尚未登录到 Azure，浏览器会启动以要求你登录。然后系统会提示你输入要使用的订阅和 Azure 区域。然后，Azure 开发人员 CLI 预配必要的资源，并将服务代码部署到所选的 Azure 区域和订阅。最后，Azure 开发人员 CLI 会为你编写适当的 Constants.cs 文件。

可以运行以下命令 azd env get-values 来查看想要直接访问数据库的 SQL 身份验证信息。

如果已完成 Azure 开发人员 CLI 的步骤，请继续执行下一步。如果不想使用 Azure 开发人员 CLI，请继续执行手动步骤。

在 Azure 上创建资源。

打开终端并将目录更改为包含 TodoApp.sln 该文件的文件夹。此目录还包含 azuredeploy.json。
确保已使用 Azure CLI 登录并选择订阅。
创建新的资源组：
```
az group create -l westus -g quickstart
```
此命令在 quickstart “美国西部”区域创建资源组。可以选择所需的任何区域，前提是可以在其中创建资源。请确保在本教程中提及相同的名称和区域。
使用组部署创建资源：
```
az deployment group create -g quickstart --template-file azuredeploy.json --parameters sqlPassword=MyPassword1234
```
为 SQL 管理员istrator 密码选择强密码。稍后访问数据库时需要用到它。
部署完成后，获取输出变量，因为这些变量包含稍后需要的重要信息：
```
az deployment group show -g quickstart -n azuredeploy --query properties.outputs
```
示例输出为：
记下输出中的每个值供以后使用。

发布服务代码

在 Visual Studio 中打开 TodoApp.sln。

在右侧窗格中，选择 “解决方案资源管理器”。
右键单击 TodoAppService.NET6 该项目，然后选择“ 设置为启动项目”。
在顶部菜单中，选择“ 生成>发布 TodoAppService.NET6”。
在 “发布 ”窗口中，选择“目标： Azure”，然后按“ 下一步”。
选择特定目标：Azure App 服务（Windows），然后按“下一步”。
如有必要，请登录并选择相应的 订阅名称。
确保视图设置为 资源组。
quickstart展开资源组，然后选择之前创建的App 服务。
选择“完成”。
发布配置文件创建过程完成后，选择“ 关闭”。
找到服务依赖项并选择 SQL Server 数据库旁边的三点，然后选择连接。
选择Azure SQL 数据库，然后选择“下一步”。
选择快速入门数据库，然后选择“下一步”。
使用部署输出中的 SQL 用户名和密码填写表单，然后选择“ 下一步”。
选择“完成”。
完成后选择“ 关闭 ”。
选择“发布”，将应用发布到之前创建的Azure App 服务。
发布后端服务后，将打开浏览器。添加到 /tables/todoitem?ZUMO-API-VERSION=3.0.0 URL：

配置示例应用

客户端应用程序需要知道后端的基 URL，以便它可以与后端通信。

如果用于 azd up 预配和部署服务，则 Constants.cs 已为你创建该文件，你可以跳过此步骤。

TodoApp.Data展开项目。
右键单击TodoApp.Data项目，然后选择“添加>类...”。
输入 Constants.cs 为名称，然后选择“ 添加”。
Constants.cs.example打开该文件并复制内容（Ctrl-A，后跟 Ctrl-C）。
切换到 Constants.cs，突出显示所有文本（Ctrl-A），然后粘贴示例文件（Ctrl-V）中的内容。

将服务 https://APPSERVICENAME.azurewebsites.net 后端 URL 替换为该 URL。

namespace TodoApp.Data
{
    public static class Constants
    {
        /// <summary>
        /// The base URI for the Datasync service.
        /// </summary>
        public static string ServiceUri = "https://demo-datasync-quickstart.azurewebsites.net";
    }
}

可以从“ 发布 ”选项卡获取服务的后端 URL。请确保使用 https URL。

保存文件。（Ctrl-S）。

生成并运行应用

在解决方案资源管理器中，展开 xamarin-native 文件夹。
右键单击 TodoApp.Android 项目并选择“设为启动项目”。
在顶部栏中，选择 “任何 CPU 配置” 和“TodoApp.Android 目标”：
如果改为看到 Android Emulator ，则尚未创建 Android 模拟器。有关详细信息，请参阅 Android 模拟器设置。若要创建新的 Android 仿真器，请执行以下操作：
- 选择 Android Android>设备管理器工具。>
- 选择“+ 新建” 。
- 在左侧选择以下设置：
  - 名称：quickstart
  - 基本设备： 像素 5
  - 处理器： x86_64
  - OS： Android 11.0 - API 30
  - Google API： 已选中
- 选择创建。
- 如有必要，请接受许可协议。然后下载映像。
- 显示“开始”按钮后，按“开始”。
- 如果系统提示你了解 Hyper-V 硬件加速，请阅读文档以在继续之前启用硬件加速。
完成后，关闭 Android 设备管理器。

提示

在继续之前启动 Android 仿真器。可以通过打开 Android 设备管理器并按所选模拟器旁边的“开始”来执行此操作。
按 F5 生成并运行项目。

应用启动后，会看到一个空列表和一个浮动操作按钮，用于在模拟器中添加项。你可以：

按浮动操作按钮，然后输入一些文本以添加项目。
设置或清除检查框以将任何项目标记为已完成。
按刷新图标从服务重新加载数据。

Screenshot of the running Android app.

后续步骤

通过向应用添加身份验证继续学习本教程。