Dela via

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

  • Artikel

Not

Den här produkten har dragits tillbaka. En ersättning för projekt som använder .NET 8 eller senare finns i Community Toolkit Datasync-biblioteket.

Den här självstudien visar hur du lägger till en molnbaserad serverdelstjänst i en Windows App SDK-skrivbordsapp (WinUI3) med hjälp av Azure Mobile Apps och en Azure-mobilappsserverdel. Du skapar både en ny mobilappsserverdel och en enkel Att göra-lista app som lagrar appdata i Azure.

Du måste slutföra den här självstudien innan alla andra Självstudier för Windows (WinUI3) om hur du använder mobile apps-funktionen i Azure App Service.

Förutsättningar

För att slutföra den här självstudien behöver du:

  • Visual Studio 2022 med följande arbetsbelastningar.
    • ASP.NET och webbutveckling
    • Azure-utveckling
    • .NET-skrivbordsutveckling
    • Utveckling av Universell Windows-plattform
    • I fönstret Installationsinformation i installationsdialogrutan väljer du Windows App SDK C#-mallar (längst ned i listan).
    • På fliken Enskilda komponenter i installationsdialogrutan i avsnittet SDK:er, bibliotek och ramverk kontrollerar du att Windows 10 SDK är markerat. Välj en version som är lika med eller senare än 10.0.19041.0.
  • 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.

Mer information om de verktyg som krävs för utveckling av Windows App SDK finns i Installera verktyg för Windows App SDK.

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

Ladda ned exempelappen

  1. Öppna lagringsplatsen azure-mobile-apps i webbläsaren.

  2. Öppna listrutan Code och välj sedan Ladda ned ZIP-.

    Skärmbild av menyn Kod på GitHub.

  3. När nedladdningen är klar öppnar du mappen Downloads och letar reda på filen azure-mobile-apps-main.zip.

  4. 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 exempel mapp i de extraherade filerna. Exemplet för snabbstarten heter TodoApp. Du kan öppna exemplet i Visual Studio genom att dubbelklicka på filen TodoApp.sln.

Skärmbild av utforskaren för lösningen.

Distribuera serverdelen till Azure

Not

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):

  1. Installera Azure Developer CLI-.
  2. Öppna en terminal och ändra katalogen till mappen som innehåller TodoApp.sln-filen. Den här katalogen innehåller även azure.yaml.
  3. 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 kommandot azd env get-values för att se SQL-autentiseringsinformationen om du vill komma åt databasen direkt.

Om du har slutfört stegen med Azure Developer CLI gå 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.

  1. Öppna en terminal och ändra katalogen till mappen som innehåller TodoApp.sln-filen. Den här katalogen innehåller även azuredeploy.json.

  2. Kontrollera att du har loggat in och valt en prenumeration med hjälp av Azure CLI.

  3. Skapa en ny resursgrupp:

    az group create -l westus -g quickstart

    Det här kommandot skapar resursgruppen quickstart 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.

  4. 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.

  5. 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:

    Skärmbild av kommandoradsresultat.

  6. Anteckna vart och ett av värdena i utdata för senare användning.

Publicera tjänstkoden

Öppna TodoApp.sln i Visual Studio.

  1. I den högra rutan väljer du Solutions Explorer.

  2. Högerklicka på projektet TodoAppService.NET6 och välj sedan Ange som startprojekt.

  3. På den översta menyn väljer du Build>Publish TodoAppService.NET6.

  4. I fönstret Publicera väljer du Mål: Azureoch trycker sedan på Nästa.

    Skärmbild av målmarkeringsfönstret.

  5. Välj Specifikt mål: Azure App Service (Windows)och tryck sedan på Nästa.

    Skärmbild av det specifika målmarkeringsfönstret.

  6. Om det behövs loggar du in och väljer ett lämpligt Prenumerationsnamn.

  7. Kontrollera att View är inställt på Resursgrupp.

  8. Expandera resursgruppen quickstart och välj sedan den App Service som skapades tidigare.

    Skärmbild av fönstret för val av apptjänst.

  9. Välj Slutför.

  10. När publiceringsprofilen har skapats väljer du Stäng.

  11. Leta upp tjänstberoenden och välj trippelpunkterna bredvid SQL Server Database och välj sedan Anslut.

    Skärmbild som visar konfigurationsvalet för S Q L-server.

  12. Välj Azure SQL Databaseoch välj sedan Nästa.

  13. Välj snabbstart databas och välj sedan Nästa.

    Skärmbild av databasvalsfönstret.

  14. Fyll i formuläret med det SQL-användarnamn och lösenord som fanns i distributionens utdata och välj sedan Nästa.

    Skärmbild av fönstret databasinställningar.

  15. Välj Slutför.

  16. Välj Stäng när du är klar.

  17. Välj Publicera för att publicera din app till Azure App Service som du skapade tidigare.

    Skärmbild som visar publiceringsknappen.

  18. När serverdelstjänsten har publicerats öppnas en webbläsare. Lägg till /tables/todoitem?ZUMO-API-VERSION=3.0.0 i URL:en:

    Skärmbild som visar webbläsarens utdata när tjänsten har publicerats.

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 skapades den Constants.cs filen åt dig och du kan hoppa över det här steget.

  1. Expandera projektet TodoApp.Data.

  2. Högerklicka på projektet TodoApp.Data och välj sedan Lägg till>klass....

  3. Ange Constants.cs som namn och välj sedan Lägg till.

    Skärmbild av att lägga till filen Constants.cs i projektet.

  4. Öppna filen Constants.cs.example och kopiera innehållet (Ctrl-A, följt av Ctrl-C).

  5. Växla till Constants.cs, markera all text (Ctrl-A) och klistra sedan in innehållet från exempelfilen (Ctrl-V).

  6. Ersätt https://APPSERVICENAME.azurewebsites.net med tjänstens serverdels-URL.

    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. Se till att du använder en https URL.

  7. Spara filen. (Ctrl-S).

Skapa och kör exempelappen

  1. Expandera mappen windows i lösningsutforskaren.

  2. Högerklicka på projektet TodoApp.WinUI och välj Ange som startprojekt.

  3. Se till att det övre fältet visar TodoApp.WinUI (paket) som felsökningsmål:

    Skärmbild av Visual Studio-konfigurationsfältet.

  4. 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å Retur eller 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.

    Skärmbild av Windows-appen som körs i Windows.

Nästa steg

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