Configuração do AndroidAndroid setup

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).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 ).

Este tópico descreve como configurar o ambiente para criar as suas novas aplicações.This topic will guide you through setting up your environment for creating your own new apps .

Pré-requisitosPrerequisites

Recomendamos o seguinte software no sistema de desenvolvimento:We recommend the following software on your development system:

  • Sistema operativo Windows ou OS X para executar o ambiente de desenvolvimento Eclipse.Windows or OS X operating system to run the Eclipse development environment.
  • 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.This guide assumes that you are using the Eclipse SDK beginning with Eclipse Juno 4.2 and using a default installation.
  • Java 1.6 ou superior.Java starting with Java 1.6.
  • Plug-in Ferramentas do Programador do Android (ADT).Android Developer Tools (ADT) Plugin. NOTA – poderá ser-lhe pedido para reiniciar o Eclipse para concluir a instalação.NOTE - You might be asked to restart Eclipse to complete the installation.

  • O pacote do SDK MS RMS 4.2 para Android.The MS RMS SDK 4.2 package for Android. Para obter mais informações, consulte Introdução.For more information see, Get started.

    Este SDK pode ser utilizado para desenvolver para o Android 4.0.3 (nível de API 15) e posterior.This SDK can be used to develop for Android 4.0.3 (API level 15) and later.

  • Biblioteca de autenticação: recomendamos que utilize a Biblioteca de Autenticação do Azure AD (ADAL).Authentication library: We recommend that you use the Azure AD Authentication Library (ADAL). No entanto, outras bibliotecas de autenticação que suportem o OAuth 2.0 também podem ser utilizadas.However, other authentication libraries that support OAuth 2.0 can be used as well.

    Para obter mais informações, consulte ADAL para AndroidFor more information see, ADAL for Android

    Nota Se a aplicação não for utilizar a biblioteca ADAL como a biblioteca de autenticação OAuth 2.0, deve rever esta orientação do Android, Algumas Ideias 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.

Consulte o tópico Novidades para obter informações sobre atualizações de API, notas de versão e perguntas mais frequentes (FAQ).Read the What's new topic for information about API updates, release notes, and frequently asked questions (FAQ).

OpcionalOptional

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

Configurar o ambiente de desenvolvimentoConfiguring your development environment

Nota Versão de Pré-visualização do SDK MS RMS 4.2: nesta versão de pré-visualização, as capturas de ecrã não foram atualizadas para mostrar a alteração no nome dos caminhos de com/microsoft/protection para 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. No entanto, o texto foi atualizado.The text though, has been updated.

  • Abra o ambiente de desenvolvimento Eclipse.Open the Eclipse development environment.
  • 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.To create a new Android Application project, on the File menu, click New, click Project, and then select Android Application Project.

    Criar uma nova aplicação Android

  • Introduza o nome da aplicação.Enter the application name. O nome do projeto e o nome do pacote é preenchido com base no nome da aplicação.The project name and package name is filled based on the application name.

  • Clique em Seguinte e selecione onde pretende criar a área de trabalho.Click Next and select where you want to create the workspace.

    Introduzir o nome da aplicação

  • Clique em Seguinte e selecione um ícone para a aplicação.Click Next and select an icon for your app.

    Selecionar um ícone para a aplicação

  • Clique em Seguinte e selecione Atividade em Branco para criar a atividade.Click Next and select Blank Activity to create the activity.

    Criar a atividade

  • Clique em Seguinte e atribua um nome à atividade.Click Next and provide a name for the activity. Pode deixar MainActivity como o nome predefinido com um nome de esquema de activity_main.You can leave MainActivity as the default name with a layout name of activity_main.

    Atribuir um nome à atividade

  • Clique em Concluir.Click Finish.

    Concluir a criação

  • O projeto foi criado, em conjunto com a classe de atividade principal MainActivity.java.Your project has been created, along with the main activity class MainActivity.java.

Referenciar o SDKReferencing the SDK

  • Navegue para a pasta onde extraiu o adrms_android_sdk.zip.Navigate to the folder in which you extracted the 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 como só de leitura.In the "SDK > com > microsoft > rightsmanagement" folder, make sure the files .classpath, .project, and project.properties are not marked as read-only.
  • Para referenciar o SDK, tem de importá-lo para área de trabalho.To reference the SDK, you must import it to the workspace.

    No Eclipse, clique em Ficheiro.In Eclipse, click File. No menu Ficheiro, clique em Importar.On the File menu, click Import. Na caixa de diálogo Importar, selecione Android/Código Android existente na Área de Trabalho.In the Import dialog box, select Android / Existing Android Code into Workspace.

    Importá-lo para a área de trabalho

  • Clique em Seguinte.Click Next. Navegue para a pasta onde extraiu o adrms_android_sdk.zip.Navigate to select the folder in which you extracted the adrms_android_sdk.zip. O SDK deve aparecer na lista de como com.microsoft.rightsmanagement.The SDK should appear in the list as com.microsoft.rightsmanagement.

    Navegar para selecionar a pasta

  • Quando clica em Concluir, o projeto do SDK aparece como colateral da sua aplicação criada anteriormente.When you click Finish, the SDK project appears as a sibling of your previously created application.

    O projeto do SDK aparece como colateral da aplicação

  • Clique no botão direito do rato no ícone Projeto e veja as propriedades do projeto.Right-click the Project icon and view the properties for the project.

  • Navegue para o separador Android.Navigate to the Android tab.
  • Clique em Adicionar e selecione a biblioteca com.microsoft.rightsmanagement na área de trabalho.Click Add, and then select the com.microsoft.rightsmanagement library from the workspace.

    Adicionar a biblioteca

  • Clique em OK.Click OK.

    Uma vez que o SDK MS RMS 4.2 liga ao AAD RM, é necessário conceder INTERNET e ACCESS_NETWORK_STATE à aplicação.Because the MS RMS SDK 4.2 connects with AAD RM, the application has to be granted the INTERNET and ACCESS_NETWORK_STATE. Para tal, abra o ficheiro AndroidManifest.xml na raiz do projeto.To do so, open the AndroidManifest.xml file in the root of the project.

    Para adicionar as permissões, clique em Adicionar e selecione Utiliza Permissões.To add the permissions, click Add, and then select Uses Permissions.

    Adicionar permissões

  • Pode verificar o passo do manifesto ao visualizar o manifesto na vista de editor de texto.You can verify the manifest step by viewing the manifest in the text editor view. Certifique-se de que as linhas seguintes são apresentadas:Make sure the following lines appear:

<span data-ttu-id="01271-172"><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/></span><span class="sxs-lookup"><span data-stu-id="01271-172"><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/></span></span>

Nota O SDK utiliza o android.support.v4Note The SDK uses the android.support.v4

  • Agora, está pronto para criar as suas novas aplicações Android.You are now ready to create your own new Android apps.

Consulte TambémSee Also

IntroduçãoGet started

NovidadesWhat's new

Conceitos e termos de programadorDeveloper terms and concepts

Referência da API do AndroidAndroid API Reference

ComentáriosComments

Antes de inserir um comentário, pedimos-lhe que reveja as nossas Regras básicas.Before commenting, we ask that you review our House rules.