Merge pull request #397 from onfido/release/30.2.0

Release 30.2.0

CHANGELOG.md

@@ -6,6 +6,19 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 **Note**: If the strings translations change it will result in a MINOR version change, therefore you are responsible for testing your translated layout in case you are using custom translations. [More on language localisation](README.md#language-customisation)
 
+## [30.2.0] - 2024-05-23
+
+### Added
+
+- Added withNFC(off, optional, required) to configure NFC
+- Deprecated disableNFC() use withNFC(.off) instead
+
+### Fixed
+
+- Fixed very rare crash that could occur when starting a recording on Video
+- Fixed error while passing multiple public keys to the certificate pinning API
+- Fixed crash while using Objective-C API
+
 ## [30.1.0] - 2024-05-16
 
 ### Added
@@ -698,7 +711,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Changed
 
 - UI: Now primary button is retake and secondary is confirm on capture confirmation screen when warning present
-- Made some improvements around video recording logic to prevent several crash issues which have been reported on github. [Issue 1](https://github.com/onfido/onfido-ios-sdk/issues/220), [Issue 2](https://github.com/onfido/onfido-ios-sdk/issues/222). Those issues are: https://github.com/onfido/onfido-ios-sdk/issues/227
+- Made some improvements around video recording logic to prevent several crash issues which have been reported on github. 
 
 ### Fixed
 
@@ -892,7 +905,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Fixed
 
-- Fixed bundle localisation issue. [Related Github issue](https://github.com/onfido/onfido-ios-sdk/issues/162)
+- Fixed bundle localisation issue.
 
 ## [18.3.2] - 2020-08-06
 
@@ -902,18 +915,18 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Fixed
 
-- UI: Fix the problem about having buttons in different height. [Github Issue](https://github.com/onfido/onfido-ios-sdk/issues/169)
+- UI: Fix the problem about having buttons in different height.
 - Fixed localisation language selection when app and device preferred language is not supported by Bundle
 
 ## [18.3.1] - 2020-07-27
 
 ### Fixed
 
-- Fix for sending duplicate VIDEO_FACIAL_CAPTURE_CONFIRMATION analytic event.[Related github issue](https://github.com/onfido/onfido-ios-sdk/issues/167)
+- Fix for sending duplicate VIDEO_FACIAL_CAPTURE_CONFIRMATION analytic event.
 - Improved memory usage
 - UI: Fixed the camera load problem in some specific cases
 - UI: Fixed incorrect VoiceOver focus on video capture intro video
-- UI: Fixed error problem user taps shutter button right after presenting SDK.[Related github issue](https://github.com/onfido/onfido-ios-sdk/issues/168)
+- UI: Fixed error problem user taps shutter button right after presenting SDK.
 
 ## [18.3.0] - 2020-07-03
 
@@ -981,7 +994,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Added
 
 - Added German as supported language
-- Added document format option for document capture step. Also changed the way to configure document capture step. Please check [README]('https://github.com/onfido/onfido-ios-sdk/blob/18.0.0/README.md#document-type-configuration') for the details
+- Added document format option for document capture step. Also changed the way to configure document capture step. Please check [README](https://github.com/onfido/onfido-ios-sdk/blob/18.0.0/README.md#document-type-configuration) for the details
 - Added integrator defined event hook to allow integrators to collect user analytics
 - UI: Added icon to differentiate document back capture from front capture
 
@@ -992,7 +1005,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Fixed
 
-- Fixed the Localizable.strings not updated problem.[See]('https://github.com/onfido/onfido-ios-sdk/issues/144')
+- Fixed the Localizable.strings not updated problem.
 - UI: Fixed missing right margin issue on selfie intro screen
 - UI: Fixed alert text cut off in some scenarios
 - UI: Fixed the text cut-off issue on liveness capture screen
@@ -1006,7 +1019,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Changed
 
 - UI: Now using grey Onfido logo with higher contrast for accessibility
-- Now using [API v3](https://documentation.onfido.com/v3/) for communication with the backend.
+- Now using [API v3](https://documentation.onfido.com/api/3.0.0/) for communication with the backend.
 - UI: Now only detecting glare on rectangles of ID1 size on US DL autocapture
 - UI: Now auto capturing non-blurry US DL only
 - Updated bubble view design and updated barcode not readable copy
@@ -1027,7 +1040,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Fixed folded paper document on back capture loading lag issue
 - UI: Fixed selfie capture text truncated when large text size used
 - UI: Fixed Arabic country name endonyms
-- Fixed warning about missing umbrella header (https://github.com/onfido/onfido-ios-sdk/issues/131)
+- Fixed warning about missing umbrella header
 
 ## [16.2.0] - 2020-02-24
 

MIGRATION.md

@@ -2,6 +2,7 @@
 
 These guides below are provided to ease the transition of existing applications using the Onfido SDK from one version to another that introduces breaking API changes.
 
+* [Onfido iOS SDK 30.2.0 Migration Guide](#onfido-ios-sdk-3020-migration-guide)
 * [Onfido iOS SDK 30.0.0 Migration Guide](#onfido-ios-sdk-3000-migration-guide)
 * [Onfido iOS SDK 29.9.0 Migration Guide](#onfido-ios-sdk-2990-migration-guide)
 * [Onfido iOS SDK 29.6.0 Migration Guide](#onfido-ios-sdk-2960-migration-guide)
@@ -67,6 +68,12 @@ These guides below are provided to ease the transition of existing applications
 * [Onfido iOS SDK 4.0.0 Migration Guide](#onfido-sdk-400-migration-guide)
 * [Onfido iOS SDK 3.0.0 Migration Guide](#onfido-sdk-300-migration-guide)
 
+## Onfido iOS SDK 30.2.0 Migration Guide
+
+### Deprecated API Changes
+
+- Deprecated `disableNFC()` use `withNFC(.off)` instead
+
 ## Onfido iOS SDK 30.0.0 Migration Guide
 
 ### Breaking API Changes
@@ -95,7 +102,7 @@ Due to a change introduced by Apple in March 2023 with iOS v16.0, PACE-only docu
 PACE is an optional authentication protocol used by some identity documents during NFC processing. All passports support BAC which is still supported by both iOS and the Onfido iOS SDK.
 
 Impact:
-- None: all currently [supported NFC documents](https://developers.onfido.com/guide/supported-documents-nfc#pacific) can still be read by the Onfido iOS SDK, including the documents that support both BAC and PACE as authentication methods (e.g. French passport, Dutch national ID card, Polish ID card).
+- None: all currently [supported NFC documents](https://documentation.onfido.com/guide/supported-documents-nfc) can still be read by the Onfido iOS SDK, including the documents that support both BAC and PACE as authentication methods (e.g. French passport, Dutch national ID card, Polish ID card).
 - CAN-entry: As CAN (Card Authentication Number) is only required for PACE Authentication, for documents require the user to enter the CAN, those screens will no longer be shown but the NFC read will proceed with BAC (which is based on the extracted MRZ).
 
 
@@ -481,7 +488,7 @@ The following string keys have been **removed**:
 
 ### Breaking API changes
 
-- The way to configure SDK for document capture step has changed. To see instructions and usage examples please check out [README]('https://github.com/onfido/onfido-ios-sdk/blob/28.0.0/README.md#document-step') page.
+- The way to configure SDK for document capture step has changed. To see instructions and usage examples please check out [README](https://documentation.onfido.com/sdk/ios/28.0.0/#document-step) page.
 
 ## Onfido iOS SDK 27.2.0 Migration Guide
 
@@ -1216,7 +1223,7 @@ The following string keys have been **changed**:
 
 ### Breaking API Changes
 
-- Now SDK sends selected document country information to the backend. If an incorrect country value has been set when configuring the Document step [see documentation]('https://github.com/onfido/onfido-ios-sdk/#configuring-country'), SDK will throw an error during document upload
+- Now SDK sends selected document country information to the backend. If an incorrect country value has been set when configuring the Document step [see documentation](https://github.com/onfido/onfido-ios-sdk/#configuring-country), SDK will throw an error during document upload
 
 ## Onfido iOS SDK 18.10.0 Migration Guide
 
@@ -1483,7 +1490,7 @@ The following string keys have been **removed**:
 
 ### Breaking API Changes
 
-- The way to configure SDK for document capture step has changed. To see instructions and usage examples please check out [README]('https://github.com/onfido/onfido-ios-sdk/blob/18.0.0/README.md#document-type-configuration') page.
+- The way to configure SDK for document capture step has changed. To see instructions and usage examples please check out [README](https://github.com/onfido/onfido-ios-sdk/blob/18.0.0/README.md#document-type-configuration) page.
 
 ## Onfido iOS SDK 17.0.0 Migration Guide
 

ONFIDO_STUDIO.md

@@ -1,5 +1,5 @@
 ## Overview
-[Onfido Studio](https://developers.onfido.com/guide/onfido-studio-product) is a drag and drop interface enabling you to build an optimised route to verify each end user, by defining and configuring different paths, as well as incorporating a combination of signals, in a single identity verification flow.
+[Onfido Studio](https://documentation.onfido.com/getting-started/onfido-studio-product) is a drag and drop interface enabling you to build an optimised route to verify each end user, by defining and configuring different paths, as well as incorporating a combination of signals, in a single identity verification flow.
 
 ## Integrating with iOS SDK 
 The Onfido iOS SDK provides a drop-in set of screens and tools for iOS applications to capture identity documents and selfie photos and videos for the purpose of identity verification. 
@@ -9,7 +9,7 @@ The SDK communicates directly and dynamically with active workflows to show the
 > ℹ️ 
 > 
 > The following guide will help you to integrate with Onfido Studio.
-> If you are looking for the standard integration using Onfido checks, please head to our [README](https://github.com/onfido/onfido-ios-sdk).
+> If you are looking for the standard integration using Onfido checks, please head to our [iOS reference](https://documentation.onfido.com/sdk/ios).
 
 ## Getting started 
 
@@ -45,7 +45,7 @@ Run `pod install` to install the SDK.
 
 ### 2. Build a configuration object
 
-To initiaise the SDK, you must provide a `workflowRunId`, obtained by [creating a workflow run](https://documentation.onfido.com/#create-workflow-run), and an `sdkToken`, obtained by [generating an SDK token](https://documentation.onfido.com/#generate-sdk-token).
+To initiaise the SDK, you must provide a `workflowRunId`, obtained by [creating a workflow run](https://documentation.onfido.com/api/latest#create-workflow-run), and an `sdkToken`, obtained by [generating an SDK token](https://documentation.onfido.com/api/latest#generate-sdk-token).
 
 #### Swift
 
@@ -112,7 +112,7 @@ onfidoRun.with(responseHandler: { (response: OnfidoResponse) in
 
 | ATTRIBUTE        | NOTES           |
 | ------------- |-------------|
-| .success    | The end user completed all interactive tasks in the workflow. If you have configured [webhooks](https://documentation.onfido.com/#webhooks), a notification will be sent to your backend confirming the workflow run has finished. You do not need to create a check using your backend as this is handled directly by the Workflow.  |
+| .success    | The end user completed all interactive tasks in the workflow. If you have configured [webhooks](https://documentation.onfido.com/api/latest#webhooks), a notification will be sent to your backend confirming the workflow run has finished. You do not need to create a check using your backend as this is handled directly by the Workflow.  |
 | .error(Error)      | An unexpected error occurred.      |
 | .cancel| The flow was exited prematurely by the user. The reason can be `.userExit` or `.consentDenied`    |
 
@@ -131,9 +131,9 @@ switch response {
       case OnfidoFlowError.microphonePermission:
         // This happens when the user denies permission for microphone usage by the app during the flow
       case OnfidoFlowError.upload(let OnfidoApiError):
-        // This happens when the SDK receives an error from an API call see [https://documentation.onfido.com/#errors](https://documentation.onfido.com/#errors) for more information
+        // This happens when the SDK receives an error from an API call see [https://documentation.onfido.com/api/latest#errors](https://documentation.onfido.com/api/latest#errors) for more information
       case OnfidoFlowError.exception(withError: let error, withMessage: let message):
-        // This happens when an unexpected error occurs. Please contact [ios-sdk@onfido.com](mailto:ios-sdk@onfido.com?Subject=ISSUE%3A) when this happens
+        // This happens when an unexpected error occurs. Please contact [Customer Support](mailto:support@onfido.com) when this happens
       case OnfidoFlowError.versionInsufficient:
         // This happens when you are using an older version of the iOS SDK and trying to access a new functionality from workflow. You can fix this by updating the SDK
 
@@ -144,7 +144,7 @@ switch response {
 
 ## UI Customization
 
-The iOS SDK supports the customization of colors, fonts and strings used in the SDK flow. For visualizations of the available options please see our [SDK customization guide](https://developers.onfido.com/guide/sdk-customization#ios).
+The iOS SDK supports the customization of colors, fonts and strings used in the SDK flow. For visualizations of the available options please see our [SDK customization guide](https://documentation.onfido.com/sdk/sdk-customization#ios).
 
 ```Swift
 let workflowConfiguration = WorkflowConfiguration(workflowRunId: "workflowRunId", sdkToken: "sdkToken")
@@ -153,7 +153,7 @@ let appearance = Appearance()
 workflowConfiguration.withAppearance(appearance)
 ```
 
-You can find more information on how to create an appearance object [here](https://github.com/onfido/onfido-ios-sdk#ui-customization).
+You can find more information on how to create an appearance object [here](https://documentation.onfido.com/sdk/ios/#ui-customization).
 
 ## Language Customization
 
@@ -206,7 +206,7 @@ The SDK supports and maintains the following 44 languages:
 
 The strings used within the SDK can be customized by having a `Localizable.strings` in your app for the desired language and by configuring the flow using `withCustomLocalization` method on the `WorkflowConfiguration` object.
 
-You can find the keys for the localizable strings under the [`localization`](localization) directory which contains strings files for supported languages.
+You can find the keys for the localizable strings under the [`localization`](./localization) directory which contains strings files for supported languages.
 
 #### Swift
 
@@ -215,4 +215,4 @@ let workflowConfiguration = WorkflowConfiguration(workflowRunId: "workflowRunId"
 workflowConfiguration.withCustomLocalization(withTableName: "Localizable.strings", in: Bundle.main)
 ```
 
-You can find more information on how to use a custom language [here](https://github.com/onfido/onfido-ios-sdk#custom-languages).
+You can find more information on how to use a custom language [here](https://documentation.onfido.com/sdk/ios/#custom-languages).

Package.swift

@@ -17,8 +17,8 @@ let package = Package(
 
             .binaryTarget(
                 name: "Onfido",
-                url: "https://s3-eu-west-1.amazonaws.com/onfido-sdks/ios/Onfido-v30.1.0.zip",
-                checksum: "7fb36b0894233515d03888a7af39be949646348ecc549ff94ff3dde37ec00edd"
+                url: "https://s3-eu-west-1.amazonaws.com/onfido-sdks/ios/Onfido-v30.2.0.zip",
+                checksum: "7b26b272f06ef19f4ece7b5b76d9f2e735c4cc540082641c3b40225594ebdba1"
             ),