Vytvoření aplikace Xamarin.Android pomocí Azure Mobile Apps
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-end službu do mobilní aplikace pro Android pomocí Xamarinu a back-endu mobilní aplikace 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 pro Xamarin Android o používání funkce Mobile Apps ve službě Azure App Service.
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é.
- Přihlaste se pomocí
- (Volitelné) Rozhraní příkazového řádku azure pro vývojáře .
-
virtuálního zařízení s Androidem s následujícími nastaveními:
- Telefon: Jakýkoli obrázek telefonu – pro testování používáme pixel 5.
- Obrázek systému: Android 11 (API 30 s rozhraními GOOGLE API)
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
.
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.
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.
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í.
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:
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 souborConstants.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 URLhttps. Uložte soubor. (Ctrl-S).
V Průzkumníku řešení rozbalte složku
xamarin-native
.Klikněte pravým tlačítkem na projekt
TodoApp.Android
a vyberte Nastavit jako spouštěný projekt.Na horním panelu vyberte Konfiguraci libovolného procesoru a cíl TodoApp.Android:
Pokud se místo toho zobrazí Android Emulator, nevytvořili jste emulátor Androidu. Další informace naleznete v tématu Nastavení emulátoru Android. Vytvoření nového emulátoru Androidu:
- Vyberte Tools>Android>Android Device Manager.
- Vyberte + Nový.
- Na levé straně vyberte následující nastavení:
- Název:
quickstart
- Základní zařízení: pixel 5
- Procesor: x86_64
- Operační systém: Android 11.0 – ROZHRANÍ API 30
- Rozhraní API Google: zaškrtnuté
- Název:
- Vyberte Vytvořit.
- V případě potřeby přijměte licenční smlouvu. Obrázek se pak stáhne.
- Jakmile se zobrazí tlačítko Start, stiskněte Start .
- Pokud se zobrazí výzva k Hyper-V hardwarovou akceleraci, přečtěte si dokumentaci, abyste povolili hardwarovou akceleraci, než budete pokračovat.
Po dokončení zavřete Správce zařízení s Androidem.
Tip
Než budete pokračovat, spusťte emulátor Androidu. Můžete to udělat tak, že otevřete Správce zařízení s Androidem a stisknete Start vedle zvoleného emulátoru.
Stisknutím klávesy F5 sestavte a spusťte projekt.
Po spuštění aplikace se zobrazí prázdný seznam a plovoucí tlačítko akce pro přidání položek v emulátoru. Můžeš:
- Stiskněte plovoucí tlačítko akce a pak zadejte nějaký text pro přidání položky.
- Zaškrtnutím nebo zrušením zaškrtnutí políčka označíte libovolnou položku jako hotovou.
- Stisknutím ikony aktualizace znovu načtěte data ze služby.
Pokračujte kurzem přidáním ověřování doaplikace .