Creare un'app per Xamarin.iOS

Panoramica

Questa esercitazione illustra come aggiungere un servizio back-end basato sul cloud a un'app per dispositivi mobili Xamarin.iOS mediante un back-end per app per dispositivi mobili di Azure. Verranno creati un nuovo back-end di app per dispositivi mobili e una semplice app Xamarin.iOS Todo list che archivia i dati delle app in Azure.

Il completamento di questa esercitazione è un prerequisito per tutte le altre esercitazioni Xamarin.iOS relative all'uso della funzionalità di Azure App Service relativa alle app per dispositivi mobili.

Prerequisiti

Per completare questa esercitazione è necessario soddisfare i prerequisiti seguenti:

  • Un account Azure attivo. Se non è disponibile un account, iscriversi per accedere a una versione di valutazione di Azure e ottenere un massimo di 10 app per dispositivi mobili gratuite che potranno essere usate anche dopo il termine del periodo di valutazione. Per informazioni dettagliate, vedere la pagina relativa alla versione di valutazione gratuita di Azure.
  • Visual Studio per Mac. Vedere Installazione e installazione per Visual Studio per Mac
  • Mac con Xcode 9.0 o versione successiva.

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

  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.

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 per distribuire il progetto server .NET disponibile in locale nel back-end servizio app. Al termine della distribuzione, si verrà reindirizzati a http://{zumoappname}.azurewebsites.net/ nel browser.

Eseguire l'app Xamarin.iOS

  1. Aprire il progetto Xamarin.iOS.

  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 del sito per il nome dell'app "test123" sarà https://test123.azurewebsites.net.

  3. Aprire il file QSTodoService.cs in questa cartella: xamarin.iOS/ZUMOAPPNAME. Il nome dell'applicazione è ZUMOAPPNAME.

  4. Nella QSTodoService 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 in un emulatore iPhone.

  6. Nell'app digitare testo significativo, ad esempio Completa l'esercitazione e quindi fare clic sul pulsante + .

    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.