Vytvoření aplikace Xamarin.iOS pomocí Azure Mobile Apps

Článek
01/12/2024

Poznámka

Tento produkt je vyřazený. Náhradu za projekty používající .NET 8 nebo novější najdete v knihovně Community Toolkit Datasync.

V tomto kurzu se dozvíte, jak přidat cloudovou back-endovou službu do mobilní aplikace pro iOS pomocí Xamarin.iOS a back-endu mobilních aplikací Azure. Vytvoříte back-end nové mobilní aplikace i jednoduchý seznam úkolů aplikaci, která ukládá data aplikací v Azure.

Tento kurz musíte dokončit před dalšími kurzy Xamarin.iOS pomocí funkce Mobile Apps ve službě Azure App Service.

Požadavky

K dokončení tohoto kurzu potřebujete:

sady Visual Studio 2022 s následujícími úlohami.
- vývoj pro ASP.NET a web
- Vývoj pro Azure
- Vývoj mobilních aplikací s využitím .NET
Účet Azure .
Azure CLI.
- Přihlaste se pomocí az login a před zahájením vyberte příslušné předplatné.
(Volitelné) Rozhraní příkazového řádku azure pro vývojáře .
Dostupný Mac:
- Instalace XCode
- Po instalaci otevřete Xcode, aby mohl přidat další požadované součásti.
- Po otevření vyberte Předvolby XCode...>Součástia nainstalujte simulátor iOS.
- Postupujte podle pokynů k Spárování s mac.

K kompilaci verze iOS se vyžaduje mac.

Stažení ukázkové aplikace

Otevřete úložiště azure-mobile-apps v prohlížeči.
Otevřete rozevírací seznam Code a pak vyberte StáhnoutZIP .
Po dokončení stahování otevřete složku Stažené soubory a vyhledejte soubor azure-mobile-apps-main.zip.
Klikněte pravým tlačítkem na stažený soubor a vyberte Extrahovat vše....

Pokud chcete, můžete pomocí PowerShellu rozbalit archiv:
```
C:\Temp> Expand-Archive azure-mobile-apps-main.zip
```

Ukázky se nacházejí v ukázkách složce v extrahovaných souborech. Ukázka rychlého startu má název TodoApp. Ukázku můžete otevřít v sadě Visual Studio poklikáním na soubor TodoApp.sln.

Snímek obrazovky s průzkumníkem souborů pro řešení

Nasazení back-endu do Azure

Poznámka

Pokud jste už back-end nasadili z jiného rychlého startu, můžete použít stejný back-end a tento krok přeskočit.

Abychom mohli nasadit back-endovou službu, provedeme následující kroky:

Zřízení služby Azure App Service a Azure SQL Database do Azure
Pomocí sady Visual Studio nasaďte kód služby do nově vytvořené služby Azure App Service.

Provedení všech kroků pomocí Azure Developer CLI

Ukázka TodoAppu je nakonfigurovaná tak, aby podporovala Azure Developer CLI. Dokončení všech kroků (zřizování a nasazení):

nainstalujteAzure Developer CLI.
Otevřete terminál a změňte adresář na složku obsahující soubor TodoApp.sln. Tento adresář obsahuje také azure.yaml.
Spusťte azd up.

Pokud ještě nejste přihlášení k Azure, prohlížeč se spustí a požádá vás o přihlášení. Pak se zobrazí výzva k zadání předplatného a oblasti Azure, která se má použít. Azure Developer CLI pak zřídí potřebné prostředky a nasadí kód služby do oblasti Azure a předplatného podle vašeho výběru. Nakonec azure Developer CLI zapíše příslušný soubor Constants.cs za vás.

Spuštěním příkazu azd env get-values zobrazíte ověřovací informace SQL, pokud chcete získat přímý přístup k databázi.

Pokud jste dokončili kroky pomocí Azure Developer CLI, přejděte k dalšímu kroku. Pokud nechcete používat Azure Developer CLI, pokračujte ručními kroky.

Vytvořte prostředky v Azure.

Otevřete terminál a změňte adresář na složku obsahující soubor TodoApp.sln. Tento adresář obsahuje také azuredeploy.json.
Ujistěte se, že jste přihlášení a vybrali předplatné pomocí Azure CLI.
Vytvořte novou skupinu prostředků:
```
az group create -l westus -g quickstart
```
Tento příkaz vytvoří skupinu prostředků quickstart v oblasti USA – západ. Můžete vybrat libovolnou oblast, kterou si přejete, a vytvořit tam prostředky. Ujistěte se, že používáte stejný název a oblast všude, kde jsou uvedené v tomto kurzu.
Vytvořte prostředky pomocí nasazení skupiny:
```
az deployment group create -g quickstart --template-file azuredeploy.json --parameters sqlPassword=MyPassword1234
```
Vyberte silné heslo pro heslo správce SQL. Později ho budete potřebovat při přístupu k databázi.
Po dokončení nasazení získejte výstupní proměnné, protože tyto důležité informace budete potřebovat později:
```
az deployment group show -g quickstart -n azuredeploy --query properties.outputs
```
Příkladem výstupu je:
Poznamenejte si jednotlivé hodnoty ve výstupech pro pozdější použití.

Publikování kódu služby

Otevřete TodoApp.sln v sadě Visual Studio.

V pravém podokně vybertePrůzkumníka řešení .
Klikněte pravým tlačítkem myši na projekt TodoAppService.NET6 a vyberte Nastavit jako spouštěný projekt.
V horní nabídce vyberte Build>Publish TodoAppService.NET6.
V okně Publikovat vyberte Cíl: Azurea stiskněte Další.
Vyberte konkrétní cíl: azure App Service (Windows)a stiskněte Další.
V případě potřeby se přihlaste a vyberte odpovídající název předplatného .
Ujistěte se, že zobrazení je nastavená naskupiny prostředků .
Rozbalte quickstart skupinu prostředků a pak vyberte službu App Service, která byla vytvořena dříve.
Vyberte Dokončit.
Po dokončení procesu vytváření profilu publikování vyberte Zavřít.
Vyhledejte závislosti služby a vyberte trojité tečky vedle databáze SQL Serveru a pak vyberte Připojit.
Vyberte azure SQL Databasea pak vyberte Další.
Vyberte databázi rychlého startu a pak vyberte Další.
Vyplňte formulář pomocí uživatelského jména a hesla SQL, které byly ve výstupech nasazení, a pak vyberte Další.
Vyberte Dokončit.
Po dokončení vyberte Zavřít.
Vyberte Publikovat a publikujte aplikaci do služby Azure App Service, kterou jste vytvořili dříve.
Po publikování back-endové služby se otevře prohlížeč. Přidejte /tables/todoitem?ZUMO-API-VERSION=3.0.0 na adresu URL:

Konfigurace ukázkové aplikace

Vaše klientská aplikace potřebuje znát základní adresu URL back-endu, aby s ní mohl komunikovat.

Pokud jste ke zřízení a nasazení služby použili azd up, vytvořil se vám soubor Constants.cs a můžete tento krok přeskočit.

Rozbalte projekt TodoApp.Data.
Klikněte pravým tlačítkem na projekt TodoApp.Data a vyberte Přidat>třídu....
Jako název zadejte Constants.cs a pak vyberte Přidat.
Otevřete soubor Constants.cs.example a zkopírujte obsah (Ctrl-A následovaný Ctrl-C).
Přepněte na Constants.cs, zvýrazněte veškerý text (Ctrl-A), vložte obsah z ukázkového souboru (Ctrl-V).

Nahraďte https://APPSERVICENAME.azurewebsites.net back-endovou adresou URL vaší služby.

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";
    }
}

Adresu URL back-endu služby získáte na kartě Publikovat. Ujistěte se, že používáte adresu URL https.

Uložte soubor. (Ctrl-S).

Sestavení a spuštění aplikace

V Průzkumníku řešení rozbalte složku xamarin-native.
Klikněte pravým tlačítkem na projekt TodoApp.iOS a vyberte Nastavit jako spouštěný projekt.
V horním panelu vyberte simulátor iPhone konfiguraci a cíl TodoApp.iOS:
Vyberte odpovídající simulátor iPhonu (zvolil(a) jsem iPhone SE se systémem iOS 15.5).
Stisknutím klávesy F5 sestavte a spusťte projekt.

Po spuštění aplikace se zobrazí prázdný seznam a textové pole pro přidání položek v emulátoru. Můžeš:

Položku přidáte stisknutím tlačítka +.
Vyberte položku, která nastaví nebo vymaže dokončený příznak.
Stisknutím ikony aktualizace znovu načtěte data ze služby.

snímek obrazovky se spuštěnou aplikací pro i O S zobrazující seznam úkolů

Řešení problémů

Vzdálený simulátor, který se dodává se sadou Visual Studio 2022, není kompatibilní s XCode 13.3. Zobrazí se následující chybová zpráva:

snímek obrazovky s chybovou zprávou při spuštění simulátoru i O S.

Tento problém můžete vyřešit takto:

Zakažte vzdálený simulátor (Nástroje / Možnosti / Nastavení iOS / zrušte zaškrtnutí Vzdálený simulátor do systému Windows). Pokud není tato možnost zaškrtnutá, simulátor se spustí na Macu místo ve Windows. Pak můžete pracovat se simulátorem přímo na počítači Mac při používání ladicího programu atd. ve Windows.
Zakažte vzdálený simulátor tak, jak je uvedeno výše, aby simulátor běžel na Macu. Pak se pomocí aplikace pro vzdálenou plochu připojte k počítači Mac z Windows. Mezi možnosti vzdálené plochy patří Devolutions Remote Desktop Manager (rychlá a k dispozici je bezplatná verze) a klienti VNC (pomalejší a zdarma).
K otestování místo simulátoru použijte fyzické zařízení. K dokončení kurzu ověřování můžete získat bezplatný zřizovací profil.

Další kroky

Pokračujte kurzem přidáním ověřování doaplikace .

Sdílet prostřednictvím