Android-Setup

  • Artikel

Wichtig

Versionen des Microsoft Rights Management Service SDK, das vor März 2020 veröffentlicht wurde, sind veraltet; Anwendungen, die frühere Versionen verwenden, müssen aktualisiert werden, um die Version vom März 2020 zu verwenden. Ausführliche Informationen finden Sie in der Veraltetkeitshinweis.

Für das Microsoft Rights Management Service SDK sind keine weiteren Verbesserungen geplant. Wir empfehlen dringend die Einführung des Microsoft Information Protection SDK für Klassifizierung, Bezeichnung und Schutzdienste.

Android-Apps können das Microsoft Rights Management SDK 4.2 verwenden, um den integrierten Datenschutz in der Anwendung mithilfe von Azure Active Directory Rights Management (AAD RM) zu aktivieren.

Dieses Thema führt Sie durch das Einrichten der Umgebung zum Erstellen eigener neuer Apps.

Voraussetzungen

Die folgende Software wird auf Ihrem Entwicklungssystem empfohlen:

  • Betriebssystem Windows oder OS X zum Ausführen der Eclipse-Entwicklungsumgebung.

  • In diesem Handbuch wird davon ausgegangen, dass Sie das Eclipse-SDK ab Eclipse Juno 4.2 und eine Standardinstallation verwenden.

  • Java ab Java 1.6.

  • Android Developer Tools (ADT)-Plug-In. Hinweis – Sie werden unter Umständen aufgefordert, Eclipse zum Abschließen der Installation neu zu starten.

  • Das MS RMS SDK 4.2-Paket für Android. Weitere Informationen finden Sie unter "Erste Schritte".

    Dieses SDK kann zur Anwendungsentwicklung für Android 4.0.3 (API-Ebene 15) und höher eingesetzt werden.

  • Authentifizierungsbibliothek: Wir empfehlen die Verwendung der Azure AD-Authentifizierungsbibliothek (ADAL). Es können jedoch auch andere Authentifizierungsbibliotheken verwendet werden, die OAuth 2.0 unterstützen.

    Weitere Informationen finden Sie unter ADAL für Android.

    Hinweis Wenn Ihre Anwendung die ADAL-Bibliothek nicht als OAuth 2.0-Authentifizierungsbibliothek verwendet, sollten Sie diese Android-Anleitung, einige SichereRandom-Gedanken, überprüfen.

Optional

Unsere UI-Bibliothek bietet Entwicklern, die keine eigene benutzerdefinierte UI erstellen möchten, eine wiederverwendbare UI zur Nutzung und zum Schutz. Nutzen Sie die UI-Bibliothek und Beispiel-App für Android.

Konfigurieren der Entwicklungsumgebung

Hinweis MS RMS SDK 4.2 Preview Release: In dieser Vorschauversion wurden die Screenshots nicht aktualisiert, um die Änderung des Namens der Pfade von com/microsoft/protection in com/microsoft/rightsmanagment anzuzeigen. Der Text wurde allerdings aktualisiert.

  • Öffnen Sie die Eclipse-Entwicklungsumgebung.

  • Um ein neues Android-Anwendungsprojekt zu erstellen, klicken Sie im Menü File auf New, klicken Sie auf Project, und wählen Sie dann Android Application Project aus.

    Erstellen einer neuen Android-Anwendung

  • Geben Sie den Anwendungsnamen ein. Projektname und Paketname werden auf der Grundlage des Anwendungsnamens eingetragen.

  • Klicken Sie auf Weiter, und wählen Sie aus, wo der Arbeitsbereich erstellt werden soll.

    Geben Sie den Anwendungsnamen ein.

  • Klicken Sie auf Next, und wählen Sie ein Symbol für Ihre App aus.

    Auswählen eines Symbols für Ihre App

  • Klicken Sie auf Next, und wählen Sie Blank Activity aus, um die Aktivität zu erstellen.

    Erstellen der Aktivität

  • Klicken Sie auf Next, und geben Sie einen Namen für die Aktivität ein. Sie können MainActivity als Standardnamen mit einem Layoutnamen von activity_main verlassen.

    Angeben eines Namens für die Aktivität

  • Klicken Sie auf Fertig stellen.

    Beenden der Erstellung

  • Das Projekt wurde zusammen mit der Hauptaktivitätsklasse MainActivity.java erstellt.

Verweisen auf das SDK

  • Navigieren Sie zu dem Ordner, in dem Sie die adrms_android_sdk.zipextrahiert haben. Stellen Sie im Ordner "SDK > com > microsoft > rightsmanagement" sicher, dass die Dateien .classpath, . project und project.properties nicht als schreibgeschützt gekennzeichnet sind.

  • Um auf das SDK zu verweisen, müssen Sie das SDK in den Arbeitsbereich importieren.

    Klicken Sie in Eclipse auf File. Klicken Sie im Menü Datei auf Importieren. Wählen Sie im Dialogfeld Import die Option Android / Existing Android Code into Workspace aus.

    Importieren in den Arbeitsbereich

  • Klicken Sie auf Weiter. Navigieren Sie, um den Ordner auszuwählen, in dem Sie die adrms_android_sdk.zipextrahiert haben. Das SDK sollte angezeigt werden, in der Liste als com.microsoft.rightsmanagement angezeigt werden.

    Navigieren zum Auswählen des Ordners

  • Wenn Sie auf Finish klicken, wird das SDK-Projekt als gleichgeordnetes Element der zuvor erstellten Anwendung angezeigt.

    Das SDK-Projekt wird als Ihrer Anwendung gleichgeordnet angezeigt

  • Klicken Sie mit der rechten Maustaste auf das Symbol Project, und zeigen Sie die Eigenschaften für das Projekt an.

  • Navigieren Sie zu der Registerkarte Android.

  • Klicken Sie auf Add, und wählen Sie dann die Bibliothek com.microsoft.rightsmanagement im Arbeitsbereich aus.

    Hinzufügen der Bibliothek

  • Klicken Sie auf OK.

    Da das MS RMS SDK 4.2 eine Verbindung mit AAD RM herstellt, muss die Anwendung dem INTERNET und ACCESS_NETWORK_STATE gewährt werden. Öffnen Sie dazu die Datei AndroidManifest.xml im Stammverzeichnis des Projekts.

    Um die Berechtigungen hinzuzufügen, klicken Sie auf Add und wählen dann Uses Permissions.

    Hinzufügen von Berechtigungen

  • Sie können diesen Schritt überprüfen, indem Sie das Manifest in der Text-Editor-Ansicht anzeigen. Vergewissern Sie sich, dass die folgenden Zeilen angezeigt werden:

    <uses-sdk
     android:minSdkVersion="15"
     android:targetSdkVersion="19"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission/>

Hinweis Das SDK verwendet das android.support.v4

  • Sie können jetzt Ihre eigenen neuen Android-Apps erstellen.

Weitere Informationen

Erste Schritte

Begriffe und Konzepte für Entwickler

Android-API-Referenz