Componente Xamarin per Microsoft Intune App SDKMicrosoft Intune App SDK Xamarin Component

Nota

Può essere utile leggere prima l'articolo Introduzione a Microsoft Intune App SDK, che spiega come preparare l'integrazione in ogni piattaforma supportata.You may wish to first read the Get Started with Intune App SDK article, which explains how to prepare for integration on each supported platform.

PanoramicaOverview

Il componente Xamarin per Intune App SDK consente l'uso dei criteri di protezione delle app di Intune nelle app per iOS e Android compilate con Xamarin.The Intune App SDK Xamarin component enables Intune app protection policy in iOS and Android apps built with Xamarin. Il componente consente agli sviluppatori di creare con facilità le funzionalità di protezione dell'app Intune nella propria app basata su Xamarin.The component allows developers to easily build in Intune app protection features into their Xamarin-based app.

Nota

Il supporto per l'SDK di Intune per Xamarin è attualmente disponibile in anteprima.Support for the Intune SDK for Xamarin is currently available in preview.

Il componente Xamarin per Microsoft Intune App SDK consente di incorporare i criteri di protezione delle app di Intune, definiti anche criteri APP o MAM, nelle app sviluppate con Xamarin.The Microsoft Intune App SDK Xamarin Component lets you incorporate Intune app protection policies (also known as APP or MAM policies) into your apps developed with Xamarin. Un'applicazione abilitata per MAM è integrata con Intune App SDK.A MAM-enabled application is one that is integrated with the Intune App SDK. Gli amministratori IT possono distribuire i criteri di protezione all'app per dispositivi mobili quando Intune gestisce attivamente l'app.IT administrators can deploy app protection policies to your mobile app when Intune actively manages the app.

Elementi supportatiWhat's supported?

Computer di sviluppoDeveloper machines

  • macOSmacOS

Piattaforme di app per dispositivi mobiliMobile app platforms

  • AndroidAndroid
  • iOSiOS

Scenari di gestione di applicazioni mobili di IntuneIntune Mobile Application Management scenarios

  • Dispositivi registrati MDM di IntuneIntune MDM-enrolled devices
  • Dispositivi registrati EMM di terze partiThird-party EMM-enrolled devices
  • Dispositivi non gestiti (non registrati con MDM)Unmanaged devices (not enrolled with any MDM)

Le app Xamarin compilate con il componente Xamarin per Intune App SDK possono ora ricevere i criteri di protezione delle app di Intune nel dispositivi registrati in Gestione dei dispositivi mobili di Intune e nei dispositivi non registrati.Xamarin apps built with the Intune App SDK Xamarin Component can now receive Intune app protection policies on both Intune mobile device management (MDM) enrolled devices and unenrolled devices.

PrerequisitiPrerequisites

  • [Solo per Android] Nel dispositivo deve essere installata l'app Portale aziendale di Microsoft Intune più recente.[Android only] The latest Microsoft Intune Company Portal app must be installed on the device.

Operazioni preliminariGet started

  1. Scaricare Xamarin-component.exe da qui ed estrarre i file.Download Xamarin-component.exe from here and extract it.

  2. Leggere le condizioni di licenza per il componente Xamarin per le funzionalità MAM di Microsoft Intune.Read the license terms for the Microsoft Intune MAM Xamarin Component.

  3. Scaricare la cartella del componente Xamarin per Intune App SDK da GitHub o Xamarin ed estrarre i file.Download the Intune App SDK Xamarin Component folder from GitHub or Xamarin and extract it. Entrambi i file scaricati al passaggio 1 e al passaggio 3 devono essere nello stesso livello di directory.Both files downloaded from step 1 and step 3 should be in the same directory level.

  4. Nella riga di comando come amministratore eseguire Xamarin.Component.exe install <.xam> file.In the command line as an administrator, run Xamarin.Component.exe install <.xam> file.

  5. In Visual Studio fare clic con il pulsante destro del mouse sui componenti nel progetto Xamarin creato in precedenza.In Visual Studio, right-click components in your previously created Xamarin project.

  6. Selezionare Modifica componenti e aggiungere il componente Intune App SDK scaricato localmente nel computer.Select Edit Components and add the Intune App SDK component you’ve downloaded locally to your computer.

Abilitazione dei criteri di protezione delle app di Intune nell'app per dispositivi mobili iOSEnabling Intune app protection polices in your iOS mobile app

  1. Seguire i passaggi generali necessari per l'integrazione di Intune App SDK in un'app per dispositivi mobili iOS.Follow the general steps required for integrating the Intune App SDK into an iOS mobile app. È possibile iniziare dal passaggio 3 delle istruzioni di integrazione nel Manuale dello sviluppatore di Intune App SDK per iOS.You can begin with step 3 of the integration instructions from the Intune App SDK for iOS Developer Guide. Importante: l'abilitazione della condivisione del keychain per un'app è leggermente diversa in Visual Studio rispetto a Xcode.Important: Enabling keychain sharing for an app is slightly different in Visual Studio from Xcode. Aprire il file Entitlements.plist dell'app e assicurarsi che l'opzione "Abilita Keychain" sia abilitata e che in tale sezione vengano aggiunti i gruppi di condivisione del keychain appropriati.Open the app's Entitlements plist and make sure the "Enable Keychain" option is enabled and the appropriate keychain sharing groups are added in that section. Assicurarsi quindi di specificare il file Entitlements.plist nel campo "Entitlement personalizzati" delle opzioni "Firma del bundle iOS" del progetto per tutte le combinazioni di configurazione/piattaforma appropriate.Then, ensure the Entitlements plist is specified in the "Custom Entitlements" field of the project's "iOS Bundle Signing" options for all the appropriate Configuration/Platform combinations.
  2. Dopo l'aggiunta del componente e quando l'app è configurata correttamente, l'app può iniziare a usare le API di Intune SDK.Once the component is added and the app is properly configured, your app can begin using the Intune SDK's APIs. A tale scopo, è necessario includere lo spazio dei nomi seguente:To do so, you must include the following namespace:

    using Microsoft.Intune.MAM;
    
  3. Per iniziare a ricevere i criteri di protezione delle app, è necessario registrare l'app nel servizio MAM di Intune.To begin receiving app protection policies, your app must enroll in the Intune MAM service. Se l'app usa già la libreria ADAL (Azure Active Directory Authentication Library) per l'autenticazione degli utenti, l'app deve fornire l'UPN dell'utente al metodo registerAndEnrollAccount di IntuneMAMEnrollmentManager dopo che è stato autenticato:If your app already uses the Azure Active Directory Authentication Library (ADAL) to authenticate users, your app should provide the user's UPN to the IntuneMAMEnrollmentManager's registerAndEnrollAccount method after it has successfully authenticated:

    IntuneMAMEnrollmentManager.Instance.RegisterAndEnrollAccount(string identity);
    

    Importante: assicurarsi di sostituire le impostazioni predefinite per la libreria ADAL di Intune App SDK con quelle dell'app.Important: Be sure to override the Intune App SDK's default ADAL settings with those of your app. È possibile farlo tramite il dizionario IntuneMAMSettings nel file Info.plist dell'app, come indicato nel Manuale dello sviluppatore di Intune App SDK per iOS oppure è possibile usare le proprietà di sostituzione AAD dell'istanza IntuneMAMPolicyManager.You can do so via the IntuneMAMSettings dictionary in the app's Info.plist, as mentioned in the Intune App SDK for iOS Developer Guide, or you can use the AAD override properties of the IntuneMAMPolicyManager instance. L'approccio che prevede il file Info.plist è consigliato per applicazioni con impostazioni ADAL statiche, mentre le proprietà di sostituzione sono consigliate per le applicazioni che determinano questi valori in fase di esecuzione.The Info.plist approach is recommended for applications whose ADAL settings are static while the override properties are recommended for applications that determine those values at runtime.

    Se l'app non usa ADAL e si vuole gestire l'autenticazione con Intune SDK, l'app deve chiamare il metodo loginAndEnrollAccount di IntuneMAMEnrollmentManager:If your app does not use ADAL, and you'd like the Intune SDK to handle authentication, your app should call the IntuneMAMEnrollmentManager's loginAndEnrollAccount method:

     IntuneMAMEnrollmentManager.Instance.LoginAndEnrollAccount([NullAllowed] string identity);
    

Abilitazione dei criteri di protezione delle app di Intune nell'app per dispositivi mobili AndroidEnabling app protection policies in your Android mobile app

Per le app per Android basate su Xamarin che non usano un framework interfaccia utente, è necessario leggere e seguire la Guida a Microsoft Intune App SDK per sviluppatori Android.For Xamarin-based Android apps not using a UI framework, you need to read and follow the Intune App SDK for Android Developer Guide. Per l'app per Android basata su Xamarin, è necessario sostituire classe, metodi e attività con i rispettivi equivalenti per MAM in base alla tabella inclusa nella guida.For your Xamarin-based Android app, you need to replace class, methods, and activities with their MAM equivalent based on the table included in the guide. Se l'app non definisce una classe android.app.Application, è necessario crearne una e assicurarsi di ereditare da MAMApplication.If your app doesn’t define an android.app.Application class, you need to create one and ensure that you inherit from MAMApplication.

Per Xamarin Forms e altri framework interfaccia utente, Microsoft offre uno strumento denominato MAM.Remapper,For Xamarin Forms and other UI frameworks, we have provided a tool called MAM.Remapper. che esegue automaticamente la sostituzione della classe.The tool accomplishes the class replacement for you. L'utente deve tuttavia eseguire le operazioni seguenti:However, you need to do the following steps:

  1. Aggiungere un riferimento al pacchetto NuGet Microsoft.Intune.MAM.Remapper.Tasks versione 0.1.0.0 o successiva.Add a reference to the Microsoft.Intune.MAM.Remapper.Tasks NuGet package version 0.1.0.0 or greater.

  2. Aggiungere la riga seguente al file csproj per Android:Add the following line to your Android csproj:

    <Import
    Project="$(NugetPack)\\Microsoft.Intune.MAM.Remapper.Tasks.0.1.X.X\\build\\MonoAndroid10\\Microsoft.Intune.MAM.Remapper.targets" />
    
  3. Impostare l'azione di compilazione del file remapping-config.json aggiunto su RemappingConfigFile.Set the build action of the added remapping-config.json file to RemappingConfigFile. Il file remapping-config.json incluso può essere usato solo con Xamarin.Forms.The included remapping-config.json only works with Xamarin.Forms. Per altri framework interfaccia utente, fare riferimento al file leggimi incluso nel pacchetto NuGet del Remapper.For other UI frameworks, refer to the Readme included with the Remapper NuGet package.

Passaggi successiviNext steps

Le operazioni principali per la compilazione del componente nell'app sono state completate.You have completed the basic steps of building the component into your app. A questo punto è possibile seguire i passaggi inclusi nell'app di esempio Xamarin Android.Now you can follow the steps included in the Xamarin Android sample app. Sono disponibili due esempi, rispettivamente per Xamarin.Forms e per Android.We have provided two samples, one for Xamarin.Forms and another for Android.