Freigeben über

Erstellen einer Windows-App mit einem Azure-Back-End

  • Artikel

Übersicht

In diesem Tutorial erfahren Sie, wie Sie einer App für die universelle Windows-Plattform (UWP) einen cloudbasierten Back-End-Dienst hinzufügen. Weitere Informationen finden Sie unter Was sind Mobile Apps? Im Folgenden sehen Sie Screenshots aus der fertigen App:

Fertige Desktop-App

Die Absolvierung dieses Tutorials wird für alle anderen Mobile App-Tutorials für UWP-Apps vorausgesetzt.

Voraussetzungen

Für dieses Tutorial benötigen Sie Folgendes:

  • Ein aktives Azure-Konto. Falls Sie kein Konto besitzen, können Sie sich für eine Azure-Testversion registrieren. So erhalten Sie bis zu 10 kostenlose mobile Apps, die Sie auch nach Ablauf der Testversion weiter nutzen können. Ausführliche Informationen finden Sie unter Einen Monat kostenlos testen.
  • Windows 10
  • Visual Studio Community 2017.
  • Kenntnisse in der Entwicklung von UWP-Apps. In der UWP-Dokumentation finden Sie Informationen zu den ersten Schritten beim Erstellen von UWP-Apps.

Erstellen eines neuen Azure Mobile App-Back-Ends

Führen Sie die folgenden Schritte aus, um ein neues mobiles App-Back-End zu erstellen.

  1. Melden Sie sich beim Azure-Portal an.

  2. Klicken Sie auf Ressource erstellen.

  3. Geben Sie in das Suchfeld Web-Appein.

  4. Klicken Sie in der Ergebnisliste über den Marketplace auf Web-App.

  5. Wählen Sie Ihr Abonnement und Ihre Ressourcengruppe aus. Dabei können Sie entweder eine bereits vorhandene Ressourcengruppe auswählen oder eine neue erstellen und dabei den gleichen Namen wie für die App verwenden.

  6. Geben Sie einen eindeutigen Namen für Ihre Web-App ein.

  7. Wählen Sie als Standardoption zum VeröffentlichenCode aus.

  8. Im Laufzeitstapel müssen Sie unter ASP.NET oder Node eine Version auswählen. Wenn Sie an einem .NET-Backend arbeiten, wählen Sie eine ASP.NET-Version aus. Wenn Sie aber an einer Node-basierten Anwendung arbeiten, wählen Sie eine Node-Version aus.

  9. Wählen Sie ein Betriebssystem aus (entweder Linux oder Windows).

  10. Wählen Sie die Region aus, für die diese App bereitgestellt werden soll.

  11. Wählen Sie einen passenden App Service-Plan aus, und klicken Sie auf Überprüfen und erstellen.

  12. Wählen Sie unter Ressourcengruppe eine vorhandene Ressourcengruppe aus, oder erstellen Sie eine neue. (Verwenden Sie dabei den gleichen Namen wie für die App.)

  13. Klicken Sie auf Erstellen. Warten Sie ein paar Minuten, bis der Dienst bereitgestellt wurde, bevor Sie fortfahren. Das Benachrichtigungssymbol (Glocke) in der Portalüberschrift informiert Sie über Statusupdates.

  14. Sobald die Bereitstellung abgeschlossen ist, klicken Sie erst auf den Abschnitt Bereitstellungsdetails und dann auf die Ressource vom Typ Microsoft.Web/sites. Dann werden Sie zu der App Service-Web-App geleitet, die Sie gerade erstellt haben.

  15. Klicken Sie unter Einstellungen auf das Blatt Konfiguration und unter Anwendungseinstellungen auf die Schaltfläche Neue Anwendungseinstellung.

  16. Geben Sie auf der Seite Anwendungseinstellung hinzufügen/bearbeiten den NamenMobileAppsManagement_EXTENSION_VERSION und den Wert Latest (Aktuell) ein. Drücken Sie anschließend auf „OK“.

Nun können Sie diese neu erstellte App Service-Web-App als mobile App verwenden.

Erstellen einer Datenbankverbindung und Konfigurieren des Client- und Serverprojekts

  1. Laden Sie die Client-SDK-Schnellstarts für die folgenden Plattformen herunter:

    iOS (Objective-C)
    iOS (Swift)
    Android (Java)
    Xamarin.iOS
    Xamarin.Android
    Xamarin.Forms
    Cordova
    Windows (C#)

    Hinweis

    Wenn Sie das iOS-Projekt verwenden, müssen Sie "azuresdk-iOS-*.zip" aus der neuesten GitHub-Version herunterladen. Entzippen Sie die Datei, und fügen Sie die Datei MicrosoftAzureMobile.framework dem Stamm des Projekts hinzu.

  2. Sie müssen eine Datenbankverbindung hinzufügen oder eine Verbindung mit einer vorhandenen Verbindung herstellen. Legen Sie zunächst fest, ob Sie einen Datenspeicher erstellen oder einen bereits vorhandenen verwenden möchten.

    • Erstellen Sie einen neuen Datenspeicher: Wenn Sie einen Datenspeicher erstellen möchten, verwenden Sie den folgenden Schnellstart:

      Schnellstart: Erste Schritte mit einzelnen Datenbanken in Azure SQL Datenbank

    • Vorhandene Datenquelle: Folgen Sie den folgenden Anweisungen, wenn Sie eine vorhandene Datenbankverbindung verwenden möchten

      1. Format der SQL-Datenbank-Verbindungszeichenfolge: Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}

        {your_SQLServer}: Name des Servers. Diesen finden Sie auf der Übersichtsseite für Ihre Datenbank, in der Regel im Format „server_name.database.windows.net“. {port}: Normalerweise 1433. {your_catalogue}: Name der Datenbank. {your_username}: Benutzername für den Zugriff auf Ihre Datenbank. {your_password}: Kennwort für den Zugriff auf Ihre Datenbank.

        Weitere Informationen zum Format der SQL-Verbindungszeichenfolge

      2. Fügen Sie die Verbindungszeichenfolge Ihrer mobilen App hinzu. In App Service können Sie Verbindungszeichenfolgen für Ihre Anwendung über die Option Konfiguration im Menü verwalten.

        So fügen Sie eine Verbindungszeichenfolge hinzu:

        1. Klicken Sie auf die Registerkarte Anwendungseinstellungen.

        2. Klicken Sie auf [+] Neue Verbindungszeichenfolge.

        3. Sie müssen den Namen, Wert und Typ Ihrer Verbindungszeichenfolge angeben.

        4. Geben Sie als NameMS_TableConnectionString ein.

        5. Der Wert muss der Verbindungszeichenfolge entsprechen, die Sie im vorherigen Schritt zusammengestellt haben.

        6. Wenn Sie eine Verbindungszeichenfolge einer SQL Azure-Datenbank hinzufügen, wählen Sie unter Typ die Option SQLAzure.

  3. Azure Mobile Apps umfasst SDKs für .NET- und Node.js-Back-Ends.

    • Node.js-Back-End

      Wenn Sie die Node.js-Schnellstart-App verwenden möchten, befolgen Sie die nachstehenden Anweisungen.

      1. Wechseln Sie im Azure-Portal zu Einfache Tabellen. Der folgende Bildschirm wird angezeigt.

        Node: Einfache Tabellen

      2. Stellen Sie sicher, dass die SQL-Verbindungszeichenfolge bereits auf der Registerkarte "Konfiguration " hinzugefügt wird. Aktivieren Sie dann das Kontrollkästchen, dass dies alle Websiteinhalte überschreibt und auf die Schaltfläche "TodoItem-Tabelle erstellen " klicken.

        Node: Konfiguration einfacher Tabellen

      3. Klicken Sie in Einfache Tabellen auf die Schaltfläche + Hinzufügen.

        Node: Schaltfläche „Hinzufügen“ für einfache Tabellen

      4. Erstellen Sie eine TodoItem-Tabelle mit anonymem Zugriff.

        Node: Einfache Tabelle hinzufügen

    • .NET-Back-End

      Wenn Sie die .NET-Schnellstart-App verwenden möchten, befolgen Sie die nachstehenden Anweisungen.

      1. Laden Sie das .NET-Serverprojekt für Azure Mobile Apps aus dem Repository azure-mobile-apps-quickstarts herunter.

      2. Erstellen Sie das .NET-Serverprojekt lokal in Visual Studio.

      3. Öffnen Sie in Visual Studio den Projektmappen-Explorer, klicken Sie mit der rechten Maustaste auf das Projekt ZUMOAPPNAMEService, und klicken Sie auf Veröffentlichen. Das Fenster Publish to App Service wird angezeigt. Wenn Sie an einem Mac arbeiten, finden Sie hier andere Möglichkeiten zum Bereitstellen der App.

        Visual Studio-Veröffentlichung

      4. Wählen Sie App Service als Ziel für die Veröffentlichung aus, klicken Sie auf Vorhandene auswählen, und klicken Sie dann im unteren Fensterbereich auf Veröffentlichen.

      5. Sie müssen sich zuerst mit Ihrem Azure-Abonnement bei Visual Studio anmelden. Wählen Sie Subscription, Resource Group und dann den Namen Ihrer App aus. Klicken Sie schließlich auf OK. Dadurch wird das lokale .NET-Serverprojekt im App Service-Back-End bereitgestellt. Nach Abschluss der Bereitstellung werden Sie im Browser an http://{zumoappname}.azurewebsites.net/ umgeleitet.

Ausführen des Clientprojekts

  1. Öffnen Sie das UWP-Projekt.

  2. Wechseln Sie zum Azure-Portal, und navigieren Sie zu der mobilen App, die Sie erstellt haben. Suchen Sie auf dem Blatt Overview nach der URL, die den öffentlichen Endpunkt für Ihre mobile App darstellt. Beispiel: Der Websitename für meinen App-Namen „test123“ lautet https://test123.azurewebsites.net.

  3. Öffnen Sie die Datei App.xaml.cs in diesem Ordner: „windows-uwp-cs/ZUMOAPPNAME/“. Der Anwendungsname lautet ZUMOAPPNAME.

  4. Ersetzen Sie in der App-Klasse den Parameter ZUMOAPPURL durch den oben stehenden öffentlichen Endpunkt.

    public static MobileServiceClient MobileService = new MobileServiceClient("ZUMOAPPURL");

    wird zu

    public static MobileServiceClient MobileService = new MobileServiceClient("https://test123.azurewebsites.net");

  5. Drücken Sie die Taste F5, um die App bereitzustellen und auszuführen.

  6. Geben Sie in der App unter TodoItem einfügen einen beschreibenden Text ein, zum Beispiel Abschließen des Tutorials. Klicken Sie dann auf Speichern.

    Windows-Schnellstart – Vollständig für Desktop

    Dadurch wird eine POST-Anforderung an das neue in Azure gehostete mobile App-Back-End gesendet.