Install the SDK on iOS

In this guide, you will learn how to get started with the Genius Scan SDK for iOS.

Overview

The SDK for iOS is provided as a self-contained binary iOS framework GSSDK.xcframework. You can add it to your project with Swift Package Manager or embed the framework directly in your app.

Size of the SDK

The SDK framework file used during development may seem large, but it includes slices for all device architectures (arm64, x86_64) and debug symbols. When deployed on your users’ devices, the impact is much smaller.

The table below shows the approximate impact of the SDK on your app’s size. The download size represents the increase in your app’s size when downloaded by users. The installed size represents the size of the SDK once installed on the user’s device.

Because the Genius Scan SDK is provided as a dynamic framework placed in your app’s bundle, the App Store’s delta update logic will skip downloading it if you update your app without updating the Genius Scan SDK.

Setup

Requirements

Set your app deployment target to iOS 15.0 or later.

Integrating the framework

Manually

Drag and drop GSSDK.xcframework into the Frameworks, Libraries and Embedded Content of your app’s target.

With Swift Package Manager

In your Xcode project, under Package Dependencies, add a new dependency on the Genius Scan SDK https://github.com/thegrizzlylabs/geniusscan-sdk-spm and select the GSSDK product.

1. Select your Project and click on ‘+’ to add a Package:
2. Type in the URL of the Genius Scan SDK Swift Package repository: https://github.com/thegrizzlylabs/geniusscan-sdk-spm, select the package and click ‘Add Package’:
3. In Dependency Rule, choose Exact Version and enter 6.0.0-beta11.
4. Select the target that will use the SDK:

Import the SDK

import GSSDK

Configure your app

Your app will need the user’s permission to access the camera. You must specify the reason for requesting this permission by adding the NSCameraUsageDescription key to your Info.plist file.

What’s Next?

Next, configure a license key. To compare with a working integration, see the sample apps.