Novidades e Notas de versãoWhat's new and Release notes

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.Versions of the Microsoft Rights Management Service SDK released prior to March 2020 are deprecated; applications using earlier versions must be updated to use the March 2020 release. Para mais detalhes, consulte o aviso de depreciação.For full details, see the deprecation notice.

Não estão previstas mais melhorias para o Microsoft Rights Management Service SDK.No further enhancements are planned for the Microsoft Rights Management Service SDK. Recomendamos vivamente a adoção do Microsoft Information Protection SDK para serviços de classificação, rotulagem e proteção.We strongly recommend adoption of the Microsoft Information Protection SDK for classification, labeling, and protection services.

NovidadesWhat's new

Este tópico descreve mudanças e funcionalidades importantes nesta nova versão do RMS SDK v4.x.This topic outlines important changes and features in this new version of the RMS SDK v4.x.

Novidade para julho de 2017New for July 2017

A atualização para o nosso lançamento de julho incluiu o incremento da revisão do SDK, agora 4.2.5.The update for our July release included incrementing the revision of the SDK, now 4.2.5.

  • Android SDK: A sua aplicação pode agora definir o nível de registo no voo com o Android SDK.Android SDK: Your app can now set the logging level on-the-fly with the Android SDK. Para obter mais informações, consulte Como: ativar registo de erros e de desempenhoFor more information, see How to: Enable error and performance logging
  • O iOS SDK não suporta o nível de registo.The iOS SDK does not support logging level.
  • O SDK retorna agora um erro para um token de acesso NU.The SDK now returns an error for a NULL access token.

Atualização de outubro de 2016October 2016 update

  • Implementar algumas correções de bugs de fundo.Implement a few back-end bug fixes.
  • Ativar o bitcode para o Apple iOS/OSX SDK.Enable bitcode for the Apple iOS/OSX SDK.

Atualização de junho de 2016June 2016 update

  • Support for Modern Authentication - traz a Ative Directory Authentication Library (ADAL) com base em aplicações iluminadas por RMS.Support for Modern Authentication - brings Active Directory Authentication Library (ADAL)-based sign-in to RMS enlightened apps. Permite funcionalidades de login como Multi-Factor Authentication (MFA), Fornecedores de Identidade baseados em SAML com aplicações de clientes RMS, cartão inteligente e autenticação baseada em certificados e elimina a necessidade de aplicações iluminadas por RMS utilizarem o protocolo de autenticação básica.It enables sign-in features like Multi-Factor Authentication (MFA), SAML-based third-party Identity Providers with RMS client applications, smart card, and certificate-based authentication and it removes the need for RMS enlightened apps to use the basic authentication protocol.
  • Suporte ao Controlo de Documentos - os programadores agora podem ativar o controlo de documentos ao proteger um documento nas suas aplicaçõesDocument Tracking support - developers can now enable document tracking when protecting document in their apps
  • Melhorias de desempenhoPerformance improvements
  • Correções de errosBug fixes

Atualização de dezembro de 2015December 2015 update

Com esta versão, o SDK RMS para dispositivos está agora na versão 4.2 e adiciona:With this release, the RMS SDK for devices is now at version 4.2 and adds:

Atualização de julho de 2015 – adiciona suporte para a programação em Linux/C++July 2015 Update - Adds support for Linux / C++ development

Esta versão adiciona as seguintes atualizações:This release adds the following updates:

  • SDK RMS 4.1 para plataformas LinuxRMS SDK 4.1 for Linux platforms

    Para obter mais informações, veja Introdução.For more information, see Get started.

Atualização de maio de 2015 – adiciona o controlo de registoMay 2015 Update - Adds logging control

Esta versão adiciona suporte para as seguintes atualizações:This release adds support for the following updates:

Atualização de fevereiro de 2015 – adiciona o suporte para aplicações da Loja WindowsFebruary 2015 Update - Adds Windows Store application support

Esta versão adiciona suporte para aplicações windows Store e fornece paridade funcional com o Windows Phone, Android e iOS/OS X de lançamento do RMS SDK 4.1.This release adds support for Windows Store applications and provides functional parity with the Windows Phone, Android, and iOS/OS X release of the RMS SDK 4.1.

Atualização de janeiro de 2015 – adiciona o suporte da plataforma WinPhoneJanuary 2015 Update - Adds WinPhone platform support

Esta versão adiciona o suporte para o sistema operativo Windows Phone e fornece paridade funcional com o lançamento para Android e iOS/OS X do SDK RMS 4.1.This release adds support for the Windows Phone operating system and provides functional parity with the Android and iOS/OS X release of the RMS SDK 4.1.

Atualização de outubro de 2014 – atualizar para o SDK Microsoft RMS 4.1October 2014 Update - Upgrade to Microsoft RMS SDK 4.1

O lançamento da versão 4.1 do SDK RMS adiciona as seguintes funcionalidades novas para o Google Android e Apple iOS/OS X.The version 4.1 release of the RMS SDK adds the following new features to the Google Android and Apple iOS / OS X.

  • Extensões da API do SDK iOS/OS X para o processamento do consentimento do utilizador, permitindo a confirmação do utilizador de comportamentos do SDK.Android and iOS/OS X SDK API extensions for user consent processing, allowing user confirmation of SDK behaviors. Atualmente, o controlo de documentos e o acesso a URLs desconhecidos do serviço AD RMS são os tipos de consentimento suportados.Currently, document tracking and accessing unknown AD RMS service URLs are the supported consent types.

    Para obter mais informações, consulte, como exemplo, a versão da API do Android da interface ConsentCallback.For more information, see as example, the Android API version of ConsentCallback interface.

  • O iOS 8 e o OS X 10.10 (Yosemite) já são suportados.iOS 8 and OS X 10.10 (Yosemite) are now supported. De igual modo, houve algumas alterações de nomes de propriedades obrigatórias pelo Xcode 6.There have also been a few property name changes required by Xcode 6.

    Exemplo: alterou-se MSUserPolicy.name para MSUserPolicy.policyName.Example; MSUserPolicy.name changed to MSUserPolicy.policyName.

Notas de versãoRelease notes

Esta secção apresenta as informações sobre as versões atuais e anteriores das APIs SDK Microsoft Rights Management 4. x que o programador deve ter em consideração.This section outlines information about the current and previous releases of the Microsoft Rights Management SDK 4.x APIs that you, as a developer, want to be aware of.

SDK AD RMS 4.1 – Lançamento de Disponibilidade Global para as plataformas iOS / OS X e AndroidAD RMS SDK 4.1 - iOS / OS X and Android platforms Global Availability Release

  • Suporte do AD RMS – os administradores de TI podem utilizar aplicações com suporte RMS em dispositivos móveis com as novas extensões para dispositivos móveis do servidor AD RMS.AD RMS support - IT administrators can use RMS enabled apps on mobile devices with the new AD RMS server's mobile device extensions.
  • Consumo Offline - os utilizadores finais podem aceder a dados protegidos RMS offline.Offline Consumption - end users can access RMS protected data offline.
  • Autorização Separada – os programadores podem utilizar a sua própria biblioteca de autenticação para o Azure RMS e AD RMS (ou utilizar a Azure AD Authentication Library (ADAL) recomendada).Segregated Auth - developers can use their own authentication library for Azure RMS and AD RMS (or use the recommended Azure AD Authentication Library (ADAL)).
  • IU Separada – os programadores podem criar a sua interface de utilizador para proteger e consumir documentos protegidos por RMS.Segregated UI - developers can build their user interface to protect and consume RMS protected documents.
  • API redesenhada - os desenvolvedores podem agora desfrutar de uma API de encriptação e desencriptação simples e transparente, que proporciona comportamentos RMS consistentes e experiência do utilizador, com o mínimo de esforço.Redesigned API - developers can now enjoy a straightforward and transparent encryption and decryption API, which provides consistent RMS behaviors and user experience, with minimum effort.

Comum a todas as plataformasCommon to all platforms

  • As APIs do SDK RMS 4.x não são seguras para os threads.The RMS SDK 4.x APIs are not thread-safe.

AndroidAndroid

  • Quando utilizar uma aplicação de exemplo num dispositivo Amazon® Kindle para ver anexos .ptxt, tem primeiro de transferir o ficheiro antes de o visualizar.When you use a sample app on an Amazon® Kindle device to view .ptxt attachments, you must first download the file before you view it.

    Solução - uma questão conhecida que será abordada mais tarde.Solution - a known issue that will be addressed later.

  • Uma aplicação que utilize o SDK pode falhar se forem permitidas várias instâncias.An application that uses the SDK may crash if multi-instance is allowed.

    Solução – certifique-se de que a aplicação não permite chamadas de várias instâncias para a API do Android.Solution - Make sure the application does not allow multi-instance calls to the Android API.

  • Quando uso o método ProtectEdFileOutputStream.write [ ] (byte array, int offset, int length ) com um comprimento diferente do valor array.length, não posso consumir o conteúdo mais tarde usando o SDK.When I use the ProtectedFileOutputStream.write( byte[] array, int offset, int length ) method with a length different from the array.length value, I am not able to consume the content later using the SDK.

    Solução – isto é um problema conhecido.Solution - This is a known issue. Para atenuá-lo, ou passa sempre uma matriz *byte [ ] * com o mesmo valor de comprimento que o parâmetro de comprimento, ou utiliza o método ProtectEdFileOutputStream.write [ ] (byte array).To mitigate it, either always pass a byte [] array with the same length value as the length parameter, or use the ProtectedFileOutputStream.write(byte[] array) method.

iOS e OS XiOS and OS X

  • Existem dois dialetos de português que os nossos SDKs para iOS e OS X suportam.There are two dialects of Portuguese that our iOS and OS X SDKs support. Infelizmente, devido a um bug, não apoiamos atualmente a primeira localização completamente.Unfortunately, due to a bug, we do not currently support the first localization completely. Devido a este erro, o português não é totalmente suportado.Because of this bug, Portuguese is not fully supported. A maior parte do texto é traduzido, mas não a IU.Most of the text is translated, but not the UI.

    1. PortuguêsPortuguese

    2. Português (Portugal)Portuguese (Portugal)

apenas iOSiOS only

  • O SDK RMS 4.x não mostra o indicador da atividade de rede.The RMS SDK 4.x does not show the network activity indicator.

    Este é um comportamento opcional conhecido para iOS de acordo com as Diretrizes de Interface Humana da Apple.This is a known optional behavior for iOS according to the Apple Human Interface Guidelines.

Apenas OS XOS X only

  • O SDK RMS 4.x não mostra o indicador da atividade de rede.The RMS SDK 4.x does not show the network activity indicator.

    Este é um comportamento opcional conhecido para OS X de acordo com as Diretrizes de Interface Humana da Apple.This is a known optional behavior for OS X according to the Apple Human Interface Guidelines.

  • Solução – para criar uma aplicação de interface MDI (multiple document interface) através do nosso SDK para OS X, utilize as seguintes orientações.Solution - To create a multiple document interface (MDI) application using our OS X SDK, use the following guidance.

    Os seguintes métodos não podem ser executados em simultâneo.The following methods must not be run concurrently. Para acompanhar a conclusão da execução, utilize a abordagem do bloco de conclusão, conforme indicado.In order to monitor for execution completion, use the completion block approach as noted.

Nota    As aplicações MDI não são suportadas pela nossa API iOS.Note  MDI applications are not supported by our iOS API.

Perguntas mais frequentesFrequently asked questions

Todas as plataformasAll platforms

P: não consigo ver uma IU de seleção de Permissões Personalizadas no fluxo de trabalho da proteção.Q: I don’t see a Custom Permissions selection UI in the protection workflow. Porquê?Why?

R – isto é um problema conhecido e será resolvido mais tarde.A: This is a known issue and will be addressed later.

P: de que forma obtenho novos inquilinos organizacionais para experimentar o SDK e as aplicações de exemplo?Q: How do I get new organizational tenants to try out the SDK and sample applications?

R: Para solicitar credenciais para organizações de teste RMS AZure AD, envie e-mail para rmcstbeta@microsoft.com .A: To request credentials for Azure AD RMS test organizations, send email to rmcstbeta@microsoft.com.

P: não vejo qualquer debate sobre a hierarquia de testes aqui na documentação.Q: I don’t see any test hierarchy discussion here in the documentation. Porquê?Why?

R: não existe qualquer conceito de hierarquia de testes com os novos SDKs AD RMS.A: There is no test hierarchy concept with the new AD RMS SDKs. Irá sempre trabalhar com a hierarquia de produção.You will always work with the production hierarchy.

P: Na versão 2.1 do RMS SDK, era necessário um manifesto gerado para cada aplicação que implementasse a proteção da informação.Q: In the 2.1 version of the RMS SDK, a generated manifest was needed for each application implementing information protection. Isto ainda é verdade para as versões 4.0 e posteriores do SDK?Is this still true for the 4.0 and later versions of the SDK?

R: não, os manifestos já não são necessários para as versões 3.0 e posteriores do SDK Rights Management.A: No, manifests are no longer needed for the 3.0 and later versions of the Rights Management SDK.

AndroidAndroid

P: com que ambientes de desenvolvimento foi o SDK testado?Q: Which development environments has the SDK been tested with?

R: Eclipse Juno através da API do Google 15 e superior.A: Eclipse Juno using Google API 15 and above.

P: posso chamar um método de cancelamento cancel() a partir do thread da IU?Q: Can I call cancel() a cancel method from the UI thread? R: deve chamar cancel() a partir de um thread não IU, pois pode abortar uma ligação de rede.A: You should call cancel() from a non-UI thread, as it may abort network a connection.

iOSiOS

P: que plataformas foram verificadas para o desenvolvimento de SDK?Q: Which platforms were verified for SDK development?

R: Xcode 5.0 com iOS 7 e posterior.A: Xcode 5.0 with iOS 7 and later.

P: chamei um método cancel() numa operação; no entanto, ainda obtive uma notificação sobre a conclusão da operação.Q: I called a cancel() method on an operation, however I still got notification that the operation completed. Porquê?Why?

Um: nem todas as operações podem ser canceladas, pelo que uma operação de cancelamento é executada da melhor forma possível.A: Not all operations can be canceled, so a cancellation operation is executed as best as is possible.

OS XOS x

P: A estrutura da aplicação da amostra é adaptada ao Xcode 5, posso trabalhar com o Xcode 4.6?Q: Sample app framework is adapted to Xcode 5, can I work with Xcode 4.6?

R: o SDK OS X apenas funciona com o Xcode 4.6 e versões posteriores, bem como o OS X 10.8 e versões posteriores.A:The OS X SDK works with Xcode 4.6 and later only, as well as OS X 10.8 and later.