Skapa en Apache Cordova-app

2019-06-25

Översikt

Den här självstudien visar hur du lägger till en molnbaserad serverdelstjänst i en Apache Cordova-mobilapp med hjälp av en Azure-mobilappsserverdel. Du skapar både en ny mobilappsserverdel och en enkel Apache Cordova-app för Att göra-lista som lagrar appdata i Azure.

Att slutföra den här självstudien är en förutsättning för alla andra Apache Cordova-självstudier 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, finns följande förhandskrav:

En dator med Visual Studio Community 2017 eller senare.
Visual Studio Tools för Apache Cordova.
Ett aktivt Azure-konto.

Du kan också kringgå Visual Studio och använda Apache Cordova-kommandoraden direkt. Det är användbart att använda kommandoraden när du slutför självstudien på en Mac-dator. Kompilering av Apache Cordova-klientprogram med hjälp av kommandoraden omfattas inte av den här självstudien.

Skapa en Azure-mobilappsserverdel

Logga in på Azure-portalen.
Klicka på Skapa en resurs.
I sökrutan skriver du Webbapp.
I resultatlistan väljer du Webbapp från Marketplace.
Välj din prenumeration och resursgrupp (välj en befintlig resursgrupp eller skapa en ny (med samma namn som din app)).
Välj ett unikt namn på webbappen.
Välj standardalternativet Publicera som Kod.
I Körningsstacken måste du välja en version under ASP.NET eller Node. Om du skapar en .NET-serverdel väljer du en version under ASP.NET. Om du annars riktar in dig på ett Nodbaserat program väljer du en av versionerna från Node.
Välj rätt operativsystem, antingen Linux eller Windows.
Välj den region där du vill att den här appen ska distribueras.
Välj lämplig App Service-plan och tryck på Granska och skapa.
Under Resursgrupp väljer du en befintlig resursgrupp eller skapar en ny (med samma namn som din app).
Klicka på Skapa. Vänta några minuter tills tjänsten har distribuerats framgångsrikt innan du fortsätter. Titta på ikonen Meddelanden (klockan) i portalrubriken för statusuppdateringar.
När distributionen är klar klickar du på avsnittet Distributionsinformation och klickar sedan på resursen av typen Microsoft.Web/sites. Den navigerar dig till apptjänstens webbapp som du nyss skapade.
Klicka på bladet Konfiguration under Inställningar och klicka på knappen Ny programinställning i Programinställningar.
På sidan Lägg till/redigera programinställning anger du Namn som MobileAppsManagement_EXTENSION_VERSION och Värde som senaste och trycker på OK.

Du är redo att använda den här nyligen skapade App Service-webbappen som en mobilapp.

Skapa en databasanslutning och konfigurera klient- och serverprojektet

Ladda ned snabbstarterna för klient-SDK för följande plattformar:

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

Anmärkning

Om du använder iOS-projektet måste du ladda ned "azuresdk-iOS-*.zip" från den senaste GitHub-versionen. Zippa upp och lägg till filen MicrosoftAzureMobile.framework i projektets huvudmapp.
Du måste lägga till en databasanslutning eller ansluta till en befintlig anslutning. Ta först reda på om du ska skapa ett datalager eller använda ett befintligt.
- Skapa ett nytt datalager: Om du ska skapa ett datalager använder du följande snabbstart:
  
  Snabbstart: Komma igång med enkla databaser i Azure SQL Database
- Befintlig datakälla: Följ anvisningarna nedan om du vill använda en befintlig databasanslutning
  1. SQL Database-anslutningssträngformat – Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}
    
    {your_SQLServer} Namnet på servern finns på översiktssidan för databasen och är vanligtvis i form av "server_name.database.windows.net". {port} vanligtvis 1433. {your_catalogue} Namnet på databasen. {your_username} Användarnamn för att komma åt databasen. {your_password} Lösenord för att komma åt databasen.
    
    Läs mer om SQL-anslutningssträngformat
  2. Lägg till anslutningssträngen i mobilappen I App Service kan du hantera anslutningssträngar för ditt program med hjälp av konfigurationsalternativet på menyn.
    
    Så här lägger du till en anslutningssträng:
    1. Klicka på fliken Programinställningar .
    2. Klicka på [+] Ny anslutningssträng.
    3. Du måste ange Namn, Värde och Typ för anslutningssträngen.
    4. Ange namn som MS_TableConnectionString
    5. Värdet ska vara den anslutningssträng som du skapade i steget innan.
    6. Om du lägger till en anslutningssträng i en SQL Azure-databas väljer du SQLAzure under typ.
Azure Mobile Apps har SDK:er för .NET och Node.js backend-tjänster.
- Node.js backend
  
  Om du ska använda Node.js snabbstartsapp följer du anvisningarna nedan.
  1. I Azure-portalen går du till Enkla tabeller. Den här skärmen visas.
  2. Kontrollera att SQL-anslutningssträngen redan har lagts till på fliken Konfiguration . Markera sedan kryssrutan i Jag bekräftar att detta kommer att skriva över allt webbplatsinnehåll och klicka på knappen Skapa TodoItem-tabell .
  3. I Enkla tabeller klickar du på knappen + Lägg till .
  4. Skapa en TodoItem tabell med anonym åtkomst.
- .NET-bakdel
  
  Om du ska använda .NET-snabbstartsappen följer du anvisningarna nedan.
  1. Ladda ned Azure Mobile Apps .NET-serverprojektet från lagringsplatsen azure-mobile-apps-quickstarts.
  2. Skapa .NET-serverprojektet lokalt i Visual Studio.
  3. I Visual Studio öppnar du Solution Explorer, högerklickar på projektet, klickar på ZUMOAPPNAMEServicePublicera, du ser ett Publish to App Service fönster. Om du arbetar med Mac kan du titta på andra sätt att distribuera appen här.
  4. Välj App Service som publiceringsmål och klicka sedan på Välj befintlig och klicka sedan på knappen Publicera längst ned i fönstret.
  5. Du måste logga in på Visual Studio med din Azure-prenumeration först. Välj Subscription, Resource Groupoch välj sedan namnet på din app. När du är klar klickar du på OK. Då distribueras det .NET-serverprojekt som du har lokalt till App Service-serverdelen. När distributionen är klar omdirigeras du till http://{zumoappname}.azurewebsites.net/ i webbläsaren.

Ladda ned och kör Apache Cordova-appen

Navigera till lösningsfilen i klientprojektet (.sln) och öppna den med hjälp av Visual Studio.
I Visual Studio väljer du lösningsplattformen (Android, iOS eller Windows) i listrutan bredvid startpilen. Välj en specifik distributionsenhet eller emulator genom att klicka på listrutan på den gröna pilen. Du kan använda Android-standardplattformen och Ripple-emulatorn. Mer avancerade instruktionsguider (till exempel push-meddelanden) kräver att du väljer en enhet eller emulator som stöds.
Öppna filen ToDoActivity.java i den här mappen – ZUMOAPPNAME/app/src/main/java/com/example/zumoappname. Programnamnet är ZUMOAPPNAME.
Gå till Azure-portalen och gå till den mobilapp som du skapade. På bladet Overview letar du efter url:en som är den offentliga slutpunkten för din mobilapp. Exempel – webbplatsnamnet för mitt appnamn "test123" blir https://test123.azurewebsites.net.
Gå till index.js-filen i ZUMOAPPNAME/www/js/index.js och i metoden onDeviceReady() ersätter du ZUMOAPPURL-parametern med den offentliga slutpunkten ovan.

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

Blir

client = new WindowsAzure.MobileServiceClient('https://test123.azurewebsites.net');
Om du vill skapa och köra Cordova-appen trycker du på F5 eller klickar på den gröna pilen. Om du ser en säkerhetsdialogruta i emulatorn som begär åtkomst till nätverket godkänner du den.
När appen har startats på enheten eller emulatorn skriver du meningsfull text i Ange ny text, till exempel Slutför självstudien och klickar sedan på knappen Lägg till .

Serverdelen infogar data från begäran i tabellen TodoItem i SQL Database och returnerar information om de nyligen lagrade objekten tillbaka till mobilappen. Mobilappen visar dessa data i listan.

Du kan upprepa steg 3 till och med 5 för andra plattformar.

Dela via