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

  1. Navigate to your project's Frameworks folder.
  2. Delete the following files:
    • AccuantCamera.xcframework
    • AcuantCommon.xcframework
    • AcuantFaceCapture.xcframework
    • AcuantImagePreparation.xcframework
    • AcuantPassiveLiveness.xcframework
    • ScanForensicsPlus.xcframework
    • TesseractOCR.xcframework

Step 2: Remove References in XCode

  1. 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).
  2. 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.
  3. Go to Build Phases:

    • With the target selected, click on the Build Phases tab at the top of the editor.
  4. Modify Frameworks, Libraries, and Embedded Content:

    • In the Build Phases section, find Frameworks, Libraries, and Embedded Content.
  5. 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
  6. Verify Removal:

    • Ensure that all references to the above frameworks have been removed from the list.

Step 3: Update Import Statements

  1. 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"
      

Step 4: Add Swinject Dependency via Swift Package Manager

  1. Open Swift Package Manager:

    • In XCode, select File > Add Packages.
  2. Add Swinject Package:

    • Enter the following URL in the package repository URL field:
      https://github.com/Swinject/Swinject.git
      
  3. Select Swinject:

    • Make sure to select only the Swinject package. Do not add Swinject-Dynamic.
  4. Add the Package:

    • Click Add Package to include it in your project.

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.