Android のセットアップ

重要

2020 年 3 月より前にリリースされた Microsoft Rights Management Service SDK のバージョンは非推奨です。2020 年 3 月のリリースを使用するには、以前のバージョンを使用するアプリケーションを更新する必要があります。 詳細については、 非推奨の通知を参照してください。

Microsoft Rights Management Service SDK の今後の機能強化は計画されていません。 分類、ラベル付け、保護サービスには、Microsoft Information Protection SDK の導入を強くお勧めします。

Android アプリケーションは Microsoft Rights Management SDK 4.2 を使用して、Azure Active Directory Rights Management (AAD RM) を使用することでそのアプリケーション内で統合情報保護を有効にできます。

このトピックでは、独自の新しいアプリを作成するために環境をセットアップする方法について説明します。

前提条件

開発システムでは、次のソフトウェアをお勧めします。

  • Eclipse 開発環境を実行する Windows または OS X オペレーティング システム。

  • このガイドでは、Eclipse Juno 4.2 以降を持つ Eclipse SDK と、既定のインストールを使用していることを前提としています。

  • Java 1.6 以降。

  • Android Developer Tools (ADT) プラグイン。 注 - インストールを完了するために、Eclipse の再起動を求められる場合があります。

  • Android 向け MS RMS SDK 4.2 パッケージ。 詳細については、「 作業の開始」を参照してください。

    この SDK は、Android 4.0.3 (API レベル 15) 以降を対象とする開発に使用できます。

  • 認証ライブラリ: Azure AD Authentication Library (ADAL) を使用することをお勧めします。 ただし、OAuth 2.0 をサポートしている他の認証ライブラリも使用できます。

    詳細については、「ADAL for iOS 」 (iOS 用の ADAL) を参照してください。

    メモ アプリケーションで OAuth 2.0 認証ライブラリとして ADAL ライブラリを使用しない場合は、この Android ガイダンスである SecureRandom の考え方を確認する必要があります。

オプション

UI ライブラリは、独自のカスタム UI 作成を望まない開発者のために、使用操作と保護操作用の再利用可能な UI を提供します。「UI Library and Sample app for Android」 (Android 用の UI ライブラリとサンプル アプリ) 参照。

開発環境の構成

メモ MS RMS SDK 4.2 プレビュー リリース: このプレビュー リリースでは、com/microsoft/protection から com/microsoft/rightsmanagment へのパスの名前の変更を示すスクリーンショットは更新されていません。 テキストは更新されています。

  • Eclipse の開発環境を開きます。

  • Android アプリケーション プロジェクトを新規作成するには、[File] メニューで [New][Project] の順にクリックし、[Android Application Project] を選択します。

    新しい Android アプリケーションを作成する

  • アプリケーションの名前を入力します。 アプリケーション名に基づいて、プロジェクト名とパッケージ名が入力されます。

  • [Next] をクリックし、ワークスペースを作成する場所を選択します。

    アプリケーション名を入力します

  • [Next] をクリックし、アプリのアイコンを選択します。

    アプリのアイコンを選択する

  • [Next] をクリックし、[Blank Activity] を選択してアクティビティを作成します。

    アクティビティを作成する

  • [Next] をクリックし、アクティビティの名前を指定します。 MainActivity は、レイアウト名がactivity_mainの既定の名前のままにしておくことができます。

    アクティビティの名前を指定する

  • [完了] をクリックします。

    作成を終了する

  • プロジェクトがメイン アクティビティ クラス MainActivity.java と共に作成されました。

SDK を参照する

  • adrms_android_sdk.zipを抽出したフォルダーに移動します。 "SDK > com > microsoft > rightsmanagement" フォルダーで、 ファイル .classpath.projectproject.properties が読み取り専用としてマークされていないことを確認します。

  • 参照するには、SDK をワークスペースにインポートする必要があります。

    Eclipse で [File] をクリックします。 [File] メニューの [Import] をクリックします。 [Import] ダイアログ ボックスで、[Android / Existing Android Code into Workspace] を選択します。

    ワークスペースにインポートする

  • [次へ] をクリックします。 adrms_android_sdk.zipを抽出した フォルダーを選択 します。 SDK が com.microsoft.rightsmanagement として一覧に表示されます。

    フォルダーに移動して選択する

  • [Finish] をクリックすると、SDK プロジェクトが、以前に作成したアプリケーションの兄弟として表示されます。

    SDK プロジェクトがアプリケーションの兄弟として表示される

  • プロジェクト アイコンを右クリックし、プロジェクトのプロパティを表示します。

  • [Android] タブに移動します。

  • [Add] をクリックして、ワークスペースから com.microsoft.rightsmanagement ライブラリを選択します。

    ライブラリを追加する

  • [OK] をクリックします。

    MS RMS SDK 4.2 は AAD RM に接続するため、アプリケーションに インターネットACCESS_NETWORK_STATEを付与する必要があります。 これを行うには、プロジェクトのルートで AndroidManifest.xml ファイルを開きます。

    アクセス許可を追加するには、[Add] をクリックして、[Uses Permissions] を選択します。

    Add permissions

  • マニフェストを検証するには、テキスト エディターのビューでマニフェストを表示します。 次の行が表示されていることを確認してください。

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

メモSDK では android.support.v4 が使用されます

  • 新しい独自の Android アプリを作成する準備が整いました。

参照

開始するには

開発者の用語と概念

Android API リファレンス