Installation

To get started, extract the .xcframework files from the Frameworks directory in the zip file.

Framework Files

1. In Xcode, open your project and select your app target.
2. In the General tab, find the section called ‘Frameworks, Libraries, and Embedded Content’. Add the frameworks to the project by clicking the + button at the bottom of that section.
3. Select ‘Add Other…’ from the drop down menu in the bottom of the popup and then click ‘Add Files…’.
4. Find and select the Validic frameworks that you want to add to the project and click ‘Open’. Make sure to use the .xcframework files from the Validic release zip and remove any older .framework files you may have installed already. See the Migration Guide on Installation for details.

To confirm the files were added correctly, you can check the target’s ‘Build Phases’ tab. You should see each framework listed in the ‘Link Binary With Libraries’ section (with status ‘Required’), and in ‘Embed Frameworks’ with the ‘Code Sign On Copy’ box checked.

Bridging with Swift

To use the frameworks with Swift, you will need to add a Bridging Header. In Xcode go to the File menu and under New select File (Cmd+N). In the New File dialog box choose ‘Header File’. Name the header file [ProjectName]-Bridging-Header.h.

Edit ProjectName-Bridging-Header.h and add the following lines:

#import <ValidicCore/ValidicCore.h>
#import <ValidicBluetooth/ValidicBluetooth.h>
#import <ValidicHealthKit/ValidicHealthKit.h>
#import <ValidicOCR/ValidicOCR.h>

Then go to the build settings of your target, search for the Swift Compiler section, and double click on the ‘Objective-C Bridging Header’ field. In the dialog box that appears enter the name of the bridging header file ProjectName-Bridging-Header.h.