Nyheter och versionsanteckningarWhat's new and Release notes

Viktigt

Versioner av Microsoft Rights Management Service SDK som lanserades före mars 2020 är inaktuella. program som använder tidigare versioner måste uppdateras för att använda versionen från mars 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. Fullständig information finns i utfasnings meddelandet.For full details, see the deprecation notice.

Inga ytterligare förbättringar planeras för Microsoft Rights Management Service SDK.No further enhancements are planned for the Microsoft Rights Management Service SDK. Vi rekommenderar starkt att du använder Microsoft Information Protection SDK för klassificering, märkning och skydds tjänster.We strongly recommend adoption of the Microsoft Information Protection SDK for classification, labeling, and protection services.

NyheterWhat's new

I det här avsnittet beskrivs viktiga ändringar och funktioner i den här nya versionen av RMS SDK v4. x.This topic outlines important changes and features in this new version of the RMS SDK v4.x.

Nytt i juli 2017New for July 2017

Uppdateringen för vår juli-utgåva innehöll en ökning av revideringen av SDK, nu 4.2.5.The update for our July release included incrementing the revision of the SDK, now 4.2.5.

  • Android SDK: din app kan nu ställa in loggnings nivån direkt med Android SDK.Android SDK: Your app can now set the logging level on-the-fly with the Android SDK. Mer information finns i Gör så här: Aktivera loggning av fel och prestandaFor more information, see How to: Enable error and performance logging
  • IOS SDK stöder inte loggnings nivå.The iOS SDK does not support logging level.
  • SDK returnerar nu ett fel för en NULL-åtkomsttoken.The SDK now returns an error for a NULL access token.

Uppdatering oktober 2016October 2016 update

  • Implementera några fel korrigeringar på Server sidan.Implement a few back-end bug fixes.
  • Aktivera bitcode för Apple iOS/OSX SDK.Enable bitcode for the Apple iOS/OSX SDK.

Uppdatering juni 2016June 2016 update

  • Stöd för modern autentisering – hämtar Active Directory-autentiseringsbibliotek-baserad (ADAL) inloggning till RMS upplysta-appar.Support for Modern Authentication - brings Active Directory Authentication Library (ADAL)-based sign-in to RMS enlightened apps. Det möjliggör inloggnings funktioner som Multi-Factor Authentication (MFA), SAML-baserade identitets leverantörer från tredje part med RMS-klientprogram, smartkort och certifikatbaserad autentisering och tar bort behovet av RMS upplysta-appar för att använda Basic Authentication Protocol.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.
  • Med stöd för dokumentspårning kan utvecklare nu aktivera dokumentspårning när de skyddar dokument i sina apparDocument Tracking support - developers can now enable document tracking when protecting document in their apps
  • PrestandaförbättringarPerformance improvements
  • FelkorrigeringarBug fixes

Uppdatering under december 2015December 2015 update

Med den här versionen har RMS SDK för enheter nu version 4.2 och lägger till:With this release, the RMS SDK for devices is now at version 4.2 and adds:

Uppdatering juli 2015 – stöd för utveckling med Linux / C++ har lagts tillJuly 2015 Update - Adds support for Linux / C++ development

Den här versionen lägger till följande uppdateringar:This release adds the following updates:

  • RMS SDK 4.1 för Linux-plattformarRMS SDK 4.1 for Linux platforms

    Mer information finns i Kom igång.For more information, see Get started.

Uppdatering maj 2015 – lägger till loggningskontrollMay 2015 Update - Adds logging control

Den här versionen lägger till stöd för följande uppdateringar:This release adds support for the following updates:

Uppdatering februari 2015 – stöd för Windows Store-programmet har lagts tillFebruary 2015 Update - Adds Windows Store application support

Den här versionen lägger till stöd för Windows Store-program och ger funktionell paritet med Windows Phone, Android och iOS/OS X-versionen av 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.

Uppdatering januari 2015 – stöd för WinPhone-plattformen har lagts tillJanuary 2015 Update - Adds WinPhone platform support

Den här versionen lägger till stöd för operativsystemet Windows Phone och tillhandahåller funktionsparitet med Android och iOS/OS X-versionen av RMS SDK 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.

Uppdatering oktober 2014 – uppgradering till Microsoft RMS SDK 4.1October 2014 Update - Upgrade to Microsoft RMS SDK 4.1

4.1-versionen av RMS SDK lägger till följande nya funktioner i Google Android- och 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.

  • Android och iOS-/OS X-SDL API-tillägg för bearbetning av användarmedgivande vilket gör att användaren kan bekräfta SDK-beteenden.Android and iOS/OS X SDK API extensions for user consent processing, allowing user confirmation of SDK behaviors. För närvarande är dokumentspårning och åtkomst av okända URL:er till AD RMS-tjänstens de medgivandetyper som stöds.Currently, document tracking and accessing unknown AD RMS service URLs are the supported consent types.

    Mer exempelinformation finns i Android API-versionen av ConsentCallback-gränssnittet.For more information, see as example, the Android API version of ConsentCallback interface.

  • Nu stöds iOS 8 och OS X 10.10 (Yosemite).iOS 8 and OS X 10.10 (Yosemite) are now supported. Dessutom har det även skett några ändringar av egenskapsnamn som krävs av Xcode 6.There have also been a few property name changes required by Xcode 6.

    Exempel; MSUserPolicy.name ändrat till MSUserPolicy.policyName.Example; MSUserPolicy.name changed to MSUserPolicy.policyName.

Viktig informationRelease notes

I det här avsnittet finns översiktlig information om aktuella och tidigare versioner av Microsoft Rights Management SDK 4.x API:er som du som utvecklare bör känna till.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.

AD RMS SDK 4.1 – global tillgänglighetsversion för iOS/OS X och Android-plattformarAD RMS SDK 4.1 - iOS / OS X and Android platforms Global Availability Release

  • Stöd för AD RMS – IT-administratörerna kan använda RMS-aktiverade program på mobila enheter med den nya AD RMS-serverns tillägg för mobila enheter.AD RMS support - IT administrators can use RMS enabled apps on mobile devices with the new AD RMS server's mobile device extensions.
  • Offline-konsumtion – slutanvändare kan komma åt RMS-skyddade data offline.Offline Consumption - end users can access RMS protected data offline.
  • Åtskild autentisering – utvecklarna kan använda sina egna autentiseringsbibliotek för Azure RMS och AD RMS (eller använda det rekommenderade Azure AD-autentiseringsbiblioteket (ADAL)).Segregated Auth - developers can use their own authentication library for Azure RMS and AD RMS (or use the recommended Azure AD Authentication Library (ADAL)).
  • Åtskilt gränssnitt – utvecklaren kan bygga ett användargränssnitt som kan användas för att skydda och använda RMS-skyddade dokument.Segregated UI - developers can build their user interface to protect and consume RMS protected documents.
  • Omdesignad API – utvecklare kan nu använda sig av ett enkelt och transparent API för kryptering och dekryptering, vilket ger konsekvent RMS-beteende och användar upplevelse, med minimal ansträngning.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.

Gemensamt för alla plattformarCommon to all platforms

  • RMS SDK 4.x API:er är inte trådsäkra.The RMS SDK 4.x APIs are not thread-safe.

AndroidAndroid

  • När du använder en exempelapp på en Amazon® Kindle-enhet för att visa bifogade .ptx-filer måste du först hämta filen innan du visar den.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.

    Lösning – ett känt problem som kommer att åtgärdas senare.Solution - a known issue that will be addressed later.

  • Ett program som använder SDK:n kan krascha om flera instanser tillåts.An application that uses the SDK may crash if multi-instance is allowed.

    Lösningen – Kontrollera att programmet inte tillåter flerinstansanrop till Android-API:n.Solution - Make sure the application does not allow multi-instance calls to the Android API.

  • När jag använder metoden metoden protectedfileoutputstream. write (byte [ ] matris, int offset, int-längd) med en längd som skiljer sig från matrisens. length -värde kan jag inte använda innehållet senare med hjälp av 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.

    Lösning – Detta är ett känt problem.Solution - This is a known issue. För att minimera den, kan du antingen alltid skicka en *byte [ ] * -matris med samma längd som längd parameter, eller använda metoden metoden 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 och OS XiOS and OS X

  • Det finns två dialekter av portugisiska som våra iOS- och OS X-SDK:er har stöd för.There are two dialects of Portuguese that our iOS and OS X SDKs support. Tyvärr har vi för närvarande inte stöd för den första lokaliseringen helt på grund av ett fel.Unfortunately, due to a bug, we do not currently support the first localization completely. På grund av det här programfelet stöds inte portugisiska fullt ut.Because of this bug, Portuguese is not fully supported. Större delen av texten har översatts, men inte användargränssnittet.Most of the text is translated, but not the UI.

    1. PortugisiskaPortuguese

    2. Portugisiska (Portugal)Portuguese (Portugal)

enbart iOSiOS only

  • RMS SDK 4.x visar inte nätverksaktivitetsindikatorn.The RMS SDK 4.x does not show the network activity indicator.

    Det här är ett känt valfritt beteende för iOS enligt rikt linjerna för Apple Human-gränssnittet.This is a known optional behavior for iOS according to the Apple Human Interface Guidelines.

enbart OS XOS X only

  • RMS SDK 4.x visar inte nätverksaktivitetsindikatorn.The RMS SDK 4.x does not show the network activity indicator.

    Det här är ett känt valfritt beteende för OS X i enlighet med rikt linjerna för Apple Human-gränssnittet.This is a known optional behavior for OS X according to the Apple Human Interface Guidelines.

  • Lösning – Om du vill skapa en MDI-applikation (Multiple Document Interface) med vår OS X SDK, följer du följande anvisningar.Solution - To create a multiple document interface (MDI) application using our OS X SDK, use the following guidance.

    Följande metoder får inte köras samtidigt.The following methods must not be run concurrently. Använd blockerings metoden för slut för ande som anges för att övervaka körningen.In order to monitor for execution completion, use the completion block approach as noted.

Obs!    MDI-program stöds inte av vår iOS-API.Note  MDI applications are not supported by our iOS API.

Vanliga frågor och svarFrequently asked questions

Alla plattformarAll platforms

Fråga: Jag ser inget avsnitt för anpassade behörigheter i användargränssnittet till skyddsarbetsflödet.Q: I don’t see a Custom Permissions selection UI in the protection workflow. Varför?Why?

Svar: Detta är ett känt problem som kommer att åtgärdas senare.A: This is a known issue and will be addressed later.

Fråga: Hur får jag nya organisationsklienter att testa SDK:n och exempelprogrammen?Q: How do I get new organizational tenants to try out the SDK and sample applications?

A: om du vill begära autentiseringsuppgifter för Azure AD RMS test organisationer skickar du ett e-postmeddelande till rmcstbeta@microsoft.com .A: To request credentials for Azure AD RMS test organizations, send email to rmcstbeta@microsoft.com.

Fråga: Jag ser inget resonemang om testhierarkier här i dokumentationen.Q: I don’t see any test hierarchy discussion here in the documentation. Varför?Why?

Svar: Det finns inget testhierarkibegrepp med de nya AD RMS SDK:erna.A: There is no test hierarchy concept with the new AD RMS SDKs. Du arbetar alltid med produktionshierarkin.You will always work with the production hierarchy.

F: i 2,1-versionen av RMS SDK krävdes ett genererat manifest för varje program som implementerar informations skydd.Q: In the 2.1 version of the RMS SDK, a generated manifest was needed for each application implementing information protection. Gäller detta fortfarande för 4,0 och senare versioner av SDK: n?Is this still true for the 4.0 and later versions of the SDK?

Svar: Nej, manifesten behövs inte längre för version 3.0 och senare versioner av Rights Management SDK.A: No, manifests are no longer needed for the 3.0 and later versions of the Rights Management SDK.

AndroidAndroid

Fråga: Vilka utvecklingsmiljöer har SDK har testats med?Q: Which development environments has the SDK been tested with?

Svar: Eclipse Juno med Google API 15 och senare.A: Eclipse Juno using Google API 15 and above.

Fråga: Kan jag anropa cancel() med en cancel-metod från gränssnittstråden?Q: Can I call cancel() a cancel method from the UI thread? Svar: Du bör anropa cancel() från en icke-gränssnittstråd, eftersom anropet kan inaktivera en nätverksanslutning.A: You should call cancel() from a non-UI thread, as it may abort network a connection.

iOSiOS

Fråga: Vilka plattformar har kontrollerats för SDK-utveckling?Q: Which platforms were verified for SDK development?

A: Xcode 5.0 med iOS 7 och senare.A: Xcode 5.0 with iOS 7 and later.

Fråga: Jag anropade en metod för cancel() för en åtgärd, men jag fick ändå ett meddelande om att åtgärden har slutförts.Q: I called a cancel() method on an operation, however I still got notification that the operation completed. Varför?Why?

Svar: Det går inte att avbryta alla åtgärder, så en åtgärd för att avbryta utförs om möjligt.A: Not all operations can be canceled, so a cancellation operation is executed as best as is possible.

OS xOS x

F: exempel programmet Framework är anpassat till Xcode 5, kan jag arbeta med Xcode 4,6?Q: Sample app framework is adapted to Xcode 5, can I work with Xcode 4.6?

Svar: OS X SDK fungerar enbart med Xcode 4.6 och senare, samt OS X 10.8 och senare.A:The OS X SDK works with Xcode 4.6 and later only, as well as OS X 10.8 and later.