Configuration pour AndroidAndroid setup

Important

Les versions du kit de développement logiciel (SDK) Microsoft Rights Management service antérieures au 2020 mars sont dépréciées. les applications qui utilisent des versions antérieures doivent être mises à jour pour utiliser la version de mars 2020.Versions of the Microsoft Rights Management Service SDK released prior to March 2020 are deprecated; applications using earlier versions must be updated to use the March 2020 release. Pour plus d’informations, consultez l' avis de désapprobation.For full details, see the deprecation notice.

Aucune autre amélioration n’est prévue pour le kit de développement logiciel (SDK) du service Microsoft Rights Management.No further enhancements are planned for the Microsoft Rights Management Service SDK. Nous vous recommandons vivement d’adopter le Kit de développement logiciel (SDK) Microsoft information protection pour les services de classification, d’étiquetage et de protection.We strongly recommend adoption of the Microsoft Information Protection SDK for classification, labeling, and protection services.

Les applications Android peuvent utiliser Microsoft Rights Management SDK 4.2 pour activer la protection intégrée des informations en utilisant Azure Active Directory Rights Management (AAD RM).Android applications can use the Microsoft Rights Management SDK 4.2 to enable integrated information protection in their applications by using Azure Active Directory Rights Management (AAD RM ).

Cette rubrique explique comment configurer votre environnement pour créer vos propres applications.This topic will guide you through setting up your environment for creating your own new apps .

PrérequisPrerequisites

Nous vous recommandons de disposer des logiciels suivants sur votre système de développement :We recommend the following software on your development system:

  • Système d’exploitation Windows ou OS X pour exécuter l’environnement de développement Eclipse.Windows or OS X operating system to run the Eclipse development environment.

  • Ce guide suppose que vous utilisez le SDK Eclipse à partir d’Eclipse Juno 4.2 et avec une installation par défaut.This guide assumes that you are using the Eclipse SDK beginning with Eclipse Juno 4.2 and using a default installation.

  • Java à partir de Java 1.6.Java starting with Java 1.6.

  • Plug-in Outils ADT (Android Developer Tools).Android Developer Tools (ADT) Plugin. REMARQUE : Vous devrez peut-être redémarrer Eclipse pour terminer l’installation.NOTE - You might be asked to restart Eclipse to complete the installation.

  • Package MS RMS SDK 4.2 pour Android.The MS RMS SDK 4.2 package for Android. Pour plus d’informations, consultez prise en main.For more information see, Get started.

    Ce SDK peut être utilisé pour développer pour Android 4.0.3 (API niveau 15) et ultérieur.This SDK can be used to develop for Android 4.0.3 (API level 15) and later.

  • Bibliothèque d’authentification : nous vous recommandons d’utiliser la bibliothèque ADAL (Azure AD Authentication Library).Authentication library: We recommend that you use the Azure AD Authentication Library (ADAL). Toutefois, vous pouvez aussi utiliser d’autres bibliothèques d’authentification qui prennent en charge OAuth 2.0.However, other authentication libraries that support OAuth 2.0 can be used as well.

    Pour plus d’informations, consultez ADAL pour AndroidFor more information see, ADAL for Android

    Remarque :  si votre application n’utilise pas la bibliothèque Adal comme bibliothèque d’authentification OAuth 2,0, vous devez consulter cette aide Android, quelques réflexions SecureRandom.Note  If your application will not be using the ADAL Library as the OAuth 2.0 authentication library, you should review this Android guidance, Some SecureRandom Thoughts.

Lisez la rubrique Nouveautés pour obtenir des informations sur les mises à jour des API, les notes de publication et les questions les plus fréquentes (FAQ).Read the What's new topic for information about API updates, release notes, and frequently asked questions (FAQ).

FacultatifOptional

Notre bibliothèque d’interface utilisateur fournit une interface utilisateur réutilisable pour les opérations de protection et de consommation pour les développeurs qui ne veulent pas créer leur propre interface utilisateur personnalisée : Bibliothèque d’interface utilisateur et exemple d’application pour Android.Our UI library provides re-usable UI for consumption and protection operations for developers who don’t want to create their own custom UI - UI Library and Sample app for Android.

Configuration de votre environnement de développementConfiguring your development environment

Notez  la version préliminaire de MS Kit de développement logiciel (SDK) RMS 4,2 : dans cette version préliminaire, les captures d’écran n’ont pas été mises à jour pour afficher la modification du nom des chemins d’accès de com/Microsoft/protection à com/Microsoft/rightsmanagment.Note  MS RMS SDK 4.2 Preview Release: In this preview release, the screen shots have not been updated to show the change in name of the pathes from com/microsoft/protection to com/microsoft/rightsmanagment. Le texte a cependant été mis à jour.The text though, has been updated.

  • Ouvrez l’environnement de développement Eclipse.Open the Eclipse development environment.

  • Pour créer un projet d’application Android, dans le menu Fichier, cliquez sur Nouveau, cliquez sur Projet, puis sélectionnez Projet d’application Android.To create a new Android Application project, on the File menu, click New, click Project, and then select Android Application Project.

    Créez une application Android

  • Entrez le nom de l’application.Enter the application name. Le nom du projet et le nom du package sont renseignés en fonction du nom de l’application.The project name and package name is filled based on the application name.

  • Cliquez sur Suivant et choisissez où vous voulez créer l’espace de travail.Click Next and select where you want to create the workspace.

    Entrez le nom de l’application

  • Cliquez sur Suivant et sélectionnez une icône pour votre application.Click Next and select an icon for your app.

    Sélectionnez une icône pour votre application

  • Cliquez sur Suivant et sélectionnez Activité vide pour créer l’activité.Click Next and select Blank Activity to create the activity.

    Créez l’activité

  • Cliquez sur Suivant et indiquez un nom pour l’activité.Click Next and provide a name for the activity. Vous pouvez conserver MainActivity comme nom par défaut avec le nom de mise en page main activité_.You can leave MainActivity as the default name with a layout name of activity_main.

    Spécifiez un nom pour l’activité

  • Cliquez sur Terminer.Click Finish.

    Terminez la création

  • Votre projet a été créé, ainsi que la classe d’activité principale MainActivity.java.Your project has been created, along with the main activity class MainActivity.java.

Référencement du SDKReferencing the SDK

  • Accédez au dossier dans lequel vous avez extrait le fichier_ADRMS_Android SDK. zip.Navigate to the folder in which you extracted the adrms_android_sdk.zip. Dans le dossier « SDK > com > microsoft > rightsmanagement », vérifiez que les fichiers .classpath, .project et project.properties ne sont pas marqués en lecture seule.In the "SDK > com > microsoft > rightsmanagement" folder, make sure the files .classpath, .project, and project.properties are not marked as read-only.

  • Pour faire référence au SDK, vous devez l’importer dans l’espace de travail.To reference the SDK, you must import it to the workspace.

    Dans Eclipse, cliquez sur Fichier.In Eclipse, click File. Dans le menu Fichier, cliquez sur Importer.On the File menu, click Import. Dans la boîte de dialogue Importer, sélectionnez Android / Code Android existant dans l’espace de travail.In the Import dialog box, select Android / Existing Android Code into Workspace.

    Importez-le dans l’espace de travail

  • Cliquez sur Suivant.Click Next. Accédez à sélectionner le dossier dans lequel vous avez extrait le_fichier_ADRMS Android SDK. zip.Navigate to select the folder in which you extracted the adrms_android_sdk.zip. Le SDK doit apparaître dans la liste comme com.microsoft.rightsmanagement.The SDK should appear in the list as com.microsoft.rightsmanagement.

    Naviguez pour sélectionner le dossier

  • Quand vous cliquez sur Terminer, le projet de SDK s’affiche comme frère de votre application précédemment créée.When you click Finish, the SDK project appears as a sibling of your previously created application.

    Le projet du SDK s’affiche en tant que frère de votre application

  • Cliquez avec le bouton droit sur l’icône Projet et examinez les propriétés du projet.Right-click the Project icon and view the properties for the project.

  • Accédez à l’onglet Android.Navigate to the Android tab.

  • Cliquez sur Ajouter, puis sélectionnez la bibliothèque com.microsoft.rightsmanagement à partir de l’espace de travail.Click Add, and then select the com.microsoft.rightsmanagement library from the workspace.

    Ajoutez la bibliothèque

  • Cliquez sur OK.Click OK.

    Étant donné que le MS kit de développement logiciel (SDK) RMS 4,2 se connecte à AAD RM, l’application doit se voir accorder l' État réseau__ Internet et accès.Because the MS RMS SDK 4.2 connects with AAD RM, the application has to be granted the INTERNET and ACCESS_NETWORK_STATE. Pour cela, ouvrez le fichier AndroidManifest.xml à la racine du projet.To do so, open the AndroidManifest.xml file in the root of the project.

    Pour ajouter les autorisations, cliquez sur Ajouter, puis sélectionnez Utilise les autorisations.To add the permissions, click Add, and then select Uses Permissions.

    Ajout d’autorisations

  • Vous pouvez vérifier l’étape du manifeste en consultant le manifeste dans l’affichage de l’éditeur de texte.You can verify the manifest step by viewing the manifest in the text editor view. Vérifiez que les lignes suivantes s’affichent :Make sure the following lines appear:

    <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/>
    

Remarque  le kit de développement logiciel (SDK) utilise Android. support. v4Note  The SDK uses the android.support.v4

  • Vous êtes maintenant prêt à créer vos propres applications Android.You are now ready to create your own new Android apps.

 Voir aussiSee Also

Prise en mainGet started

NouveautésWhat's new

Concepts et termes de développementDeveloper terms and concepts

Informations de référence sur l’API AndroidAndroid API Reference