Android 設定
重要
2020 年 3 月之前發行的 Microsoft Rights Management Service SDK 版本已被取代;使用舊版的應用程式必須更新為使用 2020 年 3 月版本。 如需完整詳細資料,請參閱 淘汰通知。
Microsoft Rights Management Service SDK 沒有進一步的增強功能。 我們強烈建議採用Microsoft 資訊保護 SDK來分類、標記和保護服務。
Android 應用程式可以藉由使用 Azure Active Directory Rights Management (AAD RM),來使用 Microsoft Rights Management SDK 4.2 在其應用程式中啟用整合的資訊保護。
本主題將引導您設定您的環境,以建立您自己的新應用程式。
必要條件
建議您在開發系統上使用下列軟體︰
Windows 或 OS X 作業系統以執行 Eclipse 開發環境。
本指南假設您從 Eclipse Juno 4.2 開始使用 Eclipse SDK,並使用預設安裝。
Java 開始使用 Java 1.6。
Android 開發人員工具 (ADT) 外掛程式。 注意 - 系統可能會要求您重新啟動 Eclipse 以完成安裝。
適用於 Android 的 MS RMS SDK 4.2 套件。 如需詳細資訊,請參閱 開始使用。
此 SDK 可以用來開發 Android 4.0.3 (API 層級 15) 和更新版本中。
驗證程式庫︰建議您使用 Azure AD 驗證程式庫 (ADAL)。 不過,也可以使用其他支援 OAuth 2.0 的驗證程式庫。
如需詳細資訊,請參閱 Android 適用的 ADAL。
注意 如果您的應用程式不會使用 ADAL 程式庫作為 OAuth 2.0 驗證程式庫,您應該檢閱此 Android 指引 :一些 SecureRandom Thoughts。
選擇性
我們的 UI 程式庫提供可重複使用的 UI,適用於不想要建立其自己的自訂 UI 之開發人員的耗用和保護作業 - Android 的 UI 程式庫與範例應用程式。
設定您的開發環境
注意 MS RMS SDK 4.2 預覽版本:在此預覽版本中,螢幕擷取畫面尚未更新,以顯示從 com/microsoft/protection 到 com/microsoft/rightsmanagment 的路徑名稱變更。 不過已更新文字。
開啟 Eclipse 開發環境。
若要建立新的 Android 應用程式專案,請在 [檔案] 功能表上,按一下 [新增],按一下 [專案],然後選取 [Android 應用程式專案]。
輸入應用程式名稱。 專案名稱和套件名稱會根據應用程式名稱填入。
按 [下一步],然後選取您想要建立工作區的地方。
按 [下一步],然後選取應用程式的圖示。
按 [下一步],然後選取 [空白活動] 以建立活動。
按 [下一步],並提供名稱給活動。 您可以將 MainActivity 保留為預設名稱,其配置名稱為 activity_main。
按一下 [完成] 。
已建立您的專案,以及主要活動類別 MainActivity.java。
參考 SDK
流覽至您擷取 adrms_android_sdk.zip的資料夾。 在 「SDK > com > microsoft > rightsmanagement」 資料夾中,確定 .classpath、 .project和 project.properties 檔案未標示為唯讀。
若要參考 SDK,您必須將它匯入工作區。
在 Eclipse 中,按一下 [檔案]。 在 [檔案] 功能表上,按一下 [匯入]。 在 [匯入] 對話方塊中,選取 [Android / 現有 Android 程式碼至工作區]。
按一下 [下一步] 。 流覽至選取您擷取 adrms_android_sdk.zip的資料夾。 SDK 應該會以 com.microsoft.rightsmanagement 出現在清單中。
當您按一下 [完成],SDK 專案會顯示為您先前建立之應用程式的同層級。
以滑鼠右鍵按一下 [專案] 圖示,並檢視專案屬性。
瀏覽至 [Android] 索引標籤。
按一下 [新增],然後選取工作區中的 com.microsoft.rightsmanagement 程式庫。
按一下 [確定]。
因為 MS RMS SDK 4.2 會與 AAD RM 連線,所以應用程式必須獲得 網際網路 和 ACCESS_NETWORK_STATE。 若要這樣做,請在專案的根目錄中開啟 AndroidManifest.xml 檔案。
若要新增權限,請按一下 [新增],然後選取 [使用權限]。
您可以藉由在文字編輯器檢視中檢視資訊清單,以確認資訊清單步驟。 請確定出現下列幾行︰
<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 應用程式。