创建 Xamarin.Android 应用

项目
06/25/2019

概述

本教程说明如何向 Xamarin.Android 应用添加基于云的后端服务。有关详细信息，请参阅什么是移动应用。

以下是完成的应用程序的屏幕快照：

只有在完成本教程后，才可以学习有关 Xamarin Android 应用的所有其他移动应用教程。

必备条件

若要完成本教程，需要具备以下先决条件：

有效的 Azure 帐户。如果没有帐户，可以注册 Azure 试用版并获取多达 10 个免费的移动应用。有关详细信息，请参阅 Azure 免费试用。
Visual Studio with Xamarin。有关说明，请参阅设置和安装 Visual Studio 和 Xamarin 。

创建 Azure 移动应用后端

按照这些步骤创建移动应用后端。

登录 Azure 门户。
单击“创建资源”。
在搜索框中，键入“Web 应用”。
在结果列表中，从“市场”中选择“Web 应用”。
选择订阅和 资源组 (选择现有资源组 ，或使用 与应用) ) 相同的名称创建新的资源组 (。
选择 Web 应用的唯一名称。
选择默认 的“发布 ”选项作为 “代码”。
在 运行时堆栈中，需要在 ASP.NET 或 Node 下选择版本。如果要生成 .NET 后端，请在 ASP.NET 下选择版本。否则，如果要面向基于节点的应用程序，请从 Node 中选择其中一个版本。
选择正确的 操作系统，即 Linux 或 Windows。
选择要部署此应用的区域。
选择相应的App 服务“计划”，然后点击“审阅”并创建。
在资源组下，选择现有资源组，或创建新组（使用与应用相同的名称）。
单击“创建”。稍等几分钟，等服务部署成功后再继续。查看门户标题中的通知（铃铛）图标以获取状态更新。
部署完成后，单击“ 部署详细信息 ”部分，然后单击 Microsoft.Web/sites 类型的资源。它将导航到刚刚创建的应用服务 Web 应用。
单击“设置”下的“配置”边栏选项卡，并在“应用程序设置”中，单击“新建应用程序设置”按钮。
在“添加/编辑应用程序设置”页中，将名称输入为 MobileAppsManagement_EXTENSION_VERSION，将“值”输入为 latest 并点击“确定”。

你已准备好将此新创建的应用服务 Web 应用用作移动应用。

现已预配可供移动客户端应用程序使用的 Azure 移动应用后端。接下来，为简单的“待办事项列表”后端下载服务器项目并将其发布到 Azure。

创建数据库连接并配置客户端和服务器项目

下载以下平台的客户端 SDK 快速入门：

iOS (Objective-C)
iOS (Swift)
Android (Java)
Xamarin.iOS
Xamarin.Android
Xamarin.Forms
Cordova
Windows (C#)

注意

如果使用 iOS 项目，则需从最新 GitHub 版本中下载“azuresdk-iOS-*.zip”。将 MicrosoftAzureMobile.framework 文件解压缩并添加到项目的根目录中。
需要添加数据库连接，或者连接到现有的连接。首先，确定是要创建数据存储，还是使用现有的数据存储。
- 创建新的数据存储：若要创建数据存储，请使用以下快速入门：
  
  快速入门：开始使用 Azure SQL 数据库中的单一数据库
- 现有数据源：若要使用现有的数据库连接，请按以下说明操作
  1. SQL 数据库连接字符串格式 - Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}
    
    {your_SQLServer} ：服务器的名称，此项可以在数据库的概览页中找到，通常采用“server_name.database.windows.net”格式。 {port} ：通常为 1433。 {your_catalogue} ：数据库的名称。 {your_username} ：用于访问数据库的用户名。 {your_password} ：用于访问数据库的密码。
    
    详细了解 SQL 连接字符串格式
  2. 向移动应用添加连接字符串。可以在应用服务中管理应用程序的连接字符串，方法是使用菜单中的“配置”选项。
    
    若要添加连接字符串，请执行以下操作：
    1. 单击“应用程序设置” 选项卡。
    2. 单击“[+] 新建连接字符串”。
    3. 需为连接字符串提供“名称”、“值”和“类型”。
    4. 键入 MS_TableConnectionString 作为“名称”
    5. “值”应该是在前面的步骤中生成的连接字符串。
    6. 如果向 SQL Azure 数据库添加连接字符串，请在“类型”下选择“SQLAzure”。
Azure 移动应用有适用于 .NET 和 Node.js 后端的 SDK。
- Node.js backend
  
  若要使用 Node.js 快速入门应用，请按以下说明操作。
  1. 在 Azure 门户中转到“简易表”即可看到以下屏幕。
  2. 请确保已在 “配置 ”选项卡中添加 SQL 连接字符串。然后选中 “我确认这将覆盖所有网站内容 ”的复选框，然后单击“ 创建 TodoItem 表 ”按钮。
  3. 在“简易表”中单击“+ 添加”按钮。
  4. 创建允许匿名访问的 TodoItem 表。
- .NET 后端
  
  若要使用 .NET 快速入门应用，请按以下说明操作。
  1. 从 azure-mobile-apps-quickstarts 存储库下载 Azure 移动应用 .NET 服务器项目。
  2. 在 Visual Studio 中以本地方式生成 .NET 服务器项目。
  3. 在 Visual Studio 中打开解决方案资源管理器，右键单击 ZUMOAPPNAMEService 项目，单击“发布”，此时会出现“Publish to App Service”窗口。如果在 Mac 上工作，请单击此处了解部署应用的其他方式。
  4. 选择“应用服务” 作为发布目标，接着单击“选择现有”，然后单击窗口底部的“发布”按钮。
  5. 首先需通过 Azure 订阅登录 Visual Studio。选择 Subscription、Resource Group，然后选择应用的名称。准备就绪后，单击“确定”，这样就会将本地的 .NET 服务器项目部署到应用服务后端。部署完成后，系统会在浏览器中将你重定向到 http://{zumoappname}.azurewebsites.net/。

运行 Xamarin.Android 应用

打开 Xamarin.Android 项目。
转到 Azure 门户，并导航到已创建的移动应用。在 Overview 边栏选项卡上，查找作为移动应用公共终结点的 URL。示例 - 我的应用名称“test123”的站点名将为 https://test123.azurewebsites.net 。
打开此文件夹中的文件 ToDoActivity.cs - xamarin.android/ZUMOAPPNAME/ToDoActivity.cs。应用程序名称为 ZUMOAPPNAME。
在 ToDoActivity 类中，将 ZUMOAPPURL 变量替换为上面的公共终结点。

const string applicationURL = @"ZUMOAPPURL";

变为

const string applicationURL = @"https://test123.azurewebsites.net";
按 F5 键部署并运行应用。
在应用中键入有意义的文本（例如“完成教程” ），并单击“添加”图标。

来自请求的数据插入到 TodoItem 表。移动应用后端返回存储在表中的项，数据显示在列表中。

注意

可以查看访问移动应用后端以查询和插入数据的代码，这些代码在 ToDoActivity.cs C# 文件中。

故障排除

如果在生成解决方案时遇到问题，请运行 NuGet 包管理器并更新 Xamarin.Android 支持包。快速入门项目并非始终包含最新版本。

请注意，在项目中引用的所有支持包必须都具有相同的版本。对于 Android 平台，Azure 移动应用 NuGet 包具有 Xamarin.Android.Support.CustomTabs 依赖项，因此，如果你的项目使用较新的支持包，则你需要直接安装具有所需版本的此包以避免冲突。

通过