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.

Sie werden feststellen, dass Sie die meisten SDK-Funktionen aktivieren können, ohne das Verhalten Ihrer App zu ändern.You will find that you can enable SDK features without changing your app’s behavior. Sobald Sie die Komponente auf Ihrer mobilen App auf iOS oder Android erstellt haben, kann der IT-Administrator über die mobile Anwendungsverwaltung in Microsoft Intune (Mobile Application Management, MAM) Richtlinien bereitstellen, die eine Vielzahl von Datenschutzfunktionen unterstützten.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.

Was wird unterstützt?What's supported?

EntwicklercomputerDeveloper machines

  • WindowsWindows

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 Intune App SDK-Xamarin-Komponenten erstellt wurden, können jetzt sowohl auf Geräten mit Intune Mobilgeräteverwaltung (MDM) als auch auf nicht registrierten Geräten Intune-Richtlinien des mobilen Anwendungsmanagements (MAM) empfangen.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.

VoraussetzungenPrerequisites

  • [Nur Android] Es muss immer die aktuellste Microsoft Intune-Unternehmensportal-App auf dem Gerät installiert sein.[Android only] The latest Microsoft Intune Company Portal app must always 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 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 von Intune MAM auf Ihrer mobilen iOS-AppEnabling Intune MAM 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 will 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, die von uns in die Komponente integriert wurde, zu integrieren.For instance, when enabling keychain groups, you'll 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 will allow 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 von MAM in Ihrer mobilen Android-AppEnabling MAM in your Android mobile app

Für Xamarin-basierte Android-Apps, die kein UI-Framework verwenden, lesen und befolgen Sie das [Intune App SDK für Android – Entwicklerhandbuch].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]. Für Xamarin-basierte Android-Apps müssen die Klasse, Methoden und Aktivitäten mit dem MAM-Äquivalent ersetzt werden, das auf der Tabelle basiert und im Handbuch zu finden ist.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. 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 will 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 wird für Sie den Klassentausch vornehmen.The tool will accomplish the class replacement for you. Folgende Schritte müssen dennoch durchgeführt werden:However, you will 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 theMicrosoft.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 UI-Frameworks auf das Readme im Remapper-NuGet-Paket zurück.For other UI frameworks, refer to the Readme included with the Remapper nuget package.

Testen Ihrer AppTest your app

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.

Um Feedback zu einem Produkt zu geben, besuchen Sie folgende Seite Intune Feedback