Condividi tramite


Creare un'app per Xamarin.Android

Panoramica

Questa esercitazione illustra come aggiungere un servizio back-end basato sul cloud a un'app Xamarin.Android. Per altre informazioni, vedere Informazioni sulle app per dispositivi mobili.

Di seguito è riportata una schermata dell'app completata:

Il completamento di questa esercitazione è un prerequisito per tutte le altre esercitazioni relative alle app per dispositivi mobili per Xamarin.Android.

Prerequisiti

Per completare questa esercitazione è necessario soddisfare i prerequisiti seguenti:

Creare un back-end dell'app per dispositivi mobili di Azure

Seguire questa procedura per creare un back-end dell'app per dispositivi mobili.

  1. Accedere al portale di Azure.

  2. Fare clic su Crea una risorsa.

  3. Nella casella di ricerca digitare App Web.

  4. Nell'elenco dei risultati selezionare App Web dal Marketplace.

  5. Selezionare la sottoscrizione e il gruppo di risorse (selezionare un gruppo di risorse esistente o crearne uno nuovo usando lo stesso nome dell'app).

  6. Scegliere un nome univoco dell'app Web.

  7. Scegliere l'opzione Pubblica predefinita come Codice.

  8. Nello stack di runtime è necessario selezionare una versione in ASP.NET o Nodo. Se si sta creando un back-end .NET, selezionare una versione in ASP.NET. In caso contrario, se si ha come destinazione un'applicazione basata su Node, selezionare una delle versioni da Node.

  9. Selezionare il sistema operativo corretto, Linux o Windows.

  10. Selezionare l'area in cui si vuole distribuire l'app.

  11. Selezionare il servizio app appropriato Pianificare e premere Rivedi e crea.

  12. In Gruppo di risorse selezionare un gruppo di risorse esistente oppure crearne uno nuovo usando lo stesso nome dell'app.

  13. Fare clic su Crea. Prima di procedere, attendere il completamento della distribuzione del servizio. Osservare l'icona di notifica (a forma di campana) nell'intestazione del portale per informazioni sugli aggiornamenti dello stato.

  14. Al termine della distribuzione, fare clic sulla sezione Dettagli distribuzione e quindi fare clic sulla risorsa di tipo Microsoft.Web/sites. Si passerà all'app Web servizio app appena creata.

  15. Fare clic sul pannello Configurazione in Impostazioni e in Impostazioni applicazione fare clic sul pulsante Nuova impostazione applicazione .

  16. Nella pagina Impostazioni dell'applicazione Aggiungi/Modifica immettere Nome come MobileAppsManagement_EXTENSION_VERSION e Valore come più recente e premere OK.

È tutto impostato per usare questa app Web appena creata servizio app come app per dispositivi mobili.

È stato eseguito il provisioning di un back-end dell'app per dispositivi mobili di Azure che può essere usato dalle applicazioni client per dispositivi mobili. Scaricare quindi un progetto server per un semplice back-end "todo list" e pubblicarlo in Azure.

Creare una connessione al database e configurare il progetto client e server

  1. Scaricare le guide introduttive dell'SDK client per le piattaforme seguenti:

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

    Nota

    Se si usa il progetto iOS, è necessario scaricare "azuresdk-iOS-*.zip" dalla versione più recente di GitHub. Decomprimere e aggiungere il MicrosoftAzureMobile.framework file alla radice del progetto.

  2. Sarà necessario aggiungere una connessione al database o connettersi a una connessione esistente. Determinare prima di tutto se si creerà un archivio dati o si userà un archivio dati esistente.

    • Creare un nuovo archivio dati: se si intende creare un archivio dati, usare la guida introduttiva seguente:

      Guida introduttiva: Introduzione ai database singoli in Azure SQL Database

    • Origine dati esistente: seguire le istruzioni riportate di seguito se si vuole usare una connessione al database esistente

      1. database SQL formato stringa di connessione -Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}

        {your_SQLServer} Nome del server, disponibile nella pagina di panoramica per il database ed è in genere sotto forma di "server_name.database.windows.net". {port} in genere 1433. {your_catalogue} Nome del database. {your_username} Nome utente per accedere al database. {your_password} Password per accedere al database.

        Altre informazioni sul formato stringa di connessione SQL

      2. Aggiungere la stringa di connessione all'app per dispositivi mobili In servizio app è possibile gestire le stringhe di connessione per l'applicazione usando l'opzione Configurazione nel menu.

        Per aggiungere una stringa di connessione:

        1. Fare clic sulla scheda Impostazioni applicazione .

        2. Fare clic su [+] Nuova stringa di connessione.

        3. Sarà necessario specificare Nome, Valore e Tipo per la stringa di connessione.

        4. Digitare Name (Nome tipo) come MS_TableConnectionString

        5. Il valore deve essere la stringa di connessione creata nel passaggio precedente.

        6. Se si aggiunge una stringa di connessione a un database SQL Azure scegliere SQLAzure sotto tipo.

  3. App per dispositivi mobili di Azure include SDK per .NET e back-end Node.js.

    • Back-end Node.js

      Se si intende usare Node.js'app di avvio rapido, seguire le istruzioni riportate di seguito.

      1. Nella portale di Azure passare a Tabelle semplici. Verrà visualizzata questa schermata.

        Tabelle semplici dei nodi

      2. Assicurarsi che la stringa di connessione SQL sia già stata aggiunta nella scheda Configurazione . Selezionare quindi la casella di conferma che verrà sovrascritto tutto il contenuto del sito e fare clic sul pulsante Crea tabella TodoItem .

        Configurazione delle tabelle semplici del nodo

      3. In Tabelle semplici fare clic sul pulsante + Aggiungi .

        Pulsante Aggiungi tabelle semplici nodo

      4. Creare una TodoItem tabella con accesso anonimo.

        Tabelle semplici nodo - Aggiungi tabella

    • Back-end .NET

      Se si intende usare l'app di avvio rapido .NET, seguire le istruzioni riportate di seguito.

      1. Scaricare il progetto server .NET di App per dispositivi mobili di Azure dal repository azure-mobile-apps-quickstarts.

      2. Compilare il progetto server .NET in locale in Visual Studio.

      3. In Visual Studio aprire Esplora soluzioni, fare clic con il pulsante destro del mouse sul ZUMOAPPNAMEService progetto, scegliere Pubblica. Verrà visualizzata una Publish to App Service finestra. Se si lavora su Mac, vedere altri modi per distribuire l'app qui.

        Pubblicazione in Visual Studio

      4. Selezionare servizio app come destinazione di pubblicazione, quindi fare clic su Seleziona esistente e quindi sul pulsante Pubblica nella parte inferiore della finestra.

      5. Per prima cosa è necessario accedere a Visual Studio con la sottoscrizione di Azure. SubscriptionSelezionare , Resource Groupe quindi selezionare il nome dell'app. Quando si è pronti, fare clic su OK, verrà distribuito il progetto del server .NET in locale nel back-end di servizio app. Al termine della distribuzione, verrà eseguito il reindirizzamento al http://{zumoappname}.azurewebsites.net/ browser.

Eseguire l'app Xamarin.Android

  1. Aprire il progetto Xamarin.Android.

  2. Passare alla portale di Azure e passare all'app per dispositivi mobili creata. Overview Nel pannello cercare l'URL che rappresenta l'endpoint pubblico per l'app per dispositivi mobili. Esempio: il nome sito per il nome dell'app "test123" sarà https://test123.azurewebsites.net.

  3. Aprire il file ToDoActivity.cs in questa cartella - xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. Il nome dell'applicazione è ZUMOAPPNAME.

  4. In ToDoActivity classe sostituire ZUMOAPPURL la variabile con l'endpoint pubblico precedente.

    const string applicationURL = @"ZUMOAPPURL";

    diventa

    const string applicationURL = @"https://test123.azurewebsites.net";

  5. Premere il tasto F5 per distribuire ed eseguire l'app.

  6. Nell'app digitare un testo significativo, ad esempio Complete the tutorial quindi fare clic sul pulsante Add.

    I dati della richiesta vengono inseriti nella tabella TodoItem. Gli elementi archiviati nella tabella vengono restituiti dal back-end per app per dispositivi mobili e i dati vengono visualizzati nell'elenco.

    Nota

    È possibile esaminare il codice che accede al back-end per app mobili per eseguire una query e inserire i dati trovati nel file C# ToDoActivity.cs.

Risoluzione dei problemi

In caso di problemi di compilazione della soluzione, eseguire Gestione pacchetti NuGet ed effettuare l'aggiornamento dei pacchetti di supporto Xamarin.Android. I progetti di avvio rapido potrebbero non includere sempre le versioni più recenti.

Si noti che tutti i pacchetti di supporto a cui fa riferimento il progetto devono avere la stessa versione. Il pacchetto NuGet di App per dispositivi mobili di Azure presenta la dipendenza Xamarin.Android.Support.CustomTabs per la piattaforma Android, perciò se il progetto usa pacchetti di supporto più recenti è necessario installare questo pacchetto direttamente con la versione richiesta per evitare conflitti.