建立 Xamarin.Android 應用程式

發行項
06/25/2019

概觀

本教學課程說明如何將雲端式後端服務新增至 Xamarin.Android 應用程式。如需詳細資訊，請參閱什麼是Mobile Apps。

已完成應用程式的螢幕快照如下：

完成本教學課程是 Xamarin.Android 應用程式所有其他 Mobile Apps 教學課程的必要條件。

先決條件

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

作用中的 Azure 帳戶。如果您沒有帳戶，請註冊 Azure 試用版，並取得最多 10 個免費的 Mobile Apps。如需詳細資料，請參閱 Azure 免費試用。
Visual Studio 與 Xamarin。如需有關 Visual Studio 和 Xamarin 的設定和安裝指示，請參閱和。

建立 Azure 行動應用程式後端

請遵循下列步驟來建立行動應用程式後端。

登入 Azure 入口網站。
按一下 [建立資源]。
在搜尋方塊中，輸入 Web App。
在結果清單中，從 Marketplace 選取 [Web 應用程式]。
選取您的 訂用帳戶 並 資源群組（選取現有的資源群組或建立新的資源群組（使用與您的應用程式同名））。
請為您的網絡應用程式選擇唯一的名稱。
選擇預設 [發佈] 選項作為 Code。
在 執行時間堆疊中，您必須在 ASP.NET 或 Node下選取版本。如果您要建置 .NET 後端，請在 [ASP.NET] 底下選取版本。否則，如果您是以節點為基礎的應用程式為目標，請從 [節點] 選取其中一個版本。
選取正確的 作業系統，選擇 Linux 或 Windows。
選取您想要部署此應用程式的區域。
選取適當的 App Service 方案，並按 [檢閱 ]，然後建立。
在 [資源群組]下，選取現有的資源群組或建立新的資源群組（使用與應用程式相同的名稱）。
點擊建立。請稍候幾分鐘，讓服務順利部署，再繼續進行。在入口網站標頭中觀看通知（鈴鐺）圖示，以取得狀態更新。
部署完成後，按一下 [部署詳細資料] 區段，然後按一下類型為 Microsoft.Web/sites的資源。它會將您導引至您剛才建立的 App Service Web 應用程式。
按兩下 [設定] 下的 [組態] 刀鋒視窗，然後在 [應用程式設定]中，按兩下 [[新增應用程式設定] 按鈕。
在 [新增/編輯應用程式設定] 頁面中，輸入 [名稱] 為 [MobileAppsManagement_EXTENSION_VERSION] 和 [值] 最新的，然後按 [確定]。

您已準備好將這個新建立的 App Service Web 應用程式作為行動應用程式來使用。

您現在已佈建可供行動用戶端應用程式使用的 Azure 行動應用程式後端。接下來，下載簡單「todo 清單」後端的伺服器專案，並將其發佈至 Azure。

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

下載下列平臺的用戶端 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 Database 中的單一資料庫
- 現有的數據源：如果您想要使用現有的資料庫連線，請遵循下列指示
  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. 您必須為連接字串提供 Name、Value 和 Type。
    4. 將 的名稱輸入為 作為 MS_TableConnectionString
    5. 值應該是您在之前步驟中形成的連接字串。
    6. 如果您要將連接字串新增至 SQL Azure 資料庫，請選擇 [SQLAzure] 底下的 [類型]。
Azure Mobile Apps 具有適用於 .NET 和 Node.js 後端的 SDK。
- Node.js 後端
  
  如果您要使用 Node.js 快速入門應用程式，請遵循下列指示。
  1. 在 Azure 入口網站中，移至 Easy Tables，您會看到此畫面。
  2. 請確定已在 [組態] 索引標籤中新增 SQL 連接字串。然後勾選 [] 我確認這會覆寫所有網站內容，並點擊 [建立 TodoItem 表格] 按鈕。
  3. 在 Easy Tables中，按一下 + 新增 按鈕。
  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，請參閱這裡部署應用程式的其他方式。
  4. 選擇 App Service 作為發佈目標，然後點擊 選取現有，接著點擊視窗底部的發佈按鈕。
  5. 您必須先使用 Azure 訂用帳戶登入 Visual Studio。選取 Subscription、Resource Group，然後選取應用程式的名稱。當您準備好時，請按兩下 [確定] ，這會將本機擁有的 .NET 伺服器專案部署至 App Service 後端。部署完成時，系統會將您重新導向至瀏覽器中的 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 數據表。儲存在數據表中的專案會由行動應用程式後端傳回，而數據會出現在清單中。

備註

您可以檢閱可存取行動應用程式後端以查詢和插入數據的程式代碼，其位於 C# 檔案ToDoActivity.cs。

故障排除

如果您在建置解決方案時遇到問題，請執行 NuGet 套件管理員，並更新 Xamarin.Android 支援套件。快速入門專案不一定包含最新版本。

請注意，您項目中參考的所有支援套件都必須有相同的版本。 Azure Mobile Apps NuGet 套件具有 Android 平臺 Xamarin.Android.Support.CustomTabs 相依性，因此如果您的專案使用較新的支援套件，您需要直接使用必要的版本安裝此套件，以避免衝突。

共用方式為