Skapa en Windows-app (UWP) med Azure Mobile Apps

Artikel
10/23/2023

Den här självstudien visar hur du lägger till en molnbaserad serverdelstjänst i en skrivbordsapp för Universell Windows-plattform (UWP) med hjälp av Azure Mobile Apps och en Azure-mobilappsserverdel. Du skapar både en ny mobilappsserverdel och en enkel Todo-listapp som lagrar appdata i Azure.

Den här självstudien krävs för alla andra Självstudier om Windows (UWP) om hur du använder mobile apps-funktionen i Azure App Service.

Förutsättningar

För att slutföra självstudierna behöver du:

Visual Studio 2022 med följande arbetsbelastningar.
- ASP.NET- och webbutveckling
- Azure development (Azure-utveckling)
- Universell Windows-plattformutveckling
Ett Azure-konto.
Azure CLI.
- Logga in med az login och välj en lämplig prenumeration innan du börjar.
(Valfritt) Azure Developer CLI.

Den här självstudien kan bara slutföras i ett Windows-system.

Ladda ned exempelprogrammet

Öppna lagringsplatsen azure-mobile-apps i webbläsaren.
Öppna listrutan Kod och välj sedan Ladda ned ZIP.
När nedladdningen är klar öppnar du mappen Nedladdningar och letar upp azure-mobile-apps-main.zip filen.
Högerklicka på den nedladdade filen och välj Extrahera alla....

Om du vill kan du använda PowerShell för att expandera arkivet:
```
C:\Temp> Expand-Archive azure-mobile-apps-main.zip
```

Exemplen finns i exempelmappen i de extraherade filerna. Exemplet för snabbstarten heter TodoApp. Du kan öppna exemplet i Visual Studio genom att TodoApp.sln dubbelklicka på filen.

Screenshot of the file explorer for the solution.

Distribuera serverdelen till Azure

Kommentar

Om du redan har distribuerat serverdelen från en annan snabbstart kan du använda samma serverdel och hoppa över det här steget.

För att distribuera serverdelstjänsten gör vi följande:

Etablera en Azure App Service och Azure SQL Database till Azure.
Använd Visual Studio för att distribuera tjänstkoden till den nyligen skapade Azure App Service.

Använd Azure Developer CLI för att slutföra alla steg

TodoApp-exemplet har konfigurerats för att stödja Azure Developer CLI. Så här slutför du alla steg (etablering och distribution):

Installera Azure Developer CLI.
Öppna en terminal och ändra katalogen till mappen som innehåller TodoApp.sln filen. Den här katalogen innehåller azure.yamlockså .
Kör azd up.

Om du inte redan är inloggad i Azure startas webbläsaren för att be dig logga in. Du uppmanas sedan att använda en prenumeration och En Azure-region. Azure Developer CLI etablerar sedan nödvändiga resurser och distribuerar tjänstkoden till den Azure-region och prenumeration som du väljer. Slutligen skriver Azure Developer CLI en lämplig Constants.cs fil åt dig.

Du kan köra azd env get-values kommandot för att se SQL-autentiseringsinformationen om du vill komma åt databasen direkt.

Om du har slutfört stegen med Azure Developer CLI går du vidare till nästa steg. Om du inte vill använda Azure Developer CLI fortsätter du med de manuella stegen.

Skapa resurser i Azure.

Öppna en terminal och ändra katalogen till mappen som innehåller TodoApp.sln filen. Den här katalogen innehåller azuredeploy.jsonockså .
Kontrollera att du har loggat in och valt en prenumeration med hjälp av Azure CLI.
Skapa en ny resursgrupp:
```
az group create -l westus -g quickstart
```
Det här kommandot skapar quickstart resursgruppen i regionen USA, västra. Du kan välja vilken region du vill, förutsatt att du kan skapa resurser där. Se till att du använder samma namn och region oavsett var de nämns i den här självstudien.
Skapa resurserna med hjälp av en gruppdistribution:
```
az deployment group create -g quickstart --template-file azuredeploy.json --parameters sqlPassword=MyPassword1234
```
Välj ett starkt lösenord för ditt SQL-administratörslösenord. Du behöver det senare när du kommer åt databasen.
När distributionen är klar hämtar du utdatavariablerna eftersom dessa innehåller viktig information som du behöver senare:
```
az deployment group show -g quickstart -n azuredeploy --query properties.outputs
```
Ett exempel på utdata är:
Anteckna vart och ett av värdena i utdata för senare användning.

Publicera tjänstkoden

TodoApp.sln Öppna i Visual Studio.

I den högra rutan väljer du Lösningsutforskaren.
Högerklicka på TodoAppService.NET6 projektet och välj sedan Ange som startprojekt.
På den översta menyn väljer du Skapa>Publicera TodoAppService.NET6.
I fönstret Publicera väljer du Mål: Azure och trycker sedan på Nästa.
Välj Specifikt mål: Azure App Service (Windows) och tryck sedan på Nästa.
Om det behövs loggar du in och väljer ett lämpligt prenumerationsnamn.
Kontrollera att vyn är inställd på Resursgrupp.
quickstart Expandera resursgruppen och välj sedan den App Service som skapades tidigare.
Välj Slutför.
När publiceringsprofilen har skapats väljer du Stäng.
Leta upp tjänstberoenden och välj tre punkter bredvid SQL Server Database och välj sedan Anslut.
Välj Azure SQL Database och välj sedan Nästa.
Välj snabbstartsdatabasen och välj sedan Nästa.
Fyll i formuläret med det SQL-användarnamn och lösenord som fanns i distributionens utdata och välj sedan Nästa.
Välj Slutför.
Välj Stäng när det är klart.
Välj Publicera för att publicera din app till Azure App Service som du skapade tidigare.
När serverdelstjänsten har publicerats öppnas en webbläsare. Lägg till /tables/todoitem?ZUMO-API-VERSION=3.0.0 i URL:en:

Konfigurera exempelappen

Klientprogrammet måste känna till bas-URL:en för serverdelen så att den kan kommunicera med den.

Om du använde azd up för att etablera och distribuera tjänsten Constants.cs skapades filen åt dig och du kan hoppa över det här steget.

TodoApp.Data Expandera projektet.
Högerklicka på TodoApp.Data projektet och välj sedan Lägg till>klass....
Ange Constants.cs som namn och välj sedan Lägg till.
Constants.cs.example Öppna filen och kopiera innehållet (Ctrl-A, följt av Ctrl-C).
Växla till Constants.cs, markera all text (Ctrl-A) och klistra sedan in innehållet från exempelfilen (Ctrl-V).

https://APPSERVICENAME.azurewebsites.net Ersätt med serverdels-URL:en för din tjänst.

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

Du kan hämta tjänstens serverdels-URL från fliken Publicera . Kontrollera att du använder en https-URL .

Spara filen. (Ctrl-S).

Skapa och kör exempelappen

Expandera mappen i lösningsutforskaren windows .
Högerklicka på TodoApp.UWP projektet och välj Ange som startprojekt.
I det övre fältet väljer du Valfri CPU-konfiguration och TodoApp.UWP-målet :
Tryck på F5 för att skapa och köra projektet.

När appen har startat visas en tom lista med en textruta. Du kan:

Ange text och tryck sedan på + ikonen för att lägga till objektet.
Ange eller avmarkera kryssrutan för att markera ett objekt som gjort.
Tryck på uppdateringsikonen för att läsa in data från tjänsten igen.

Nästa steg

Fortsätt självstudien genom att lägga till autentisering i appen.