Getting Started

Installation and Initialization

Requirements

• iOS 13+

• Xcode 14+

• A smile_config.json file form https://portal.usesmileid.com/sdk

Installation

Swift Package Manager

1. In Xcode, select File > Add Packages… and enter https://github.com/smileidentity/ios

2. Select the latest version number from our release page and click add package

CocoaPods

• If you haven’t already, install the latest version of CocoaPods.

• If you don’t have an existing Podfile, run the following command to create one:

$ pod init

• Add this line to your Podfile:

pod 'SmileID'

• Run the following command:

$ pod install

• Make sure to use the .xcworkspace file to open your project in Xcode, instead of the .xcodeproj file subsequently

Smile Config

Drag the into your projects file inspector and ensure that the file is added to your app's target. Confirm that it is by checking the Copy Bundle Resources drop down in the Build Phases tab as shown below.

Initialization

Initialize the SDK as early as possible. This can be done either in your AppDelegate's application(_:didFinishLaunchingWithOptions:) method or the SceneDelegate scene(_:willConnectTo:options:) depending on your app's structure.

AppDelegate.swift

class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions
                     launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        let config = try? Config(url: Constant.configUrl)
        SmileID.initialize(config: config)
        return true
    }
}

Callback URL

To set the callback URL used for jobs (to deliver results to your own server), use the setCallbackUrl method

SmileID.setCallbackUrl(url: URL(string: "https://www.google.com"))

Usage

All products are implemented in SwiftUI and are therefore exposed as SwiftUI views. If your project is implemented in UIKit, you can still use the SwiftUI views by embedding them in a UIHostingController and presenting or pushing the views using UIKit's ViewController presentation mechanisms.

Networking

The products screens handle performing network requests for you. However, you can also submit data to the API directly using SmileID.api , an instance of SmileIDService.

Submitting to the App Store

The Smile ID SDK for iOS uses the TrueDepth API. As a result, you must declare this API usage to Apple when submitting your iOS app for review to the App Store. Here is the relevant information you may be asked to provide:

What information is your app collecting

We use ARKit to capture face 3D spatial orientation and facial expressions.

For what purposes are you collecting this information

We use this data to ensure the selfie being taken is of a live user for authentication and fraud reduction purposes.

Will the data be shared with any third parties

The ARKit information is processed entirely locally and the spatial orientation/facial expression data is not submitted to any third (or first) parties