Skip to content

Commit

Permalink
Merge pull request #397 from onfido/release/30.2.0
Browse files Browse the repository at this point in the history
Release 30.2.0
  • Loading branch information
bckr authored Jun 12, 2024
2 parents 4f6f9b1 + ff0690c commit 993a22d
Show file tree
Hide file tree
Showing 7 changed files with 226 additions and 62 deletions.
31 changes: 22 additions & 9 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand All @@ -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

Expand Down Expand Up @@ -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

Expand All @@ -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
Expand All @@ -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
Expand All @@ -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

Expand Down
15 changes: 11 additions & 4 deletions MIGRATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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).


Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down
20 changes: 10 additions & 10 deletions ONFIDO_STUDIO.md
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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

Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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` |

Expand All @@ -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 [[email protected]](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

Expand All @@ -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")
Expand All @@ -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

Expand Down Expand Up @@ -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

Expand All @@ -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).
4 changes: 2 additions & 2 deletions Package.swift
Original file line number Diff line number Diff line change
Expand Up @@ -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"
),


Expand Down
Loading

0 comments on commit 993a22d

Please sign in to comment.