Configuration pour Android
Important
Les versions du Kit de développement logiciel (SDK) du service Microsoft Rights Management publiées avant mars 2020 sont déconseillées ; les applications utilisant des versions antérieures doivent être mises à jour pour utiliser la version de mars 2020. Pour plus d’informations, consultez l’avis de dépréciation.
Aucune autre amélioration n’est prévue pour le Kit de développement logiciel (SDK) du service Microsoft Rights Management. Nous vous recommandons vivement d’adopter le KIT de développement logiciel (SDK) Protection des données Microsoft pour les services de classification, d’étiquetage et de protection.
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).
Cette rubrique explique comment configurer votre environnement pour créer vos propres applications.
Prérequis
Nous vous recommandons de disposer des logiciels suivants sur votre système de développement :
Système d’exploitation Windows ou OS X pour exécuter l’environnement de développement Eclipse.
Ce guide suppose que vous utilisez le SDK Eclipse à partir d’Eclipse Juno 4.2 et avec une installation par défaut.
Java à partir de Java 1.6.
Plug-in Outils ADT (Android Developer Tools). REMARQUE : Vous devrez peut-être redémarrer Eclipse pour terminer l’installation.
Le package MS RMS SDK 4.2 pour Android. Pour plus d’informations, consultez Prise en main.
Ce SDK peut être utilisé pour développer pour Android 4.0.3 (API niveau 15) et ultérieur.
Bibliothèque d’authentification : nous vous recommandons d’utiliser la bibliothèque ADAL (Azure AD Authentication Library). Toutefois, vous pouvez aussi utiliser d’autres bibliothèques d’authentification qui prennent en charge OAuth 2.0.
Pour plus d’informations, consultez ADAL pour Android
Note Si votre application n’utilise pas la bibliothèque ADAL comme bibliothèque d’authentification OAuth 2.0, vous devez passer en revue ces conseils Android, quelques pensées SecureRandom.
Facultatif
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.
Configuration de votre environnement de développement
Note MS RMS SDK 4.2 Version préliminaire : dans cette préversion, les captures d’écran n’ont pas été mises à jour pour afficher le changement de nom des chemins d’accès de com/microsoft/protection vers com/microsoft/rightsmanagment. Le texte a cependant été mis à jour.
Ouvrez l’environnement de développement Eclipse.
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.
Entrez le nom de l’application. Le nom du projet et le nom du package sont renseignés en fonction du nom de l’application.
Cliquez sur Suivant et choisissez où vous voulez créer l’espace de travail.
Cliquez sur Suivant et sélectionnez une icône pour votre application.
Cliquez sur Suivant et sélectionnez Activité vide pour créer l’activité.
Cliquez sur Suivant et indiquez un nom pour l’activité. Vous pouvez laisser MainActivity comme nom par défaut avec un nom de disposition de activity_main.
Cliquez sur Terminer.
Votre projet a été créé, ainsi que la classe d’activité principale MainActivity.java.
Référencement du SDK
Accédez au dossier dans lequel vous avez extrait le 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 comme étant en lecture seule.
Pour faire référence au SDK, vous devez l’importer dans l’espace de travail.
Dans Eclipse, cliquez sur Fichier. Dans le menu Fichier, cliquez sur Importer. Dans la boîte de dialogue Importer, sélectionnez Android / Code Android existant dans l’espace de travail.
Cliquez sur Suivant. Accédez au dossier dans lequel vous avez extrait le adrms_android_sdk.zip. Le SDK doit apparaître dans la liste comme com.microsoft.rightsmanagement.
Quand vous cliquez sur Terminer, le projet de SDK s’affiche comme frère de votre application précédemment créée.
Cliquez avec le bouton droit sur l’icône Projet et examinez les propriétés du projet.
Accédez à l’onglet Android.
Cliquez sur Ajouter, puis sélectionnez la bibliothèque com.microsoft.rightsmanagement à partir de l’espace de travail.
Cliquez sur OK.
Étant donné que le SDK MS RMS 4.2 se connecte à AAD RM, l’application doit recevoir internet et ACCESS_NETWORK_STATE. Pour cela, ouvrez le fichier AndroidManifest.xml à la racine du projet.
Pour ajouter les autorisations, cliquez sur Ajouter, puis sélectionnez Utilise les autorisations.
Vous pouvez vérifier l’étape du manifeste en consultant le manifeste dans l’affichage de l’éditeur de texte. Vérifiez que les lignes suivantes s’affichent :
<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/>
Note Le Kit de développement logiciel (SDK) utilise android.support.v4
- Vous êtes maintenant prêt à créer vos propres applications Android.