Skapa en Xamarin.iOS-app

2019-06-25

Översikt

Den här handledningen visar hur du lägger till en molnbaserad serverdel i en Xamarin.iOS-mobilapp med hjälp av en Azure-serverdel för mobilappar. Du skapar både en ny mobilappsserverdel och en enkel Todo-lista Xamarin.iOS-app som lagrar appdata i Azure.

Att slutföra den här självstudien är en förutsättning för alla andra Xamarin.iOS-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:

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 som du kan fortsätta använda även när utvärderingsversionen är slut. Mer information finns i kostnadsfri utvärderingsversion av Azure.
Visual Studio för Mac. Se installation och konfiguration för Visual Studio för Mac
En Mac med Xcode 9.0 eller senare.

Skapa en Azure Mobile App-serverdel

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.

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.iOS-appen

Öppna Xamarin.iOS-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 QSTodoService.cs i den här mappen – xamarin.iOS/ZUMOAPPNAME. Programnamnet är ZUMOAPPNAME.
I QSTodoService-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 en iPhone-emulator.
I appen skriver du meningsfull text, till exempel Slutför självstudien och klickar sedan på knappen + .

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

Dela via