建立具有 Azure 後端的 Windows 應用程式

概觀

本教學課程顯示如何將雲端型後端服務新增到通用 Windows 平台 (UWP) 應用程式。 如需詳細資訊,請參閱 什麼是 Mobile Apps?。 以下是已完成之應用程式的螢幕截圖:

完成的電腦桌面應用程式

完成本教學課程是 UWP 應用程式的所有其他行動應用程式教學課程的必要條件。

必要條件

若要完成此教學課程,您需要下列項目:

  • 使用中的 Azure 帳戶。 如果您沒有帳戶,可以註冊 Azure 試用版並取得最多 10 個免費的行動應用程式,即使在試用期結束之後仍可繼續使用這些應用程式。 如需詳細資料,請參閱 Azure 免費試用
  • Windows 10。
  • Visual Studio Community 2017。
  • 熟悉如何開發 UWP 應用程式。 請瀏覽 UWP 文件,以了解如何完成設定來建置 UWP 應用程式。

建立新的 Azure 行動應用程式後端

依照下列步驟建立新的行動應用程式後端。

  1. 登入 Azure 入口網站

  2. 按一下 [建立資源]。

  3. 在搜尋方塊中,輸入 Web 應用程式

  4. 在結果清單中,從 Marketplace 選取 [Web 應用程式 ]。

  5. 選取您的 用帳戶和資源 群組 (選取現有的資源群組, 或使用 與應用程式相同的名稱建立新的資源群組) ) (。

  6. 選擇 Web 應用程式的唯一 名稱

  7. 選擇預設的 [發佈] 選項作為 [程式碼]。

  8. 執行時間堆疊中,您必須在 [ASP.NET ] 或 [ 節點] 下選取版本。 如果您要建置 .NET 後端,請在 [ASP.NET] 底下選取版本。 否則,如果您要以節點為基礎的應用程式為目標,請從 Node 選取其中一個版本。

  9. 選取正確的 作業系統,可以是 Linux 或 Windows。

  10. 選取您要部署此應用程式的 [區域 ]。

  11. 選取適當的App Service方案,然後按[檢閱並建立]。

  12. 在 [資源群組] 下,選取現有的資源群組或建立新的資源群組 (使用與應用程式相同的名稱)。

  13. 按一下 [建立]。 等候幾分鐘的時間來成功地部署服務,然後再繼續進行。 監看狀態更新入口網站標頭中的 [通知] \(鈴鐺) 圖示。

  14. 部署完成後,按一下 [ 部署詳細資料 ] 區段,然後按一下 [類型 Microsoft.Web/sites] 的資源。 它會巡覽至您剛才建立的 App Service Web 應用程式。

  15. 按一下 [設定] 下的 [組] 刀鋒視窗,然後在 [應用程式設定] 中,按一下 [新增應用程式設定] 按鈕。

  16. 在 [ 新增/編輯應用程式設定 ] 頁面中,輸入 [名稱 ] 作為 [MobileAppsManagement_EXTENSION_VERSION ] 和 [值] 作為 [最新 ],然後按 [確定]。

您全都已設定為使用此新建立的 App Service Web 應用程式作為行動應用程式。

建立資料庫連線並設定用戶端和伺服器專案

  1. 下載下列平臺的用戶端 SDK 快速入門:

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

    注意

    如果您使用 iOS 專案,則必須從 最新的 GitHub 版本下載 「azuresdk-iOS-*.zip」。 將檔案解壓縮並新增 MicrosoftAzureMobile.framework 至專案的根目錄。

  2. 您必須新增資料庫連接,或連接到現有的連接。 首先,判斷您要建立資料存放區,還是使用現有的存放區。

    • 建立新的資料存放區:如果您要建立資料存放區,請使用下列快速入門:

      快速入門:開始使用 Azure SQL 資料庫中的單一資料庫

    • 現有的資料來源:如果您想要使用現有的資料庫連線,請遵循下列指示

      1. SQL Database連接字串格式 -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. 將連接字串新增至行動應用程式在 App Service 中,您可以使用功能表中的 [組] 選項來管理應用程式的連接字串。

        若要新增連接字串:

        1. 按一下 [ 應用程式設定] 索引 標籤。

        2. 按一下 [+] [+] [新增連接字串]。

        3. 您必須為連接字串提供 [名稱]、[ ] 和 [ 類型 ]。

        4. 輸入 名稱 作為 MS_TableConnectionString

        5. 值應該是您在之前步驟中形成的連接字串。

        6. 如果您要將連接字串新增至SQL Azure資料庫,請選擇[類型] 下的[SQLAzure]。

  3. Azure Mobile Apps 具有適用于 .NET 和Node.js後端的 SDK。

    • Node.js 後端

      如果您要使用 Node.js 快速入門應用程式,請遵循下列指示。

      1. 在Azure 入口網站中,移至[簡易資料表],您會看到此畫面。

        節點簡易資料表

      2. 請確定已在 [組 ] 索引標籤中新增 SQL 連接字串。然後核取 [我確認這會覆寫所有網站內容] 的 方塊,然後按一下 [ 建立 TodoItem 資料表 ] 按鈕。

        節點簡易資料表設定

      3. [簡單資料表] 中,按一下 [ + 新增] 按鈕。

        節點簡易資料表新增按鈕

      4. 建立具有匿名存取權的 TodoItem 資料表。

        節點簡易資料表新增資料表

    • .NET 後端

      如果您要使用 .NET 快速入門應用程式,請遵循下列指示。

      1. azure-mobile-apps-quickstarts 存放庫下載 Azure Mobile Apps .NET 伺服器專案。

      2. 在 Visual Studio 本機建置 .NET 伺服器專案。

      3. 在 Visual Studio 中,開啟 [方案總管],以滑鼠右鍵按一下 ZUMOAPPNAMEService 專案,按一下 [發佈],您會看到視窗 Publish to App Service 。 如果您正在 Mac 上工作,請參閱 這裡部署應用程式的其他方式。

        Visual Studio 發佈

      4. 選取[App Service為發佈目標],然後按一下 [選取現有],然後按一下視窗底部的 [發佈] 按鈕。

      5. 您必須先使用 Azure 訂用帳戶登入 Visual Studio。 Subscription選取 、 Resource Group ,然後選取應用程式的名稱。 當您準備好時,按一下 [確定],這會將本機擁有的 .NET 伺服器專案部署至App Service後端。 部署完成時,您會在瀏覽器中重新導向至 http://{zumoappname}.azurewebsites.net/

執行用戶端專案

  1. 開啟 UWP 專案。

  2. 移至Azure 入口網站,然後流覽至您建立的行動應用程式。 在 Overview 刀鋒視窗上,尋找 URL,這是行動應用程式的公用端點。 範例 - 我的應用程式名稱 「test123」 的網站名稱將是 https://test123.azurewebsites.net

  3. 開啟此資料夾中的檔案 App.xaml.cs - windows-uwp-cs/ZUMOAPPNAME/。 應用程式名稱是 ZUMOAPPNAME

  4. 在 類別中 App ,將 參數取代 ZUMOAPPURL 為上述公用端點。

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

    變成

    public static MobileServiceClient MobileService = new MobileServiceClient("https://test123.azurewebsites.net");

  5. 按 F5 鍵以部署並執行應用程式。

  6. 在應用程式的 [插入 TodoItem] 文字方塊中輸入有意義的文字 (例如「完成教學課程」(Complete the tutorial)」),然後按一下 [儲存]

    Windows 快速入門完整桌面

    如此會傳送 POST 要求到 Azure 中代管的新行動應用程式後端。