使用 Azure 后端创建 Windows 应用

2019-06-25

概述

本教程介绍如何将基于云的后端服务添加到通用 Windows 平台（UWP）应用。有关详细信息，请参阅什么是移动应用。以下是已完成应用的屏幕截图：

已完成的桌面应用

完成本教程是 UWP 应用的其他所有移动应用教程的先决条件。

先决条件

若要完成本教程，需要满足以下条件：

有效的 Azure 帐户。如果没有帐户，可以注册 Azure 试用版，并获取最多 10 个免费移动应用，即使在试用结束后仍可使用。有关详细信息，请参阅 Azure 免费试用。
Windows 10。
Visual Studio Community 2017。
熟悉 UWP 应用开发。请访问 UWP 文档，了解如何设置以生成 UWP 应用。

创建新的 Azure 移动应用后端

按照以下步骤创建新的移动应用后端。

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

你已经准备好使用这个新创建的应用服务网站作为移动应用。

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

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

iOS （Objective-C）
iOS （Swift）
Android （Java）
Xamarin.iOS
Xamarin.Android
Xamarin.Forms
科尔多瓦
 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 后端
  
  如果要使用 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/。

运行客户端项目

打开 UWP 项目。
转到 Azure 门户并导航到创建的移动应用。在 Overview 面板上，查找作为移动应用公共终结点的 URL。示例 - 我的应用名称“test123”的站点名称将是https://test123.azurewebsites.net。
打开此文件夹中的文件 App.xaml.cs - windows-uwp-cs/ZUMOAPPNAME/。应用程序名称 ZUMOAPPNAME。
在 App 类中，将 ZUMOAPPURL 参数替换为上面的公共端点。

public static MobileServiceClient MobileService = new MobileServiceClient("ZUMOAPPURL");

将变为

public static MobileServiceClient MobileService = new MobileServiceClient("https://test123.azurewebsites.net");
按 F5 键部署并运行应用。
在应用中，在“插入 TodoItem”文本框中键入有意义的文本，如“完成教程”，然后单击“保存”。

这会向 Azure 中托管的新移动应用后端发送 POST 请求。

通过

使用 Azure 后端创建 Windows 应用

概述

先决条件

创建新的 Azure 移动应用后端

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

运行客户端项目

其他资源