Een Xamarin.Android-app maken

Artikel
06/25/2019

Overzicht

Deze zelfstudie laat zien hoe u een back-endservice toevoegt aan een Xamarin.Android-app in de cloud. Zie What are Mobile Apps (Wat zijn Mobile Apps?) voor meer informatie.

Hieronder ziet u een schermafbeelding van de voltooide app:

Het voltooien van deze zelfstudie is een vereiste voor alle andere Mobile Apps-zelfstudies voor Xamarin.Android-apps.

Vereisten

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

Een actief Azure-account. Als u geen account hebt, meld u zich aan voor een proefversie van Azure en ontvangt u maximaal 10 gratis mobiele apps. Zie Gratis proefversie van Azure voor meer informatie.
Visual Studio met Xamarin. Zie Setup and install for Visual Studio and Xamarin (Installeren en instellen voor Visual Studio en Xamarin) voor instructies.

Een back-end voor mobiele apps van Azure maken

Volg deze stappen voor het maken van een back-end voor mobiele apps.

Meld u aan bij de Azure-portal.
Klik op Een resource maken.
Typ web-app in het zoekvak.
Selecteer web-app in de lijst met resultaten in Marketplace.
Selecteer uw abonnement en resourcegroep (selecteer een bestaande resourcegroep of maak een nieuwe resourcegroep (met dezelfde naam als uw app)).
Kies een unieke naam van uw web-app.
Kies de standaardoptie Publiceren als Code.
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.
Selecteer het juiste besturingssysteem, Linux of Windows.
Selecteer de regio waar u deze app wilt implementeren.
Selecteer de juiste App Service Plan en klik op Beoordelen en maken.
Selecteer onder Resourcegroep een bestaande resourcegroep of maak een nieuwe resourcegroep (met dezelfde naam als uw app).
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.
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.
Klik op de blade Configuratie onder Instellingen en klik in de toepassingsinstellingen op de knop Nieuwe toepassingsinstelling .
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.

U hebt nu een back-end voor Azure Mobile Apps ingericht, die kan worden gebruikt door uw mobiele clienttoepassingen. Download vervolgens een serverproject voor een eenvoudige back-end voor takenlijsten en publiceer deze naar Azure.

Een databaseverbinding maken en het client- en serverproject configureren

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.
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.
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.
  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.
  3. Klik in Eenvoudige tabellen op de knop + Toevoegen .
  4. Maak een TodoItem tabel met anonieme toegang.
- .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.
  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 Xamarin.Android-app uitvoeren

Open het Xamarin.Android-project.
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.
Open het bestand ToDoActivity.cs in deze map - xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. De naam van de toepassing is ZUMOAPPNAME.
Vervang in ToDoActivity klasse de variabele door ZUMOAPPURL het bovenstaande openbare eindpunt.

const string applicationURL = @"ZUMOAPPURL";

Wordt

const string applicationURL = @"https://test123.azurewebsites.net";
Druk op de F5-toets om de app te implementeren en uit te voeren.
Typ zinvolle tekst in de app, zoals De zelfstudie voltooien en klik vervolgens op de knop Toevoegen .

De gegevens van de aanvraag worden opgenomen in de takentabel. Items die zijn opgeslagen in de tabel, worden geretourneerd door de back-end voor mobiele apps en de gegevens verschijnen in de lijst.

Notitie

U kunt de code die toegang heeft tot de back-end van uw mobiele app bekijken om gegevens op te vragen en in te voegen. Deze code vindt u in het C#-bestand ToDoActivity.cs.

Problemen oplossen

Als u er problemen zijn met het bouwen van de oplossing, voert u NuGet Package Manager uit en werkt u de Xamarin.Android-ondersteuningspakketten bij. Quick Start-projecten bevatten mogelijk niet altijd de nieuwste versies.

Alle ondersteuningspakketten waarnaar wordt verwezen in uw project, moeten dezelfde versie hebben. Het Azure Mobile Apps NuGet-pakket heeft Xamarin.Android.Support.CustomTabs-afhankelijkheid voor het Android-platform, dus als uw project gebruikmaakt van nieuwere ondersteuningspakketten, moet u dit pakket met de vereiste versie rechtstreeks installeren om conflicten te voorkomen.

Delen via