Intune App SDK-Xamarin-KomponenteMicrosoft Intune App SDK Xamarin Component

Hinweis

Lesen Sie am besten zuerst den Leitfaden Erste Schritte mit dem Microsoft Intune App SDK. Dort finden Sie Informationen zu den Vorbereitungen, die Sie auf den verschiedenen unterstützten Plattformen für die Integration treffen müssen.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.

ÜbersichtOverview

Mit der Intune App SDK-Xamarin-Komponente können Sie die Intune-App-Schutzrichtlinie in Ihren mit Xamarin erstellten iOS- und Android-Apps aktivieren.The Intune App SDK Xamarin component enables Intune app protection policy in iOS and Android apps built with Xamarin. Die Komponente erlaubt Entwicklern, App-Schutzfunktionen von Intune auf einfache Weise in ihre Xamarin-basierten App zu integrieren.The component allows developers to easily build in Intune app protection features into their Xamarin-based app.

Hinweis

Die Unterstützung für das Intune SDK für Xamarin ist derzeit in der Vorschauversion verfügbar.Support for the Intune SDK for Xamarin is currently available in preview.

Mit der Microsoft Intune App SDK Xamarin-Komponente können Sie die Intune-App-Schutzrichtlinien (auch als APP- oder MAM-Richtlinien bezeichnet) in Ihre mit Xamarin entwickelten Apps integrieren.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. MAM-fähige Anwendungen sind in das Intune App SDK integrierte Anwendungen.A MAM-enabled application is one that is integrated with the Intune App SDK. Sie ermöglichen IT-Administratoren, App-Schutzrichtlinien für Ihre mobile App bereitzustellen, wenn diese aktiv von Intune verwaltet wird.IT administrators can deploy app protection policies to your mobile app when Intune actively manages the app.

Was wird unterstützt?What's supported?

EntwicklercomputerDeveloper machines

  • macOSmacOS

Mobile App-PlattformenMobile app platforms

  • AndroidAndroid
  • iOSiOS

Intune MAM-SzenarienIntune Mobile Application Management scenarios

  • Mit Intune MDM registrierte GeräteIntune MDM-enrolled devices
  • Mit EMM registrierte Geräte von DrittanbieternThird-party EMM-enrolled devices
  • Nicht verwaltete (bei keiner MDM-Lösung registrierte) GeräteUnmanaged devices (not enrolled with any MDM)

Xamarin-Apps, die mit der Intune App SDK Xamarin-Komponente erstellt wurden, können jetzt sowohl auf registrierten als auch auf nicht registrierten Geräten mit mobiler Intune-Geräteverwaltung (Mobile Device Management, MDM) Intune-App-Schutzrichtlinien empfangen.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.

VoraussetzungenPrerequisites

  • [Nur Android] Die aktuelle Microsoft Intune-Unternehmensportal-App muss auf dem Gerät installiert sein.[Android only] The latest Microsoft Intune Company Portal app must be installed on the device.

Erste SchritteGet started

  1. Laden Sie hier die Xamarin-component.exe herunter, und extrahieren Sie diese.Download Xamarin-component.exe from here and extract it.

  2. Lesen Sie die Lizenzbedingungen für die Microsoft Intune MAM-Xamarin-Komponente.Read the license terms for the Microsoft Intune MAM Xamarin Component.

  3. Laden Sie den Intune App SDK-Xamarin-Komponentenordner aus GitHub oder Xamarin herunter, und extrahieren Sie diesen.Download the Intune App SDK Xamarin Component folder from GitHub or Xamarin and extract it. Die beiden in Schritt 1 und Schritt 3 heruntergeladenen Dateien müssen sich auf derselben Verzeichnisebene befinden.Both files downloaded from step 1 and step 3 should be in the same directory level.

  4. Führen Sie Xamarin.Component.exe install <.xam> file in der Befehlszeile als Administrator aus.In the command line as an administrator, run Xamarin.Component.exe install <.xam> file.

  5. Klicken Sie in Visual Studio mit der rechten Maustaste in Ihrem zuvor erstellten Xamarin-Projekt auf Komponenten.In Visual Studio, right-click components in your previously created Xamarin project.

  6. Wählen Sie Komponenten bearbeiten aus, und fügen Sie die Intune App SDK-Komponente hinzu, die Sie lokal auf Ihren Computer heruntergeladen haben.Select Edit Components and add the Intune App SDK component you’ve downloaded locally to your computer.

Aktivieren der Intune-App-Schutzrichtlinien in Ihrer mobilen iOS-AppEnabling Intune app protection polices in your iOS mobile app

  1. Um das Intune App SDK zu starten, müssen Sie eine beliebige API der AppDelegate.cs-Klasse aufrufen.In order to initialize the Intune App SDK, you need to make a call for any API in the AppDelegate.cs class. Beispiel:For example:

    public override bool FinishedLaunching (UIApplication application, NSDictionary launchOptions)
    {
          Console.WriteLine ("Is Managed: {0}", IntuneMAMPolicyManager.Instance.PrimaryUser != null);
          return true;
    }
    
  2. Nachdem die Komponente hinzugefügt und gestartet wurde, können die allgemeinen Schritte ausgeführt werden, die zum Einrichten der App-SDK in der mobilen iOS-Anwendung notwendig sind.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. Die kompletten Unterlagen zur Aktivierung nativer iOS-Apps finden Sie unter Microsoft Intune App SDK für iOS – Entwicklerhandbuch.You can find the full documentation for enabling native iOS apps in the Intune App SDK for iOS Developer Guide.

  3. Wichtig: Es gibt verschiedene Modifikationen, die spezifisch für Xamarin-basierte iOS-Apps sind.Important: There are several modifications specific to Xamarin-based iOS apps. Wenn beispielsweise Schlüsselbundgruppen aktiviert werden, muss Folgendes hinzugefügt werden, um die Xamarin-Beispiel-App zu integrieren, die von uns in die Komponente integriert wurde.For instance, when enabling keychain groups, you need to add the following to include the Xamarin sample app we included in the component. Nachstehend finden Sie das Beispiel einer Gruppe, die Sie in Ihren Schlüsselbund-Zugriffsgruppen benötigen: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>
    

Sie haben die notwendigen Schritte ausgeführt um die Komponente in Ihrer Xamarin-basierten iOS-App einzurichten.You have completed the steps necessary to build the component into your Xamarin-based iOS app. Wenn Sie XCode zur Projekterstellung verwenden, können Sie Intune App SDK Settings.bundle verwenden.If you are utilizing Xcode for building your project, you can use the Intune App SDK Settings.bundle. So können Sie die Intune-Richtlinieneinstellungen ein- und ausschalten, während Sie Ihr Projekt zum Testen und Debuggen erstellen.This allows you to toggle Intune policy settings on and off as you build your project to test and debug. Um das Paket bestmöglich zu nutzen, folgen Sie den Schritten im Intune App SDK für iOS – Entwicklerhandbuch und lesen Sie den Abschnitt zu Debuggen 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.

Aktivieren der App-Schutzrichtlinien in Ihrer mobilen Android-AppEnabling app protection policies in your Android mobile app

Für Xamarin-basierte Android-Apps, die kein Benutzeroberflächenframework verwenden, lesen und befolgen Sie das Entwicklerhandbuch zum Microsoft Intune App SDK für 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. Für Xamarin-basierte Android-Apps müssen die Klasse, Methoden und Aktivitäten basierend auf der im Handbuch enthaltenen Tabelle durch das MAM-Äquivalent ersetzt werden.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. Wenn Ihre App keine android.app.Application-Klasse definiert, müssen Sie eine erstellen. Es muss sichergestellt werden, dass Sie von MAMApplication erben.If your app doesn’t define an android.app.Application class, you need to create one and ensure that you inherit from MAMApplication.

Für Xamarin.Forms und andere UI-Frameworks haben wir ein Tool bereit gestellt. Es heißt MAM.Remapper.For Xamarin Forms and other UI frameworks, we have provided a tool called MAM.Remapper. Das Tool nimmt den Klassentausch für Sie vor.The tool accomplishes the class replacement for you. Folgende Schritte müssen Sie jedoch selbst durchführen:However, you need to do the following steps:

  1. Fügen Sie der Version 0.1.0.0 oder höher des Microsoft.Intune.MAM.Remapper.Tasks-NuGet-Pakets einen Verweis hinzu.Add a reference to the Microsoft.Intune.MAM.Remapper.Tasks NuGet package version 0.1.0.0 or greater.

  2. Fügen Sie Ihrer CSPROJ-Datei von Android die folgende Zeile hinzu: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. Legen Sie die Buildaktion der hinzugefügten remapping-config.json-Datei mit RemappingConfigFile fest.Set the build action of the added remapping-config.json file to RemappingConfigFile. Die integrierte remapping-config.json-Datei funktioniert nur mit Xamarin.Forms.The included remapping-config.json only works with Xamarin.Forms. Greifen Sie für andere Benutzeroberflächenframeworks auf das Readme im Remapper-NuGet-Paket zurück.For other UI frameworks, refer to the Readme included with the Remapper NuGet package.

Nächste SchritteNext steps

Sie haben die grundlegenden Schritte zum Erstellen der Komponente auf Ihrer App abgeschlossen.You have completed the basic steps of building the component into your app. Jetzt können die Schritte ausgeführt werden, die in der Xamarin Android-Beispiel-App zu finden sind.Now you can follow the steps included in the Xamarin Android sample app. Wir haben zwei Beispiele bereit gestellt, eine für Xamarin.Forms und eine weitere für Android.We have provided two samples, one for Xamarin.Forms and another for Android.