Configuração do Android
Importante
As versões do Microsoft Rights Management Service SDK lançadas antes de março de 2020 são depreciadas; as aplicações que utilizam versões anteriores devem ser atualizadas para utilizar a versão de março de 2020. Para mais detalhes, consulte o aviso de depreciação.
Não estão previstas mais melhorias para o Microsoft Rights Management Service SDK. Recomendamos vivamente a adoção do Proteção de Informações da Microsoft SDK para serviços de classificação, rotulagem e proteção.
As aplicações Android podem utilizar o SDK Microsoft Rights Management 4.2 para ativar a proteção de informações integrada nas respetivas aplicações utilizando o Azure Active Directory Rights Management (AAD RM).
Este tópico descreve como configurar o ambiente para criar as suas novas aplicações.
Pré-requisitos
Recomendamos o seguinte software no sistema de desenvolvimento:
Sistema operativo Windows ou OS X para executar o ambiente de desenvolvimento Eclipse.
Este guia pressupõe que está a utilizar o SDK Eclipse com o Eclipse Juno 4.2 ou superior e que está a utilizar uma instalação predefinida.
Java 1.6 ou superior.
Plug-in Ferramentas do Programador do Android (ADT). NOTA – poderá ser-lhe pedido para reiniciar o Eclipse para concluir a instalação.
O pacote do SDK MS RMS 4.2 para Android. Para mais informações, veja, começa.
Este SDK pode ser utilizado para desenvolver para o Android 4.0.3 (nível de API 15) e posterior.
Biblioteca de autenticação: recomendamos que utilize a Azure AD Authentication Library (ADAL). No entanto, também é possível utilizar outras bibliotecas de autenticação que suportem o OAuth 2.0.
Para obter mais informações, consulte ADAL para Android
Nota Se a sua aplicação não utilizar a Biblioteca ADAL como biblioteca de autenticação OAuth 2.0, deverá rever esta orientação android, Some SecureRandom Thoughts.
Opcional
A nossa biblioteca da interface de utilizador fornece uma IU reutilizável para operações de consumo e proteção para programadores que não pretendem criar a sua IU personalizada – Biblioteca da IU e Aplicação de exemplo para Android.
Configurar o ambiente de desenvolvimento
Nota MS RMS SDK 4.2 Preview Release: Nesta versão de pré-visualização, as imagens de ecrã não foram atualizadas para mostrar a alteração em nome dos caminhos de com/microsoft/protection para com/microsoft/rightsmanagment. No entanto, o texto foi atualizado.
Abra o ambiente de desenvolvimento Eclipse.
Para criar um novo projeto de Aplicação Android, no menu Ficheiro, clique em Novo, clique em Projeto e selecione Projeto de Aplicação Android.
Introduza o nome da aplicação. O nome do projeto e o nome do pacote é preenchido com base no nome da aplicação.
Clique em Seguinte e selecione onde pretende criar a área de trabalho.
Clique em Seguinte e selecione um ícone para a aplicação.
Clique em Seguinte e selecione Atividade em Branco para criar a atividade.
Clique em Seguinte e atribua um nome à atividade. Pode deixar o MainActivity como o nome padrão com um nome de layout de activity_main.
Clique em Concluir.
O projeto foi criado, em conjunto com a classe de atividade principal MainActivity.java.
Referenciar o SDK
Navegue para a pasta na qual extraiu o adrms_android_sdk.zip. Na pasta "SDK > com > microsoft > rightsmanagement", certifique-se de que os ficheiros .classpath, .project e project.properties não estão marcados apenas como leitura.
Para referenciar o SDK, tem de importá-lo para área de trabalho.
No Eclipse, clique em Ficheiro. No menu Ficheiro, clique em Importar. Na caixa de diálogo Importar, selecione Android/Código Android existente na Área de Trabalho.
Clique em Seguinte. Navegue para selecionar a pasta na qual extraiu o adrms_android_sdk.zip. O SDK deve aparecer na lista de como com.microsoft.rightsmanagement.
Quando clica em Concluir, o projeto do SDK aparece como colateral da sua aplicação criada anteriormente.
Clique no botão direito do rato no ícone Projeto e veja as propriedades do projeto.
Navegue para o separador Android.
Clique em Adicionar e selecione a biblioteca com.microsoft.rightsmanagement na área de trabalho.
Clique em OK.
Uma vez que o MS RMS SDK 4.2 se conecta com o AAD RM, a aplicação tem de ser concedida à INTERNET e ACCESS_NETWORK_STATE. Para tal, abra o ficheiro AndroidManifest.xml na raiz do projeto.
Para adicionar as permissões, clique em Adicionar e selecione Utiliza Permissões.
Pode verificar o passo do manifesto ao visualizar o manifesto na vista de editor de texto. Certifique-se de que as linhas seguintes são apresentadas:
<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/>
Nota O SDK usa o android.support.v4
- Agora, está pronto para criar as suas novas aplicações Android.