Een Apache Cordova-app maken

  • Artikel

Overzicht

Deze zelfstudie laat zien hoe u een cloudgebaseerde back-endservice toevoegt aan een mobiele Apache Cordova-app met een back-end voor mobiele apps van Azure. U maakt zowel een nieuwe back-end voor een mobiele app als een eenvoudige Apache Cordova-app voor takenlijsten die app-gegevens opslaat in Azure.

Het volgen van deze zelfstudie is een vereiste voor alle andere Apache Cordova-zelfstudies over het gebruik van de functie Mobile Apps in Azure App Service.

Vereisten

Voor het voltooien van deze zelfstudie moet aan de volgende vereisten worden voldaan:

U kunt Visual Studio ook omzeilen en de Apache Cordova-opdrachtregel rechtstreeks gebruiken. Het gebruiken van de opdrachtregel is handig bij het voltooien van de zelfstudie op een Mac-computer. Het compileren van Apache Cordova-clienttoepassingen via de opdrachtregel wordt niet behandeld in deze zelfstudie.

Een back-end voor mobiele apps van Azure maken

  1. Meld u aan bij de Azure-portal.

  2. Klik op Een resource maken.

  3. Typ web-app in het zoekvak.

  4. Selecteer web-app in de lijst met resultaten in Marketplace.

  5. Selecteer uw abonnement en resourcegroep (selecteer een bestaande resourcegroep of maak een nieuwe resourcegroep (met dezelfde naam als uw app)).

  6. Kies een unieke naam van uw web-app.

  7. Kies de standaardoptie Publiceren als Code.

  8. In de Runtime-stack moet u een versie selecteren onder ASP.NET of Node. Als u een .NET-back-end bouwt, selecteert u een versie onder ASP.NET. Als u zich ook richt op een op Node gebaseerde toepassing, selecteert u een van de versies van Node.

  9. Selecteer het juiste besturingssysteem, Linux of Windows.

  10. Selecteer de regio waar u deze app wilt implementeren.

  11. Selecteer de juiste App Service Plan en klik op Beoordelen en maken.

  12. Selecteer onder Resourcegroep een bestaande resourcegroep of maak een nieuwe resourcegroep (met dezelfde naam als uw app).

  13. Klik op Create. Wacht enkele minuten tot de service is geïmplementeerd voordat u doorgaat. Houd het meldingspictogram (bel) in de koptekst van de portal in de gaten voor statusupdates.

  14. Zodra de implementatie is voltooid, klikt u op de sectie Implementatiedetails en klikt u vervolgens op de resource van het type Microsoft.Web/sites. Hiermee gaat u naar de App Service web-app die u zojuist hebt gemaakt.

  15. Klik op de blade Configuratie onder Instellingen en klik in de toepassingsinstellingen op de knop Nieuwe toepassingsinstelling .

  16. Voer op de pagina Toepassingsinstelling toevoegen/bewerkennaamin als MobileAppsManagement_EXTENSION_VERSION en Waarde als meest recente en klik op OK.

U bent klaar om deze zojuist gemaakte App Service web-app te gebruiken als een mobiele app.

Een databaseverbinding maken en het client- en serverproject configureren

  1. Download de client-SDK-quickstarts voor de volgende platforms:

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

    Notitie

    Als u het iOS-project gebruikt, moet u 'azuresdk-iOS-*.zip' downloaden uit de nieuwste GitHub-release. Pak het bestand uit en voeg het MicrosoftAzureMobile.framework toe aan de hoofdmap van het project.

  2. U moet een databaseverbinding toevoegen of verbinding maken met een bestaande verbinding. Bepaal eerst of u een gegevensarchief maakt of een bestaand gegevensarchief gebruikt.

    • Maak een nieuw gegevensarchief: Als u een gegevensarchief gaat maken, gebruikt u de volgende quickstart:

      Quickstart: Aan de slag met individuele databases in Azure SQL Database

    • Bestaande gegevensbron: volg de onderstaande instructies als u een bestaande databaseverbinding wilt gebruiken

      1. SQL Database verbindingsreeksindeling -Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}

        {your_SQLServer} De naam van de server is te vinden op de overzichtspagina voor uw database en heeft meestal de vorm 'server_name.database.windows.net'. {port} meestal 1433. {your_catalogue} Naam van de database. {your_username} Gebruikersnaam voor toegang tot uw database. {your_password} Wachtwoord voor toegang tot uw database.

        Meer informatie over sql-verbindingsreeksindeling

      2. Voeg de connection string toe aan uw mobiele app In App Service kunt u verbindingsreeksen voor uw toepassing beheren met behulp van de optie Configuratie in het menu.

        Een connection string toevoegen:

        1. Klik op het tabblad Toepassingsinstellingen .

        2. Klik op [+] Nieuwe connection string.

        3. U moet naam, waarde en type opgeven voor uw connection string.

        4. Typ de naam als MS_TableConnectionString

        5. Waarde moet de verbindingsreeks zijn die u in de stap hebt gevormd.

        6. Als u een connection string toevoegt aan een SQL Azure-database, kiest u SQLAzure onder het type.

  3. Azure Mobile Apps heeft SDK's voor .NET en Node.js back-ends.

    • Node.js back-end

      Als u Node.js quickstart-app gaat gebruiken, volgt u de onderstaande instructies.

      1. Ga in de Azure Portal naar Easy Tables. U ziet dit scherm.

        Eenvoudige knooppunttabellen

      2. Zorg ervoor dat de SQL-connection string al is toegevoegd op het tabblad Configuratie. Schakel vervolgens het selectievakje in dat ik bevestig dat hiermee alle site-inhoud wordt overschreven en klik op de knop TodoItem-tabel maken.

        Configuratie van eenvoudige knooppunttabellen

      3. Klik in Eenvoudige tabellen op de knop + Toevoegen .

        Knop Toevoegen van eenvoudige knooppunttabellen

      4. Maak een TodoItem tabel met anonieme toegang.

        Tabel toevoegen met eenvoudige knooppunttabellen

    • .NET-back-end

      Als u de .NET-quickstart-app gaat gebruiken, volgt u de onderstaande instructies.

      1. Download het .NET-serverproject van Azure Mobile Apps vanuit de opslagplaats azure-mobile-apps-quickstarts.

      2. Bouw het .NET-serverproject lokaal in Visual Studio.

      3. Open in Visual Studio Solution Explorer, klik met de rechtermuisknop op project, klik op ZUMOAPPNAMEServicePubliceren, u ziet een Publish to App Service venster. Als u op Mac werkt, bekijkt u andere manieren om de app hier te implementeren.

        Visual Studio-publicatie

      4. Selecteer App Service als publicatiedoel en klik vervolgens op Bestaande selecteren en klik vervolgens op de knop Publiceren onder aan het venster.

      5. U moet zich eerst aanmelden bij Visual Studio met uw Azure-abonnement. Selecteer het SubscriptionResource Grouppictogram en selecteer vervolgens de naam van uw app. Wanneer u klaar bent, klikt u op OK. Hiermee wordt het .NET-serverproject geïmplementeerd dat u lokaal in de App Service back-end hebt. Wanneer de implementatie is voltooid, wordt u omgeleid http://{zumoappname}.azurewebsites.net/ naar de browser.

De Apache Cordova-app downloaden en uitvoeren

  1. Navigeer naar het oplossingsbestand in het clientproject (.sln) en open het met Visual Studio.

  2. Kies in Visual Studio het oplossingsplatform (Android, iOS of Windows) in de vervolgkeuzelijst naast de begin-pijl. Selecteer een specifiek implementatieapparaat of een emulator door op de vervolgkeuzelijst op de groene pijl te klikken. U kunt het standaard-Android-platform en de standaard-Ripple-emulator gebruiken. Voor geavanceerdere zelfstudies (bijv. over pushmeldingen) moet u een ondersteund apparaat of ondersteunde emulator selecteren.

  3. Open het bestand ToDoActivity.java in deze map - ZUMOAPPNAME/app/src/main/java/com/example/zumoappname. De naam van de toepassing is ZUMOAPPNAME.

  4. Ga naar de Azure Portal en navigeer naar de mobiele app die u hebt gemaakt. Zoek op de Overview blade naar de URL die het openbare eindpunt voor uw mobiele app is. Voorbeeld: de sitenaam voor mijn app-naam 'test123' is https://test123.azurewebsites.net.

  5. Ga naar het index.js bestand in ZUMOAPPNAME/www/js/index.js en vervang de parameter door onDeviceReady()ZUMOAPPURL het bovenstaande openbare eindpunt.

    client = new WindowsAzure.MobileServiceClient('ZUMOAPPURL');

    Wordt

    client = new WindowsAzure.MobileServiceClient('https://test123.azurewebsites.net');

  6. Druk op F5 of klik op de groene pijl om uw Cordova-app te bouwen en uit te voeren. Accepteer het beveiligingsdialoogvenster in de emulator waarin om toegang tot het netwerk wordt gevraagd, als dit wordt weergegeven.

  7. Nadat de app is gestart op het apparaat of de emulator, typt u zinvolle tekst in Nieuwe tekst invoeren, zoals De zelfstudie voltooien en klikt u vervolgens op de knop Toevoegen .

De back-end voegt gegevens van de aanvraag toe aan de TodoItem-tabel in de SQL Database en stuurt informatie over de nieuw opgeslagen items terug naar de mobiele app. Deze gegevens worden in de lijst in de mobiele app weergegeven.

U kunt stap 3 t/m 5 herhalen voor andere platforms.