共用方式為


建立 Apache Cordova 應用程式

概觀

本教學課程示範如何使用 Azure 行動應用程式後端,將雲端式後端服務新增到 Apache Cordova 行動應用程式。 您會建立新的行動應用程式後端,以及可在 Azure 中儲存應用程式資料的簡易「待辦事項清單」 Apache Cordova 應用程式。

所有其他 Apache Cordova 教學課程只要是與使用 Azure App Service 中的 Mobile Apps 功能相關,都必須先完成本教學課程。

必要條件

若要完成本教學課程,您需要下列必要條件:

您也可以略過 Visual Studio 而直接使用 Apache Cordova 命令列。 在 Mac 電腦上完成本教學課程時,使用命令列相當有用。 本教學課程未涵蓋使用命令列來編譯 Apache Cordova 用戶端應用程式。

建立 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/

下載並執行 Apache Cordova 應用程式

  1. 流覽至用戶端專案中的方案檔 (.sln) ,並使用 Visual Studio 加以開啟。

  2. 在 Visual Studio 中,從開始箭號旁邊的下拉式清單中選擇解決方案平台 (Android、iOS 或 Windows)。 按一下綠色箭號上的下拉式清單以選取特定的部署裝置或模擬器。 您可以使用預設 Android 平台和 Ripple 模擬器。 更進階的教學課程 (例如,推播通知) 會要求您選取支援的裝置或模擬器。

  3. 開啟此資料夾中的檔案 ToDoActivity.java - ZUMOAPPNAME/app/src/main/java/com/example/zumoappname。 應用程式名稱是 ZUMOAPPNAME

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

  5. index.js移至 ZUMOAPPNAME/www/js/index.js 中的 檔案,然後在 方法中 onDeviceReady() ,將 參數取代 ZUMOAPPURL 為上述公用端點。

    client = new WindowsAzure.MobileServiceClient('ZUMOAPPURL');

    變成

    client = new WindowsAzure.MobileServiceClient('https://test123.azurewebsites.net');

  6. 若要建置和執行 Cordova 應用程式,請按 F5 或按一下綠色箭號。 如果您在模擬器中看到要求網路存取權的安全性對話方塊,請接受它。

  7. 在裝置或模擬器上啟動應用程式之後,在 [輸入新文字] 中輸入有意義的文字,例如 完成教學課程 ,然後按一下 [ 新增 ] 按鈕。

後端會將要求中的資料插入 SQL Database 中的 TodoItem 資料表,並將新儲存之項目的相關資訊傳回給行動應用程式。 行動應用程式會以清單顯示此資料。

您可以對其他平台重複步驟 3 到 5。