[v2.6.0] - 11/03/2021

----------------------------
* Fixes related to background tasks on embedded-signing.
* Removed legacy auth methods in `DSMManager`. The deprecated methods are `loginWithEmail:password:integratorKey:host:completion` and `loginWithApiPassword:accountId:userId:username:email:host:integratorKey:completion`.

CHANGELOG.md

@@ -1,5 +1,13 @@
 # DocuSign Native iOS SDK Changelog
 
+## [v2.6.0] - 11/03/2021
+
+### Fixed
+* Fixes related to background tasks on embedded-signing.
+
+### Removed
+* Removed legacy auth methods in `DSMManager`. The deprecated methods are `loginWithEmail:password:integratorKey:host:completion` and `loginWithApiPassword:accountId:userId:username:email:host:integratorKey:completion`.
+
 ## [v2.5.3] - 09/09/2021
 
 ### Added

DocuSign.podspec

@@ -3,7 +3,7 @@
 
 Pod::Spec.new do |s|
   s.name             = 'DocuSign'
-  s.version          = '2.5.3'
+  s.version          = '2.6.0'
   s.summary          = 'DocuSign Native iOS Framework to sign and send in your iOS apps'
 
   s.description      = <<-DESC
@@ -27,5 +27,5 @@ Pod::Spec.new do |s|
   s.vendored_frameworks = 'DocuSignSDK.xcframework'
   s.resource   = 'DocuSignSDK.xcframework/**/DocuSignSDK.bundle'
   # Update the source path for new release
-  s.source = { :http => "https://github.com/docusign/native-ios-sdk/raw/release/2.5.3/DocuSignSDK.zip"}
+  s.source = { :http => "https://github.com/docusign/native-ios-sdk/raw/release/2.6/DocuSignSDK.zip"}
 end

DocuSignSDK.xcframework/Info.plist

@@ -6,32 +6,32 @@
 	<array>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_armv7</string>
+			<string>ios-arm64_i386_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>DocuSignSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>armv7</string>
+				<string>i386</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_i386_x86_64-simulator</string>
+			<string>ios-arm64_armv7</string>
 			<key>LibraryPath</key>
 			<string>DocuSignSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>i386</string>
-				<string>x86_64</string>
+				<string>armv7</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

DocuSignSDK.xcframework/ios-arm64_armv7/DocuSignSDK.framework/Headers/DSMManager.h

@@ -101,6 +101,7 @@ NS_ASSUME_NONNULL_BEGIN
 /*!
  @method loginWithAccessToken
  @brief Sets up DocuSign user account for SDK usage in OAuth case. For a logged in account, `userinfo` endpoint can be used to fetch additional information. Further details on `userinfo` can be found at: https://developers.docusign.com/platform/auth/reference/user-info/
+ For a Migration guide please refer to https://www.docusign.com/blog/developers/september-2022-oauth2-required
  @param accessToken  DocuSign oAuthToken (JWT)
  @param accountId  DocuSign accountId of the user using SDK for sign and send
  @param userId  DocuSign userId of the user using SDK for sign and send
@@ -120,46 +121,6 @@ NS_ASSUME_NONNULL_BEGIN
                integratorKey:(NSString *)integratorKey
                   completion:(void(^)(DSMAccountInfo *_Nullable accountInfo, NSError *_Nullable error))completion;
 
-/*!
- @method loginWithEmail
- @brief [Deprecated] Sets up DocuSign user account for SDK usage. Only supported login mode is online. Further details on auth update can be found at: https://developers.docusign.com/platform/auth/migrate/
- @param email  DocuSign username (email) of the user using SDK for sign and send
- @param password  DocuSign password of the user using SDK for sign and send
- @param integratorKey DocuSign integratorKey for the client application
- @param host DocuSign host where user is signed up with DocuSign (e.g. "https://demo.docusign.net/restapi")
- @param completion block to be executed after user account is setup
- @see DSMAccountInfo.h
- */
-+ (void)loginWithEmail:(NSString *)email
-              password:(NSString *)password
-         integratorKey:(NSString *)integratorKey
-                  host:(NSURL *)host
-            completion:(void(^)(DSMAccountInfo *_Nullable accountInfo, NSError *_Nullable error))completion
-    DEPRECATED_MSG_ATTRIBUTE("use loginWithAccessToken:accountId:userId:userName:email:host:integratorKey:completion");
-
-/*!
- @method loginWithApiPassword
- @brief [Deprecated] Sets up DocuSign user account for SDK usage in OAuth case.  Further details on auth update can be found at: https://developers.docusign.com/platform/auth/migrate/
- @param apiPassword  DocuSign apiPassword
- @param accountId  DocuSign accountId of the user using SDK for sign and send
- @param userId  DocuSign userId of the user using SDK for sign and send
- @param userName  DocuSign username of the user using SDK for sign and send
- @param email  DocuSign registered email Id of the user using SDK for sign and send
- @param host  DocuSign host where user is signed up with DocuSign (e.g. "https://demo.docusign.net/restapi")
- @param integratorKey DocuSign integratorKey for the client application
- @param completion block to be executed after user account is setup
- @see DSMAccountInfo.h
- */
-+ (void)loginWithApiPassword:(NSString *)apiPassword
-                   accountId:(NSString *)accountId
-                      userId:(NSString *)userId
-                    userName:(NSString *)userName
-                       email:(NSString *)email
-                        host:(NSURL *)host
-               integratorKey:(NSString *)integratorKey
-                  completion:(void(^)(DSMAccountInfo *_Nullable accountInfo, NSError *_Nullable error))completion
-    DEPRECATED_MSG_ATTRIBUTE("use loginWithAccessToken:accountId:userId:userName:email:host:integratorKey:completion");
-
 /*!
  @method fetchSettingsWithAccountInfo
  @brief Fetch additional data for a given account that includes account & user settings with consumer disclosure.

DocuSignSDK.xcframework/ios-arm64_armv7/DocuSignSDK.framework/Headers/DSMNotificationCodes.h

@@ -8,7 +8,7 @@
 #pragma mark notification name
 
 /*!
- * @brief Notification sent when envelope signing is completed in online or offline mode by all current signers.
+ * @brief Notification sent when envelope signing is completed in online or offline mode by all current signers. In case of offline signing the envelope will be ready for syncing after `DSMEnvelopeCachedNotification` is sent.
  * @discussion Returned userInfo contains signingMode associated with DSMSigningModeKey and templateId associated with DSMTemplateIdkey. Returned userInfo also contains envelopeId associated with DSMEnvelopeIdKey only when online signing; during offline signing, envelopeId for signed envelope is sent with DSMEnvelopeCachedNotification.
  * Conforming to DSMEnvelopesManagerOfflineSigningDelegate allows client apps to receive callback events associated with recipient selection or individual recipient events for start and finish offline signing.
  * This can be posted on a thread other than MainThread.
@@ -35,7 +35,7 @@ extern NSString * const DSMSigningCancelledNotification;
  */
 extern NSString * const DSMEnvelopeOnlineSendFailedNotification;
 /*!
- * @brief Notification sent when caching is enabled for a given record (envelope).
+ * @brief Notification sent when caching is enabled for a given record (envelope). An envelope is cached when a signer finishes offline signing or saves the progress and exits the signing process. 
  * @discussion Returned userInfo contains envelopeId associated with DSMEnvelopeIdKey, templateId associated with DSMTemplateIdKey. This can be posted on a thread other than MainThread.
  * [[NSNotificationCenter defaultCenter] postNotificationName:DSMEnvelopeCachedNotification object:nil userInfo:userInfo];
  * Note: Enabling setup configuration `DSM_SETUP_ENABLE_OFFLINE_SIGNING_SAVE_ENVELOPE_PROGRESS_KEY` would result in this notification being sent every time a local offline envelope is saved after local signer finishes signing.

DocuSignSDK.xcframework/ios-arm64_i386_x86_64-simulator/DocuSignSDK.framework/Headers/DSMManager.h

@@ -101,6 +101,7 @@ NS_ASSUME_NONNULL_BEGIN
 /*!
  @method loginWithAccessToken
  @brief Sets up DocuSign user account for SDK usage in OAuth case. For a logged in account, `userinfo` endpoint can be used to fetch additional information. Further details on `userinfo` can be found at: https://developers.docusign.com/platform/auth/reference/user-info/
+ For a Migration guide please refer to https://www.docusign.com/blog/developers/september-2022-oauth2-required
  @param accessToken  DocuSign oAuthToken (JWT)
  @param accountId  DocuSign accountId of the user using SDK for sign and send
  @param userId  DocuSign userId of the user using SDK for sign and send
@@ -120,46 +121,6 @@ NS_ASSUME_NONNULL_BEGIN
                integratorKey:(NSString *)integratorKey
                   completion:(void(^)(DSMAccountInfo *_Nullable accountInfo, NSError *_Nullable error))completion;
 
-/*!
- @method loginWithEmail
- @brief [Deprecated] Sets up DocuSign user account for SDK usage. Only supported login mode is online. Further details on auth update can be found at: https://developers.docusign.com/platform/auth/migrate/
- @param email  DocuSign username (email) of the user using SDK for sign and send
- @param password  DocuSign password of the user using SDK for sign and send
- @param integratorKey DocuSign integratorKey for the client application
- @param host DocuSign host where user is signed up with DocuSign (e.g. "https://demo.docusign.net/restapi")
- @param completion block to be executed after user account is setup
- @see DSMAccountInfo.h
- */
-+ (void)loginWithEmail:(NSString *)email
-              password:(NSString *)password
-         integratorKey:(NSString *)integratorKey
-                  host:(NSURL *)host
-            completion:(void(^)(DSMAccountInfo *_Nullable accountInfo, NSError *_Nullable error))completion
-    DEPRECATED_MSG_ATTRIBUTE("use loginWithAccessToken:accountId:userId:userName:email:host:integratorKey:completion");
-
-/*!
- @method loginWithApiPassword
- @brief [Deprecated] Sets up DocuSign user account for SDK usage in OAuth case.  Further details on auth update can be found at: https://developers.docusign.com/platform/auth/migrate/
- @param apiPassword  DocuSign apiPassword
- @param accountId  DocuSign accountId of the user using SDK for sign and send
- @param userId  DocuSign userId of the user using SDK for sign and send
- @param userName  DocuSign username of the user using SDK for sign and send
- @param email  DocuSign registered email Id of the user using SDK for sign and send
- @param host  DocuSign host where user is signed up with DocuSign (e.g. "https://demo.docusign.net/restapi")
- @param integratorKey DocuSign integratorKey for the client application
- @param completion block to be executed after user account is setup
- @see DSMAccountInfo.h
- */
-+ (void)loginWithApiPassword:(NSString *)apiPassword
-                   accountId:(NSString *)accountId
-                      userId:(NSString *)userId
-                    userName:(NSString *)userName
-                       email:(NSString *)email
-                        host:(NSURL *)host
-               integratorKey:(NSString *)integratorKey
-                  completion:(void(^)(DSMAccountInfo *_Nullable accountInfo, NSError *_Nullable error))completion
-    DEPRECATED_MSG_ATTRIBUTE("use loginWithAccessToken:accountId:userId:userName:email:host:integratorKey:completion");
-
 /*!
  @method fetchSettingsWithAccountInfo
  @brief Fetch additional data for a given account that includes account & user settings with consumer disclosure.

DocuSignSDK.xcframework/ios-arm64_i386_x86_64-simulator/DocuSignSDK.framework/Headers/DSMNotificationCodes.h

@@ -8,7 +8,7 @@
 #pragma mark notification name
 
 /*!
- * @brief Notification sent when envelope signing is completed in online or offline mode by all current signers.
+ * @brief Notification sent when envelope signing is completed in online or offline mode by all current signers. In case of offline signing the envelope will be ready for syncing after `DSMEnvelopeCachedNotification` is sent.
  * @discussion Returned userInfo contains signingMode associated with DSMSigningModeKey and templateId associated with DSMTemplateIdkey. Returned userInfo also contains envelopeId associated with DSMEnvelopeIdKey only when online signing; during offline signing, envelopeId for signed envelope is sent with DSMEnvelopeCachedNotification.
  * Conforming to DSMEnvelopesManagerOfflineSigningDelegate allows client apps to receive callback events associated with recipient selection or individual recipient events for start and finish offline signing.
  * This can be posted on a thread other than MainThread.
@@ -35,7 +35,7 @@ extern NSString * const DSMSigningCancelledNotification;
  */
 extern NSString * const DSMEnvelopeOnlineSendFailedNotification;
 /*!
- * @brief Notification sent when caching is enabled for a given record (envelope).
+ * @brief Notification sent when caching is enabled for a given record (envelope). An envelope is cached when a signer finishes offline signing or saves the progress and exits the signing process. 
  * @discussion Returned userInfo contains envelopeId associated with DSMEnvelopeIdKey, templateId associated with DSMTemplateIdKey. This can be posted on a thread other than MainThread.
  * [[NSNotificationCenter defaultCenter] postNotificationName:DSMEnvelopeCachedNotification object:nil userInfo:userInfo];
  * Note: Enabling setup configuration `DSM_SETUP_ENABLE_OFFLINE_SIGNING_SAVE_ENVELOPE_PROGRESS_KEY` would result in this notification being sent every time a local offline envelope is saved after local signer finishes signing.