Tworzenie aplikacji platformy Xamarin.iOS za pomocą usługi Azure Mobile Apps
W tym samouczku pokazano, jak dodać usługę zaplecza opartą na chmurze do aplikacji mobilnej systemu iOS przy użyciu platformy Xamarin.iOS i zaplecza aplikacji mobilnych platformy Azure. Utworzysz zarówno nowe zaplecze aplikacji mobilnej, jak i prostą aplikację listy zadań do wykonania, która przechowuje dane aplikacji na platformie Azure.
Ten samouczek należy wykonać przed innymi samouczkami platformy Xamarin.iOS przy użyciu funkcji Mobile Apps w usłudze aplikacja systemu Azure Service.
Wymagania wstępne
Do ukończenia tego samouczka niezbędne są następujące elementy:
- Program Visual Studio 2022 z następującymi obciążeniami.
- Tworzenie aplikacji na platformie ASP.NET i aplikacji internetowych
- Tworzenie aplikacji na platformie Azure
- Tworzenie aplikacji mobilnych za pomocą platformy .NET
- Konto platformy Azure.
- Interfejs wiersza polecenia platformy Azure.
az login
Zaloguj się przy użyciu polecenia i wybierz odpowiednią subskrypcję przed rozpoczęciem.
- (Opcjonalnie) Interfejs wiersza polecenia dla deweloperów platformy Azure.
- Dostępny komputer Mac:
- Instalowanie programu XCode
- Otwórz program Xcode po zainstalowaniu, aby można było dodać dodatkowe wymagane składniki.
- Po otwarciu wybierz pozycję Preferencje XCode...>Składniki i instalowanie symulatora systemu iOS.
- Postępuj zgodnie z przewodnikiem, aby sparować z komputerem Mac.
Do skompilowania wersji systemu iOS wymagany jest komputer Mac.
Pobieranie przykładowej aplikacji
Otwórz repozytorium azure-mobile-apps w przeglądarce.
Otwórz listę rozwijaną Kod , a następnie wybierz pozycję Pobierz plik ZIP.
Po zakończeniu pobierania otwórz folder Pobrane i znajdź
azure-mobile-apps-main.zip
plik.Kliknij prawym przyciskiem myszy pobrany plik, a następnie wybierz polecenie Wyodrębnij wszystko....
Jeśli wolisz, możesz użyć programu PowerShell, aby rozwinąć archiwum:
C:\Temp> Expand-Archive azure-mobile-apps-main.zip
Przykłady znajdują się w folderze samples w wyodrębnionych plikach. Przykład dla przewodnika Szybki start nosi nazwę TodoApp
. Przykład można otworzyć w programie Visual Studio, klikając TodoApp.sln
dwukrotnie plik.
Wdrażanie zaplecza na platformie Azure
Uwaga
Jeśli zaplecze zostało już wdrożone z innego przewodnika Szybki start, możesz użyć tego samego zaplecza i pominąć ten krok.
Aby wdrożyć usługę zaplecza, wykonamy następujące kroki:
- Aprowizuj usługę aplikacja systemu Azure i usługę Azure SQL Database na platformie Azure.
- Użyj programu Visual Studio, aby wdrożyć kod usługi w nowo utworzonej usłudze aplikacja systemu Azure.
Wykonaj wszystkie kroki za pomocą interfejsu wiersza polecenia dla deweloperów platformy Azure
Przykład aplikacji TodoApp jest skonfigurowany do obsługi interfejsu wiersza polecenia dla deweloperów platformy Azure. Aby wykonać wszystkie kroki (aprowizowanie i wdrażanie):
- Zainstaluj interfejs wiersza polecenia dla deweloperów platformy Azure.
- Otwórz terminal i zmień katalog na folder zawierający
TodoApp.sln
plik. Ten katalog zawieraazure.yaml
również plik . - Uruchom program
azd up
.
Jeśli jeszcze nie zalogowałeś się na platformie Azure, przeglądarka zostanie uruchomiona, aby poprosić Cię o zalogowanie. Następnie zostanie wyświetlony monit o użycie subskrypcji i regionu platformy Azure. Następnie interfejs wiersza polecenia dla deweloperów platformy Azure aprowizuje niezbędne zasoby i wdraża kod usługi w wybranym regionie i subskrypcji platformy Azure. Na koniec interfejs wiersza polecenia dewelopera platformy Azure zapisuje odpowiedni Constants.cs
plik.
Możesz uruchomić azd env get-values
polecenie , aby wyświetlić informacje o uwierzytelnianiu SQL, jeśli chcesz uzyskać bezpośredni dostęp do bazy danych.
Jeśli wykonano kroki z interfejsem wiersza polecenia dla deweloperów platformy Azure, przejdź do następnego kroku. Jeśli nie chcesz używać interfejsu wiersza polecenia dla deweloperów platformy Azure, wykonaj kroki ręczne.
Tworzenie zasobów na platformie Azure.
Otwórz terminal i zmień katalog na folder zawierający
TodoApp.sln
plik. Ten katalog zawieraazuredeploy.json
również plik .Upewnij się, że zalogowałeś się i wybrano subskrypcję przy użyciu interfejsu wiersza polecenia platformy Azure.
Utwórz nową grupę zasobów:
az group create -l westus -g quickstart
To polecenie tworzy grupę
quickstart
zasobów w regionie Zachodnie stany USA. Możesz wybrać dowolny region, pod warunkiem, że możesz tam utworzyć zasoby. Upewnij się, że używasz tej samej nazwy i regionu, gdziekolwiek wspomniano w tym samouczku.Utwórz zasoby przy użyciu wdrożenia grupy:
az deployment group create -g quickstart --template-file azuredeploy.json --parameters sqlPassword=MyPassword1234
Wybierz silne hasło dla hasła Administracja istratora SQL. Będzie ona potrzebna później podczas uzyskiwania dostępu do bazy danych.
Po zakończeniu wdrażania pobierz zmienne wyjściowe, ponieważ zawierają one ważne informacje potrzebne później:
az deployment group show -g quickstart -n azuredeploy --query properties.outputs
Przykładowe dane wyjściowe to:
Zanotuj wszystkie wartości w danych wyjściowych do późniejszego użycia.
Publikowanie kodu usługi
Otwórz plik TodoApp.sln
w programie Visual Studio.
W okienku po prawej stronie wybierz Eksplorator rozwiązań.
Kliknij prawym przyciskiem myszy
TodoAppService.NET6
projekt, a następnie wybierz polecenie Ustaw jako projekt startowy.W górnym menu wybierz pozycję Build Publish TodoAppService.NET6 (Kompiluj>publikację todoAppService.NET6).
W oknie Publikowanie wybierz pozycję Cel: Azure, a następnie naciśnij przycisk Dalej.
Wybierz pozycję Określony element docelowy: aplikacja systemu Azure Service (Windows), a następnie naciśnij przycisk Dalej.
W razie potrzeby zaloguj się i wybierz odpowiednią nazwę subskrypcji.
Upewnij się, że ustawienie Widok ma wartość Grupa zasobów.
Rozwiń grupę zasobów, a następnie wybierz usługę
quickstart
App Service, która została utworzona wcześniej.Wybierz Zakończ.
Po zakończeniu procesu tworzenia profilu publikowania wybierz pozycję Zamknij.
Znajdź zależności usługi i wybierz potrójne kropki obok bazy danych programu SQL Server, a następnie wybierz pozycję Połączenie.
Wybierz pozycję Azure SQL Database, a następnie wybierz pozycję Dalej.
Wybierz bazę danych szybkiego startu, a następnie wybierz pozycję Dalej.
Wypełnij formularz przy użyciu nazwy użytkownika i hasła SQL, które znajdowały się w danych wyjściowych wdrożenia, a następnie wybierz pozycję Dalej.
Wybierz Zakończ.
Po zakończeniu wybierz pozycję Zamknij .
Wybierz pozycję Publikuj, aby opublikować aplikację w utworzonej wcześniej usłudze aplikacja systemu Azure.
Po opublikowaniu usługi zaplecza zostanie otwarta przeglądarka. Dodaj
/tables/todoitem?ZUMO-API-VERSION=3.0.0
do adresu URL:
Konfigurowanie przykładowej aplikacji
Aplikacja kliencka musi znać podstawowy adres URL zaplecza, aby mogła się z nią komunikować.
Jeśli użyto
azd up
metody aprowizacji i wdrożenia usługi,Constants.cs
plik został utworzony dla Ciebie i możesz pominąć ten krok.
TodoApp.Data
Rozwiń projekt.Kliknij prawym przyciskiem myszy
TodoApp.Data
projekt, a następnie wybierz polecenie Dodaj>klasę....Wprowadź
Constants.cs
jako nazwę, a następnie wybierz pozycję Dodaj.Constants.cs.example
Otwórz plik i skopiuj zawartość (Ctrl-A, a następnie ctrl-C).Przełącz się na
Constants.cs
, wyróżnij cały tekst (Ctrl-A), a następnie wklej zawartość z przykładowego pliku (Ctrl-V).Zastąp element
https://APPSERVICENAME.azurewebsites.net
adresem URL zaplecza usługi.namespace TodoApp.Data { public static class Constants { /// <summary> /// The base URI for the Datasync service. /// </summary> public static string ServiceUri = "https://demo-datasync-quickstart.azurewebsites.net"; } }
Adres URL zaplecza usługi można uzyskać z karty Publikowanie. Upewnij się, że używasz adresu URL https.
Zapisz plik. (Ctrl-S).
Skompiluj i uruchom aplikację
W Eksploratorze rozwiązań rozwiń
xamarin-native
folder .Kliknij projekt prawym przyciskiem myszy
TodoApp.iOS
i wybierz polecenie Ustaw jako Projekt startowy.Na górnym pasku wybierz pozycję i Telefon Konfiguracja symulatora i element docelowy TodoApp.iOS:
Wybierz odpowiedni symulator i Telefon (wybrano i Telefon SE z systemem iOS 15.5).
Naciśnij klawisz F5 , aby skompilować i uruchomić projekt.
Po uruchomieniu aplikacji zobaczysz pustą listę i pole tekstowe, aby dodać elementy w emulatorze. Masz następujące możliwości:
- Naciśnij przycisk , + aby dodać element.
- Wybierz element, aby ustawić lub wyczyścić flagę ukończoną.
- Naciśnij ikonę odświeżania, aby ponownie załadować dane z usługi.
Rozwiązywanie problemów
Zdalny symulator dostarczany z programem Visual Studio 2022 jest niezgodny z programem XCode 13.3. Zostanie wyświetlony następujący komunikat o błędzie:
Aby obejść ten problem:
- Wyłącz symulator zdalny (Narzędzia / Opcje / iOS Ustawienia / usuń zaznaczenie zdalnego symulatora systemu Windows). Po usunięciu zaznaczenia symulator zostanie uruchomiony na komputerze Mac zamiast w systemie Windows. Następnie możesz korzystać z symulatora bezpośrednio na komputerze Mac podczas korzystania z debugera itp. w systemie Windows.
- Wyłącz zdalny symulator, tak jak powyżej, aby symulator był uruchamiany na komputerze Mac. Następnie użyj aplikacji pulpitu zdalnego, aby nawiązać połączenie z pulpitem Mac z systemu Windows. Opcje pulpitu zdalnego obejmują Devolutions Remote Desktop Manager (szybkie i dostępne są bezpłatne wersje) oraz klientów VNC (wolniej i bezpłatnie).
- Użyj urządzenia fizycznego do przetestowania zamiast symulatora. Aby ukończyć samouczek uwierzytelniania, możesz uzyskać bezpłatny profil aprowizacji.
Następne kroki
Kontynuuj samouczek, dodając uwierzytelnianie do aplikacji.