Erste Schritte mit dem Microsoft Intune App SDKGet started with the Microsoft Intune App SDK

Dieser Leitfaden unterstützt Sie dabei, Ihre mobile App schnell für App-Schutzrichtlinien mit Microsoft Intune einzurichten.This guide will help you quickly enable your mobile app for app protection policies with Microsoft Intune. Unter Umständen ist es ratsam, sich zuerst in der Übersicht über das Intune App SDK mit den Vorteilen des Intune App SDK vertraut machen.You may find it useful to first understand the benefits of the Intune App SDK, as explained in the Intune App SDK overview.

Das Intune App SDK unterstützt ähnliche Szenarien auf ios- und Android-Plattformen und bietet dem IT-Administrator eine plattformübergreifend konsistente Umgebung.The Intune App SDK supports similar scenarios across iOS and Android, and is intended to create a consistent experience across the platforms for IT admins. Bei der Unterstützung bestimmter Funktionen gibt es jedoch geringfügige Unterschiede, die auf Einschränkungen der jeweiligen Plattform zurückzuführen sind.But there are small differences in the support of certain features, because of platform limitations.

Registrieren Ihrer Store-App bei MicrosoftRegister your store app with Microsoft

Wenn Ihre App für Ihre Organisation intern ist und nicht öffentlich verfügbar sein wird:If your app is internal to your organization and will not be publicly available:

Dann muss die App nicht registriert werden.You do not need to register your app. Branchenspezifische Apps werden vom IT-Administrator intern bereitgestellt.For internal line-of-business apps, the IT administrator will deploy the app internally. Intune erkennt, dass die App mit dem SDK erstellt wurde, und ermöglicht dem IT-Administrator das Anwenden von App-Schutzrichtlinien auf die App.Intune will detect that the app has been built with the SDK, and will let the IT administrator apply app protection policy to it. Sie können zum Abschnitt Aktivieren Ihrer iOS- oder Android-App für die App-Schutzrichtlinie wechseln.You can skip to the section Enable your iOS or Android app for app protection policy.

Wenn Ihre App in einem öffentlichen App Store (z.B. Apple App Store oder Google Play) freigegeben wird, gilt Folgendes:If your app will be released to a public app store, like the Apple App Store or Google Play:

Sie müssen Ihre App zuerst bei Microsoft Intune registrieren und den Registrierungsbedingungen zustimmen.You must first register your app with Microsoft Intune and agree to the registration terms. Danach können IT-Administratoren die App-Schutzrichtlinie auf die entsprechend aktivierte App anwenden, die als Intune-Partner-App aufgelistet wird.IT administrators can then apply app protection policy to the enlightened app, which will be listed as an Intune app partner.

Solange die Registrierung nicht abgeschlossen ist und vom Microsoft Intune-Team bestätigt wurde, können Intune-Administratoren dem Deep-Link der App keine App-Schutzrichtlinie zuweisen.Until registration has been finished and confirmed by the Microsoft Intune team, Intune administrators will not have the option to apply app protection policy to your app's deep link. Microsoft fügt Ihre App auch zur Seite der Microsoft Intune-Partner hinzu.Microsoft will also add your app to its Microsoft Intune Partners page. Dort wird das Symbol der App angezeigt, um anzugeben, dass sie die App-Schutzrichtlinien von Intune unterstützt.There, the app's icon will be displayed to show that it supports Intune app protection policies.

Zu Beginn des Registrierungsvorgangs müssen Sie den Fragebogen für Microsoft Intune-App-Partner ausfüllen.To begin the registration process, fill out the Microsoft Intune App Partner Questionnaire.

Die auf dem ausgefüllten Fragebogen angegebenen E-Mail-Adressen werden verwendet, um sich mit Ihnen in Verbindung zu setzen und damit den Registrierungsprozess fortzusetzen.We will use the email addresses listed in your questionnaire response to reach out and continue the registration process. Über diese E-Mail-Adresse nehmen wir bei Fragen oder Problemen auch Kontakt mit Ihnen auf.Additionally, we use your registration email address to contact you if we have any concerns.

Hinweis

Alle Daten, die in diesem Fragebogen oder in der E-Mail-Korrespondenz mit dem Microsoft Intune-Team erfasst werden, unterliegen der Microsoft-Datenschutzrichtlinie.All information collected in the questionnaire and through email correspondence with the Microsoft Intune team will honor the Microsoft Privacy Statement.

Informationen zum Registrierungsvorgang:What to expect in the registration process:

  1. Nachdem Sie den Fragebogen gesendet haben, setzen wir uns über die dort angegebene E-Mail-Adresse mit Ihnen in Verbindung, um den erfolgreichen Eingang zu bestätigen oder zusätzliche Informationen anzufordern, damit die Registrierung abgeschlossen werden kann.After you have submitted the questionnaire, we will contact you via your registration email address, to either confirm successful receipt or request additional information to finish the registration.

  2. Nachdem wir alle erforderlichen Informationen von Ihnen erhalten haben, senden wir Ihnen die Vereinbarung für Microsoft Intune-App-Partner zum Unterschreiben zu.After we receive all necessary information from you, we will send you the Microsoft Intune App Partner Agreement to sign. Diese Vereinbarung enthält die Bedingungen, denen Ihr Unternehmen zustimmen muss, bevor es Microsoft Intune-App-Partner werden kann.This agreement describes the terms that your company must accept before it becomes a Microsoft Intune app partner.

  3. Sie werden ebenso benachrichtigt, wenn Ihre App erfolgreich beim Microsoft Intune-Dienst registriert wurde und auf der Microsoft Intune-Partnerwebsite empfohlen wird.You will be notified when your app is successfully registered with the Microsoft Intune service and when your app is featured on the Microsoft Intune partners site.

  4. Schließlich wird der Deep-Link Ihrer App zum nächsten monatlichen Intune-Dienstupdate hinzugefügt.Finally, your app's deep link will be added to the next monthly Intune Service update. Wenn die Registrierung mit allen Informationen beispielsweise im Juli abgeschlossen ist, wird der Deep-Link ab Mitte August unterstützt.For example, if the registration information is finished in July, the deep link will be supported in mid-August.

Wenn sich der Deep-Link Ihrer App zu einem späteren Zeitpunkt ändert, müssen Sie Ihre App neu registrieren.If your app's deep link changes in the future, you will need to re-register your app.

Hinweis

Außerdem müssen Sie uns informieren, wenn Sie Ihre App mit einer neuen Intune App SDK-Version aktualisieren.Please inform us if you update your app with a new version of the Intune App SDK.

Herunterladen der SDK-DateienDownload the SDK files

Die Intune App SDKs für natives iOS und Android werden auf einem Microsoft-GitHub-Konto gehostet.The Intune App SDKs for native iOS and Android are hosted on a Microsoft GitHub account. Die folgenden öffentlichen Repositorys enthalten die SDK-Dateien für natives iOS und Android:These public repositories have the SDK files for native iOS and Android, respectively:

Wenn Ihre App eine Xamarin- oder Cordova-App ist, verwenden Sie diese SDK-Varianten:If your app is a Xamarin or Cordova app, please use these SDK variants:

Es wird empfohlen, sich für ein GitHub-Konto zu registrieren, mit dem Sie Fork- und Pullfunktionen für unsere Repositorys verwenden können.It's a good idea to sign up for a GitHub account that you can use to fork and pull from our repositories. GitHub bietet Entwicklern die Möglichkeit, mit unserem Produktteam zu kommunizieren, Probleme zu melden und schnelle Antworten zu erhalten, Versionshinweise anzuzeigen und Feedback an Microsoft zu senden.GitHub lets developers communicate with our product team, open issues and receive quick responses, view release notes, and provide feedback to Microsoft. Bei Fragen zu Intune App SDK GitHub wenden Sie sich an msintuneappsdk@microsoft.com.For questions on the Intune App SDK GitHub, contact msintuneappsdk@microsoft.com.

Aktivieren Ihrer iOS- oder Android-App für die App-SchutzrichtlinieEnable your iOS or Android app for app protection policy

Sie benötigen einen der folgenden Entwicklerleitfäden zum Integrieren des Intune App SDK in Ihre App:You will need one of the following developer guides to help you integrate the Intune App SDK into your app:

Aktivieren Ihrer iOS- oder Android-App für den App-basierten bedingten ZugriffEnable your iOS or Android app for app based conditional access

Folgendes ist zusätzlich zum Aktivieren Ihrer App für die App-Schutzrichtlinie erforderlich, damit diese ordnungsgemäß mit dem auf der AAD-App (Azure ActiveDirectory) basierenden bedingten Zugriff funktioniert.In addition to enabling your app for app protection policy, the following is required for your app to properly function with Azure ActiveDirectory (AAD) app based conditional access:

Konfigurieren der Telemetrie für Ihre AppConfigure Telemetry for your app

Microsoft Intune sammelt Daten zu Nutzungsstatistiken für Ihre App.Microsoft Intune collects data on usage statistics for your app.

  • Intune App SDK für iOS: Das SDK protokolliert standardmäßig SDK-Telemetriedaten zu Verwendungsereignissen.Intune App SDK for iOS: The SDK logs SDK telemetry data on usage events by default. Diese Daten werden an Microsoft Intune gesendet.This data is sent to Microsoft Intune.

    • Wenn von Ihrer App keine SDK-Telemetriedaten an Microsoft Intune gesendet werden sollen, müssen Sie die Telemetrieübertragung deaktivieren, indem Sie im Wörterbuch „IntuneMAMSettings“ die Eigenschaft MAMTelemetryDisabled auf„JA“ festlegen.If you choose not to send SDK telemetry data to Microsoft Intune from your app, you must disable telemetry transmission by setting the property MAMTelemetryDisabled to "YES" in the IntuneMAMSettings dictionary.
  • Intune App SDK für Android: Vom SDK werden keine Telemetriedaten protokolliert.Intune App SDK for Android: Telemetry data is not logged through the SDK.

    Die branchenspezifische App-Versionsnummer für iOS und Android ist sichtbar .iOS and Android line-of-business app version number is visible

Branchenspezifische App-VersionsnummernLine-of-business app version numbers

Branchenspezifische Apps in Intune zeigen nun die Versionsnummer für iOS- und Android-Apps an.Line-of-business apps in Intune now display the version number for iOS and Android apps. Die Nummer wird im Azure-Portal in der App-Liste und im Übersichtsblatt der App angezeigt.The number displays in the Azure portal in the app list and in the app overview blade. Benutzer können die App-Nummer in der Unternehmensportal-App und im Webportal anzeigen.End users can see the app number in the Company Portal app and in the web portal.

Vollständige VersionsnummerFull version number

Die vollständige Versionsnummer identifiziert ein bestimmtes Release der App.The full version number identifies a specific release of the app. Die Nummer wird als Version(Build) angezeigt.The number appears as Version(Build). Beispielsweise 2.2(2.2.17560800)For example, 2.2(2.2.17560800)

Die vollständige Versionsnummer besteht aus zwei Komponenten:The full version number has two components:

  • VersionVersion
    Die Versionsnummer ist die von einem Menschen lesbare Releasenummer der App.The version number is the human-readable release number of the app. Diese wird von Benutzern verwendet, um verschiedene Releases der App zu identifizieren.This is used by end users to identify different releases of the app.

  • BuildnummerBuild Number
    Die Buildnummer ist eine interne Nummer, die in der App-Erkennung und zur programmgesteuerten Verwaltung der App verwendet werden kann.The build number is an internal number that can be used in app detection and to programmatically manage the app. Die Buildnummer bezieht sich auf eine Iteration der App, die auf Änderungen im Code verweist.The build number refers to an iteration of the app that references changes in the code.

Versions- und Buildnummer unter Android und iOSVersion and build number in Android and iOS

Android und iOS verwenden Versions- und Buildnummern, um auf Apps zu verweisen.Android and iOS both use version and build numbers in reference to apps. Beide Betriebssysteme verwenden jedoch betriebssystemspezifische Begriffe.However, both operating systems have meanings that are OS-specific. In der folgenden Tabelle wird erklärt, wie diese Begriffe zueinander in Bezug stehen.The following table explains how these terms are related.

Wenn Sie eine branchenspezifische Apps für die Verwendung in Intune entwickeln, denken Sie daran, die Versions- und die Buildnummer zu verwenden.When you are developing a line-of-business application for use in Intune, remember to use both the version and the build number. Die Intune-Features für die App-Verwaltung sind abhängig von einer aussagekräftigen CFBundleVersion (für iOS) und einem aussagekräftigen PackageVersionCode (für Android).Intune App management features rely on a meaningful CFBundleVersion (for iOS) and PackageVersionCode (for Android). Diese Nummern sind im App-Manifest enthalten.These numbers are included in the app manifest.

IntuneIntune iOSiOS AndroidAndroid BeschreibungDescription
VersionsnummerVersion number CFBundleShortVersionStringCFBundleShortVersionString PackageVersionNamePackageVersionName Diese Nummer gibt ein bestimmtes Release der App für Benutzer an.This number indicates a specific release of the app for end users.
BuildnummerBuild number CFBundleVersionCFBundleVersion PackageVersionCodePackageVersionCode Diese Nummer gibt eine Iteration im App-Code an.This number is used to indicate an iteration in the app code.

iOSiOS

  • CFBundleShortVersionStringCFBundleShortVersionString
    Gibt die Nummer der Releaseversion des Pakets an.Specifies the release version number of the bundle. Diese Nummer gibt eine veröffentlichte Version der App an.This number identifies a released version of the app. Die Nummer wird von Benutzern verwendet, um auf die App zu verweisen.The number is used by end users to reference the app.
    • CFBundleVersionCFBundleVersion
      Die Buildversion des Pakets, die eine Iteration desselben angibt.The build version of the bundle, which identifies an iteration of the bundle. Die Nummer kann verwendet werden, um ein Release oder ein nicht veröffentlichtes Paket zu identifizieren.The number may be identify a release or unreleased bundle. Die Nummer wird für die App-Erkennung verwendet.The number is used for app detection.

AndroidAndroid

  • PackageVersionNamePackageVersionName
    Die Versionsnummer, die Benutzern angezeigt wird.The version number shown to users. Dieses Attribut kann als Rohzeichenfolge oder als Verweis auf eine Zeichenfolgenressource festgelegt werden.This attribute can be set as a raw string or as a reference to a string resource. Die Zeichenfolge dient lediglich dem Zweck, Benutzern angezeigt zu werden.The string has no other purpose than to be displayed to users.
  • PackageVersionCodePackageVersionCode
    Eine interne Versionsnummer.An internal version number. Diese Nummer wird lediglich verwendet, um zu bestimmen, ob eine Version aktueller als eine andere ist. Eine höhere Nummer gibt dabei eine aktuellere Version an.This number is used only to determine whether one version is more recent than another, with higher numbers indicating more recent versions. Dies ist nicht die Version.This is not the version

Nächste Schritte nach der IntegrationNext steps after integration

Testen Ihrer AppTest your app

Nachdem Sie die notwendigen Schritte zur Integration des Intune App SDK in Ihre iOS- oder Android-App abgeschlossen haben, müssen Sie sicherstellen, dass alle App-Schutzrichtlinien für den Benutzer und den IT-Administrator aktiviert und funktionsfähig sind. Zum Testen Ihrer integrierten App benötigen Sie Folgendes:After you finish the necessary steps to integrate your iOS or Android app with the Intune App SDK, you will need to ensure that all the app protection policies are enabled and functioning for the user and the IT admin. To test your integrated app, you will need the following:

  • Microsoft Intune-Testkonto: Um Ihre für Intune aktivierte App und die Intune-App-Schutzfunktionen zu testen, benötigen Sie ein Microsoft Intune-Konto.Microsoft Intune test account: To test your Intune-enlightened app against Intune app protection features, you will need a Microsoft Intune account.

    • ISVs, die ihre iOS- oder Android-Store-Apps für die Intune-App-Schutzrichtlinie aktivieren, erhalten nach Abschluss der Registrierung bei Microsoft Intune (wie im Registrierungsschritt beschrieben) einen Angebotscode.If you are an ISV enabling your iOS or Android store apps for Intune app protection policy, you will receive a promo code after you finish the registration with Microsoft Intune, as outlined in the registration step. Mit diesem Angebotscode können Sie sich für eine Microsoft Intune-Testversion mit einem Jahr erweiterter Nutzung anmelden.The promo code will let you sign up for a Microsoft Intune trial for one year of extended use.

    • Wenn Sie eine branchenspezifische App entwickeln, die nicht in den Store übertragen wird, sollten Sie über Ihre Organisation auf Microsoft Intune zugreifen können.If you are developing a line-of-business app that will not be shipped to the store, you are expected to have access to Microsoft Intune through your organization. Sie können sich auch bei Microsoft Intune für eine kostenlose einmonatige Testversion registrieren.You can also sign up for a one-month free trial in Microsoft Intune.

  • Intune-App-Schutzrichtlinien: Um Ihre App für alle Intune-App-Schutzrichtlinien zu testen, müssen Sie das erwartete Verhalten bei jeder Richtlinieneinstellung kennen.Intune app protection policies: To test your app against all the Intune app protection policies, you should know what the expected behavior is for each policy setting. Siehe die Beschreibungen der iOS-App-Schutzrichtlinien und Android-App-Schutzrichtlinien.See the descriptions for iOS app protection policies and Android app protection policies.

  • Problembehandlung: Wenn Sie beim manuellen Testen der Benutzerumgebung Ihrer App auf Probleme stoßen, lesen Sie den Artikel zur Problembehandlung von MAM.Troubleshoot: If you run into any issues while manually testing your app's user experience, check out the Troubleshooting MAM. Dieser Artikel bietet Hilfe für gängige Probleme, Dialogfelder und Fehlermeldungen, die in Intune-fähigen Apps auftreten können.This article offers help for common issues, dialogs, and error messages that may be experienced in Intune-enlightened apps.

Anzeigen eines Badges auf Ihrem App-Symbol (optional)Badge your app (optional)

Nachdem Sie bestätigt haben, dass Ihre Intune-App-Schutzrichtlinien in Ihrer App funktionieren, können Sie Ihr App-Symbol mit einem Badge in Form des Intune-App-Schutzlogos versehen.After validating that Intune app protection policies work in your app, you can badge your app icon with the Intune app protection logo.

Dieses Badge informiert IT-Administratoren, Endbenutzer und potenzielle Intune-Kunden, das Ihre App mit Intune-App-Schutzrichtlinien funktioniert.This badge indicates to IT administrators, end-users, and potential Intune customers that your app works with Intune app protection policies. Es fördert die Verwendung und Akzeptanz Ihrer App bei Intune-Kunden.It encourages the usage and adoption of your app by Intune customers.

Das Badge ist ein Aktentaschensymbol (siehe die folgenden Beispiele):The badge is a briefcase icon and can be seen in the samples below:

Badge-Beispiel 1 Badge-Beispiel 2

Voraussetzungen für das Versehen Ihrer App mit einem Badge:What you'll need to badge your app: