Add the SDK to Your App

View this page for | |

The recommended development environment is:

  • Apple Xcode® (latest available version)
  • The minimum target version supported by the SDK is iOS 12.0

The following are recommended XCode secure-coding compiler settings:

  • Debugging symbols stripped (release binary) - build setting
  • Automatic Reference Counting (ARC) memory management - build setting
  • Stack Canary – buffer overflow protection

    • "-fstack-protector-all" (Other C Flags)

    For further information, go to https://developer.apple.com/forums/thread/104048

  • Position Independent Executable (PIE) to enable full ASLR for binary - set Generate Position-Dependent Code to NO

    • For further information, go to https://developer.apple.com/library/archive/qa/qa1788/_index.html

  • Stack smashing protection is activated with PIE and "-fstack-protector-all" (Other C Flags)

The SDK does not support the Apple “sharing access to keychain items among a collection of apps” feature. Sharing access to keychain items between several apps will lead to irrecoverable errors.

For further information about the feature, go to https://developer.apple.com/documentation/security/keychain_services/keychain_items/sharing_access_to_keychain_items_among_a_collection_of_apps.

Use the SDK v5.5/5.5.1 in your App

The HID Approve SDK is delivered as a dynamic framework (HID_Approve_SDK.framework). It is available in the iOS/Libraries/Device folder of the delivery package.

In order to facilitate testing during the development process, an additional SDK framework binary is also provided for the x86_64 simulator architecture. It is available in the iOS/Libraries/Simulator folder of the delivery package.

  1. Copy the framework library (content of the iOS/Libraries/Device folder) to your preferred libraries location (<HIDLIBPATH>), and add it to your project’s libraries search path.
  2. In your Xcode target build phases, link and embed the framework.

Use the SDK v5.5.2 in your App

The HID Approve SDK is delivered as a XCFramework bundle (HID_Approve_SDK.xcframework). It is available in the iOS/Libraries folder of the delivery package.

In order to facilitate testing during the development process, this XCFramework bundle also provides the iOS simulator binaries.

  1. Copy the XCFramework bundle (content of the iOS/Libraries folder) to your preferred libraries location.
  2. In your Xcode target, add the XCFramework bundle to your project Frameworks, Libraries and embedded contents setting.

Add Functions to your App