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.

Le funzionalità SDK possono essere abilitate senza modificare il comportamento dell'app.You will find that you can enable SDK features without changing your app’s behavior. Dopo avere compilato il componente nell'app per dispositivi mobili per Android o iOS, l'amministratore IT potrà distribuire i criteri con la gestione di applicazioni mobili (MAM) di Microsoft Intune, che supporta un'ampia gamma di funzionalità di protezione dei dati.Once you've built the component into your iOS or Android mobile app, the IT admin will be able to deploy policy via Microsoft Intune Mobile Application Management (MAM) supporting a variety of data protection features.

Elementi supportatiWhat's supported?

Computer di sviluppoDeveloper machines

  • WindowsWindows

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 gestione delle applicazioni per dispositivi mobili (MAM) di Intune sia sui dispositivi registrati per la gestione dei dispositivi mobili (MDM) di Intune che su quelli non registrati.Xamarin apps built with the Intune App SDK Xamarin Component can now receive Intune mobile application management (MAM) policies on both Intune mobile device management (MDM) enrolled devices and unenrolled devices.

PrerequisitiPrerequisites

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

IntroduzioneGet 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 delle funzionalità MAM di Intune nell'app per dispositivi mobili per iOSEnabling Intune MAM in your iOS mobile app

  1. Per inizializzare Intune App SDK, è necessario chiamare un'API nella classe AppDelegate.cs.In order to initialize the Intune App SDK, you will need to make a call for any API in the AppDelegate.cs class. Ad esempio:For example:

    public override bool FinishedLaunching (UIApplication application, NSDictionary launchOptions)
    {
          Console.WriteLine ("Is Managed: {0}", IntuneMAMPolicyManager.Instance.PrimaryUser != null);
          return true;
    }
    
  2. Ora che il componente è stato aggiunto e inizializzato, è possibile seguire i passaggi generali necessari per la compilazione di App SDK in un'app per dispositivi mobili per iOS.Now that the component is added and initialized, you can follow the general steps required for building the App SDK into an iOS mobile app. La documentazione completa per l'abilitazione delle app native per iOS è disponibile nella Guida a Microsoft Intune App SDK per sviluppatori iOS.You can find the full documentation for enabling native iOS apps in the Intune App SDK for iOS Developer Guide.

  3. Importante: sono disponibili diverse modifiche specifiche delle applicazioni per iOS basate su Xamarin.Important: There are several modifications specific to Xamarin-based iOS apps. Ad esempio, quando si abilitano gruppi di portachiavi, è necessario aggiungere il codice seguente per includere l'app di esempio di Xamarin inclusa nel componente.For instance, when enabling keychain groups, you'll need to add the following to include the Xamarin sample app we included in the component. Di seguito è riportato un esempio dei gruppi di cui è necessario disporre nei gruppi di accesso portachiavi:Below is an example of the groups you would need to have in your Keychain Access groups:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
          <dict>
                <key>keychain-access-groups</key>
                <array>
                      <string>$(AppIdentifierPrefix)com.xamarin.microsoftintunesample</string>
                      <string>$(AppIdentifierPrefix)com.xamarin.microsoftintunesample.intunemam</string>
                      <string>$(AppIdentifierPrefix)com.microsoft.intune.mam</string>
                      <string>$(AppIdentifierPrefix)com.microsoft.adalcache</string>
                </array>
          </dict>
    </plist>
    

È stata completata la procedura necessaria per compilare il componente in un'app per iOS basata su Xamarin.You have completed the steps necessary to build the component into your Xamarin-based iOS app. Se si usa Xcode per la compilazione del progetto, è possibile usare Intune App SDK Settings.bundle.If you are utilizing Xcode for building your project, you can use the Intune App SDK Settings.bundle. In questo modo sarà possibile attivare e disattivare le impostazioni dei criteri di Intune quando si compila il progetto per il test e il debug.This will allow you to toggle Intune policy settings on and off as you build your project to test and debug. Per sfruttare i vantaggi di questo bundle, seguire i passaggi della Guida a Microsoft Intune App SDK per sviluppatori iOS e leggere la sezione relativa al debug in Xcode.To take advantage of this bundle, follow the steps in the Intune App SDK for iOS Developer Guide and read the section on debugging in Xcode.

Abilitazione delle funzionalità MAM nell'app per dispositivi mobili per AndroidEnabling MAM 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 will 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 will 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, sarà necessario crearne una e assicurarsi di ereditare da MAMApplication.If your app doesn’t define an android.app.Application class, you will 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 eseguirà automaticamente la sostituzione della classe.The tool will accomplish the class replacement for you. L'utente dovrà tuttavia eseguire le operazioni seguenti:However, you will 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 theMicrosoft.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.

Test dell'appTest your app

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.

Per inviare commenti e suggerimenti sul prodotto, visita la pagina Intune Feedback