Tworzenie aplikacji platformy Xamarin.Android

Omówienie

W tym samouczku przedstawiono sposób dodawania usługi zaplecza opartej na chmurze do aplikacji platformy Xamarin.Android. Aby uzyskać więcej informacji, zobacz artykuł Co to jest usługa Mobile Apps.

Zrzut ekranu gotowej aplikacji znajduje się poniżej:

Wykonanie czynności opisanych w tym samouczku jest wymaganiem wstępnym dla wszystkich innych samouczków usługi Mobile Apps dotyczących aplikacji platformy Xamarin.Android.

Wymagania wstępne

Do wykonania kroków tego samouczka niezbędne jest spełnienie następujących wymagań wstępnych:

  • Aktywne konto platformy Azure. Jeśli nie masz konta, skorzystaj z bezpłatnej wersji próbnej platformy Azure i uzyskaj maksymalnie 10 bezpłatnych aplikacji mobilnych. Aby uzyskać szczegółowe informacje, zobacz Bezpłatna wersja próbna platformy Azure.
  • Visual Studio z programem Xamarin. Instrukcje można znaleźć w temacie Setup and install for Visual Studio and Xamarin (Konfigurowanie i instalowanie dla programów Visual Studio i Xamarin).

Tworzenie zaplecza Aplikacji mobilnej Azure

Wykonaj te kroki, aby utworzyć zaplecze aplikacji mobilnej.

  1. Zaloguj się w witrynie Azure Portal.

  2. Kliknij pozycję Utwórz zasób.

  3. W polu wyszukiwania wpisz Web App.

  4. Na liście wyników wybierz pozycję Aplikacja internetowa z witryny Marketplace.

  5. Wybierz subskrypcję igrupę zasobów (wybierz istniejącą grupę zasobów lub utwórz nową (używając tej samej nazwy co aplikacja)).

  6. Wybierz unikatową nazwę aplikacji internetowej.

  7. Wybierz domyślną opcję Publikuj jako Kod.

  8. W stosie Środowisko uruchomieniowe należy wybrać wersję w obszarze ASP.NET lub Node. Jeśli tworzysz zaplecze platformy .NET, wybierz wersję w obszarze ASP.NET. W przeciwnym razie, jeśli jest przeznaczona dla aplikacji opartej na węźle, wybierz jedną z wersji z węzła.

  9. Wybierz odpowiedni system operacyjny, Linux lub Windows.

  10. Wybierz region , w którym chcesz wdrożyć tę aplikację.

  11. Wybierz odpowiedni App Service plan i wybierz pozycję Przejrzyj i utwórz.

  12. W obszarze Grupa zasobów wybierz istniejącą grupę zasobów lub utwórz nową (używając tej samej nazwy, co aplikacja).

  13. Kliknij pozycję Utwórz. Zanim przejdziesz do kolejnych kroków, odczekaj kilka minut, aby usługa została wdrożona pomyślnie. Obserwuj ikonę powiadomień (dzwonek) w nagłówku portalu, pokazującą aktualizacje stanu.

  14. Po zakończeniu wdrażania kliknij sekcję Szczegóły wdrożenia , a następnie kliknij pozycję Zasób typu Microsoft.Web/sites. Spowoduje to przejście do właśnie utworzonej aplikacji internetowej App Service.

  15. Kliknij blok Konfiguracja w obszarze Ustawienia i w ustawieniach aplikacji kliknij przycisk Nowe ustawienie aplikacji .

  16. Na stronie ustawienia Dodaj/Edytuj aplikację wprowadź ciąg Nazwa jako MobileAppsManagement_EXTENSION_VERSION i Wartość jako najnowsza i naciśnij przycisk OK.

Wszystko jest ustawione na użycie tej nowo utworzonej aplikacji internetowej App Service jako aplikacji mobilnej.

W ten sposób zainicjowano obsługę zaplecza Aplikacji mobilnej Azure, które może być używane przez aplikacje mobilne klientów. Następnie należy pobrać projekt serwera dla prostego zaplecza typu „lista czynności do wykonania” i opublikować go na platformie Azure.

Tworzenie połączenia z bazą danych i konfigurowanie projektu klienta i serwera

  1. Pobierz przewodniki Szybki start zestawu SDK klienta dla następujących platform:

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

    Uwaga

    Jeśli używasz projektu systemu iOS, musisz pobrać plik "azuresdk-iOS-*.zip" z najnowszej wersji usługi GitHub. Rozpakuj MicrosoftAzureMobile.framework i dodaj plik do katalogu głównego projektu.

  2. Musisz dodać połączenie z bazą danych lub nawiązać połączenie z istniejącym połączeniem. Najpierw określ, czy utworzysz magazyn danych, czy użyjesz istniejącego magazynu danych.

    • Utwórz nowy magazyn danych: jeśli zamierzasz utworzyć magazyn danych, skorzystaj z następującego przewodnika Szybki start:

      Szybki start: wprowadzenie do pojedynczych baz danych w usłudze Azure SQL Database

    • Istniejące źródło danych: postępuj zgodnie z poniższymi instrukcjami, jeśli chcesz użyć istniejącego połączenia z bazą danych

      1. format parametrów połączenia SQL Database —Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}

        {your_SQLServer} Nazwa serwera, można go znaleźć na stronie przeglądu bazy danych i jest zwykle w postaci "server_name.database.windows.net". {port} zwykle 1433. {your_catalogue} Nazwa bazy danych. {your_username} Nazwa użytkownika w celu uzyskania dostępu do bazy danych. {your_password} Hasło dostępu do bazy danych.

        Dowiedz się więcej o formacie parametrów połączenia SQL

      2. Dodaj parametry połączenia do aplikacji mobilnej W App Service możesz zarządzać parametrami połączenia dla aplikacji przy użyciu opcji Konfiguracja w menu.

        Aby dodać parametry połączenia:

        1. Kliknij kartę Ustawienia aplikacji .

        2. Kliknij pozycję [+] Nowe parametry połączenia.

        3. Musisz podać nazwę, wartość i typ parametrów połączenia.

        4. Wpisz nazwę jako MS_TableConnectionString

        5. Wartość powinna być ciągiem łączenia utworzonym w kroku przed.

        6. W przypadku dodawania parametrów połączenia do bazy danych Usługi SQL Azure wybierz pozycję SQLAzure w obszarze typ.

  3. Usługa Azure Mobile Apps ma zestawy SDK dla platformy .NET i Node.js zapleczy.

    • zapleczeNode.js

      Jeśli zamierzasz użyć Node.js aplikacji Szybki start, postępuj zgodnie z poniższymi instrukcjami.

      1. W Azure Portal przejdź do pozycji Łatwe tabele, zobaczysz ten ekran.

        Łatwe tabele węzłów

      2. Upewnij się, że parametry połączenia SQL zostały już dodane na karcie Konfiguracja . Następnie zaznacz pole wyboru Potwierdzam, że spowoduje to zastąpienie całej zawartości witryny i kliknij przycisk Utwórz tabelę TodoItem .

        Konfiguracja łatwych tabel węzłów

      3. W obszarze Łatwe tabele kliknij przycisk + Dodaj .

        Przycisk Dodawania tabel łatwych w węźle

      4. Utwórz tabelę z dostępem TodoItem anonimowym.

        Tabele łatwe w węźle — dodawanie tabeli

    • Zaplecze .NET

      Jeśli zamierzasz korzystać z aplikacji Szybki start platformy .NET, postępuj zgodnie z poniższymi instrukcjami.

      1. Pobierz projekt serwera .NET usługi Azure Mobile Apps z repozytorium azure-mobile-apps-quickstarts.

      2. Skompiluj projekt serwera .NET lokalnie w programie Visual Studio.

      3. W programie Visual Studio otwórz Eksplorator rozwiązań, kliknij prawym przyciskiem myszy projekt, kliknij pozycję ZUMOAPPNAMEServicePublikuj, zostanie wyświetlone Publish to App Service okno. Jeśli pracujesz na komputerze Mac, zapoznaj się z innymi sposobami wdrażania aplikacji tutaj.

        Publikowanie w programie Visual Studio

      4. Wybierz pozycję App Service jako element docelowy publikowania, a następnie kliknij pozycję Wybierz istniejącą, a następnie kliknij przycisk Publikuj w dolnej części okna.

      5. Najpierw musisz zalogować się do programu Visual Studio przy użyciu subskrypcji platformy Azure. Wybierz element Subscription, Resource Group, a następnie wybierz nazwę aplikacji. Gdy wszystko będzie gotowe, kliknij przycisk OK, spowoduje to wdrożenie projektu serwera .NET, który został lokalnie wdrożony w zapleczu App Service. Po zakończeniu wdrażania nastąpi przekierowanie do http://{zumoappname}.azurewebsites.net/ przeglądarki.

Uruchamianie aplikacji Xamarin.Android

  1. Otwórz projekt platformy Xamarin.Android.

  2. Przejdź do Azure Portal i przejdź do utworzonej aplikacji mobilnej. Overview W bloku wyszukaj adres URL, który jest publicznym punktem końcowym aplikacji mobilnej. Przykład — nazwa witryny dla mojej nazwy aplikacji "test123" będzie mieć https://test123.azurewebsites.netwartość .

  3. Otwórz plik ToDoActivity.cs w tym folderze — xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. Nazwa aplikacji to ZUMOAPPNAME.

  4. W ToDoActivity klasie zastąp ZUMOAPPURL zmienną publicznym punktem końcowym powyżej.

    const string applicationURL = @"ZUMOAPPURL";

    Staje się

    const string applicationURL = @"https://test123.azurewebsites.net";

  5. Naciśnij klawisz F5, aby wdrożyć i uruchomić aplikację.

  6. W aplikacji wpisz znaczący tekst, na przykład Ukończ samouczek, a następnie kliknij przycisk Dodaj.

    Dane z żądania zostaną wstawione do tabeli czynności do wykonania. Elementy przechowywane w tabeli są zwracane przez zaplecze aplikacji mobilnej, a dane są wyświetlane na liście.

    Uwaga

    Możesz przejrzeć kod uzyskujący dostęp do zaplecza aplikacji mobilnej w celu wyszukiwania i wstawiania danych. Znajduje się on w pliku C# ToDoActivity.cs.

Rozwiązywanie problemów

Jeśli masz problemy z kompilowaniem rozwiązania, uruchom menedżera pakietów NuGet i zaktualizuj pakiety dla pomocy technicznej Xamarin.Android. Projekty typu Szybki start nie zawsze zawierają najnowsze wersje.

Pamiętaj, że wszystkie pakiety dla pomocy technicznej, do których odwołuje się projekt, muszą mieć tę samą wersję. Pakiet NuGet usługi Azure Mobile Apps ma zależność Xamarin.Android.Support.CustomTabs dla platformy Android, więc jeśli projekt używa nowszych pakietów dla pomocy technicznej, musisz bezpośrednio zainstalować ten pakiet w wymaganej wersji w celu uniknięcia konfliktów.