Migrating from iOS v5
This guide outlines the necessary steps to upgrade your project from the 5.x versions of the iOS SDK to the latest 6.0 version. The upgrade process involves removing certain files from your project, updating imports, adding a dependency via Swift Package Manager, and ensuring that all references to these files are also removed from your XCode project. Follow the steps below to complete the migration successfully.
Step 1: Remove Files from the Frameworks Folder
- Navigate to your project's
Frameworks
folder. - Delete the following files:
AccuantCamera.xcframework
AcuantCommon.xcframework
AcuantFaceCapture.xcframework
AcuantImagePreparation.xcframework
AcuantPassiveLiveness.xcframework
ScanForensicsPlus.xcframework
TesseractOCR.xcframework
Step 2: Remove References in XCode
-
Open Project Navigator:
- Open your XCode project.
- In the left sidebar, ensure you are in the Project Navigator view (you can select the folder icon at the top).
-
Select the Target:
- Click on your project name at the top of the Project Navigator.
- Select the appropriate target under the “PROJECT” or “TARGETS” section in the main editor.
-
Go to Build Phases:
- With the target selected, click on the
Build Phases
tab at the top of the editor.
- With the target selected, click on the
-
Modify Frameworks, Libraries, and Embedded Content:
- In the
Build Phases
section, findFrameworks, Libraries, and Embedded Content
.
- In the
-
Remove Framework References:
- Select each of the following references one by one and click the minus (“-”) button to remove them:
AccuantCamera.xcframework
AcuantCommon.xcframework
AcuantFaceCapture.xcframework
AcuantImagePreparation.xcframework
AcuantPassiveLiveness.xcframework
ScanForensicsPlus.xcframework
TesseractOCR.xcframework
- Select each of the following references one by one and click the minus (“-”) button to remove them:
-
Verify Removal:
- Ensure that all references to the above frameworks have been removed from the list.
Step 3: Update Import Statements
- Search and Replace Imports:
- In your project, search for all instances of the following import statement:
#import "ReadyRemitSDKLite/ReadyRemitSDKLite-Swift.h"
- Replace each instance with:
#import "ReadyRemitSDK/ReadyRemitSDK.h"
- In your project, search for all instances of the following import statement:
Step 4: Add Swinject Dependency via Swift Package Manager
-
Open Swift Package Manager:
- In XCode, select
File
>Add Packages
.
- In XCode, select
-
Add Swinject Package:
- Enter the following URL in the package repository URL field:
https://github.com/Swinject/Swinject.git
- Enter the following URL in the package repository URL field:
-
Select Swinject:
- Make sure to select only the
Swinject
package. Do not addSwinject-Dynamic
.
- Make sure to select only the
-
Add the Package:
- Click
Add Package
to include it in your project.
- Click
By following these steps, you can successfully migrate your project from version 5.x to version 6.0 of the iOS SDK. For further details and additional resources, please refer to the ReadyRemit developer portal: ReadyRemit Developer Portal.
Updated 4 months ago