Skapa en Xamarin.Android-app

Artikel
06/25/2019

Översikt

Den här handledningen visar hur du lägger till en molnbaserad backend-tjänst i en Xamarin.Android-app. För mer information, se Vad är mobilappar.

En skärmbild från den färdiga appen finns nedan:

Att slutföra den här självstudien är en förutsättning för alla andra självstudier för mobilappar i Xamarin.Android.

Förutsättningar

För att slutföra den här självstudien, finns följande förhandskrav:

Ett aktivt Azure-konto. Om du inte har något konto registrerar du dig för en Utvärderingsversion av Azure och får upp till 10 kostnadsfria Mobilappar. Mer information finns i kostnadsfri utvärderingsversion av Azure.
Visual Studio med Xamarin. Anvisningar finns i Förberedelse och installation för Visual Studio och Xamarin.

Skapa en Azure Mobile App-serverdel

Följ de här stegen för att skapa en mobilappsserverdel.

Logga in på Azure-portalen.
Klicka på Skapa en resurs.
I sökrutan skriver du Web App.
I resultatlistan väljer du Web App 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 för din webbapp.
Välj standardalternativet Publicera som Code.
I Runtime-stackenmå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 resursgruppväljer du en befintlig resursgrupp eller skapa 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å Resurs av typen Microsoft.Web/sites. Den navigerar dig till apptjänstens webbapp som du nyss skapade.
Klicka på bladet Konfiguration under Inställningar och i Programinställningarklickar du på knappen Ny programinställning.
I lägg till/redigera programinställningen 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.

Nu har du etablerat en Azure Mobile App-serverdel som kan användas av dina mobila klientprogram. Ladda sedan ner ett serverprojekt för en enkel "att göra-lista"-backend och publicera det till Azure.

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 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} Serverns namn kan hittas på översiktssidan för din databas och brukar finnas i formen "server_name.database.windows.net". {port} vanligtvis 1433. {your_catalogue} Namnet på databasen. {your_username} Användarnamn för att få åtkomst till databasen. {your_password} Lösenord för att få åtkomst till databasen.
    
    Läs mer om SQL-anslutningssträngformat
  2. Lägg till anslutningssträngen i din mobilapp I App Service kan du hantera anslutningssträngar för ditt program med hjälp av alternativet Konfiguration 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. Skriv 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 jag bekräftar att detta kommer att skriva över allt webbplatsinnehåll och klicka på knappen Skapa TodoItem-tabell.
  3. I Enkla tabellerklickar 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å ZUMOAPPNAMEService projekt, klickar på Publiceravisas ett Publish to App Service fönster. Om du arbetar med Mac kan du kolla in andra sätt att distribuera appen här.
  4. Välj App Service som publiceringsmål och klicka sedan på Välj befintligoch 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.

Kör Xamarin.Android-appen

Öppna Xamarin.Android-projektet.
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.
Öppna filen ToDoActivity.cs i den här mappen – xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. Programnamnet är ZUMOAPPNAME.
I ToDoActivity-klass ersätter du ZUMOAPPURL variabel med den offentliga slutpunkten ovan.

const string applicationURL = @"ZUMOAPPURL";

Blir

const string applicationURL = @"https://test123.azurewebsites.net";
Tryck på F5-tangenten för att distribuera och köra appen.
I appen skriver du meningsfull text, till exempel Slutför självstudien och klickar sedan på knappen Lägg till.

Data från begäran infogas i tabellen TodoItem. Objekt som lagras i tabellen returneras av mobilappens serverdel och data visas i listan.

Anmärkning

Du kan granska koden som kommer åt mobilappens serverdel för att fråga efter och infoga data, som finns i filen ToDoActivity.cs C#.

Felsökning

Om du har problem med att skapa lösningen kör du NuGet-pakethanteraren och uppdaterar de Xamarin.Android supportpaketen. Snabbstartsprojekt kanske inte alltid innehåller de senaste versionerna.

Observera att alla supportpaket som refereras till i projektet måste ha samma version. NuGet-paketet Azure Mobile Apps har Xamarin.Android.Support.CustomTabs beroende av Android-plattformen, så om ditt projekt använder nyare supportpaket måste du installera det här paketet med den version som krävs direkt för att undvika konflikter.

Dela via