Skip to main content


This article will walk you through installing the Skillz SDK in your native iOS project.


If you are developing in Unity, follow the Unity instructions, instead.

1. Download the Skillz SDK

The latest version of the Skillz SDK for Unity can be found at the Downloads section of the Skillz Developer Console. Decompress the downloaded file.

2. Add the Skillz SDK to the Xcode Project

Inside the decompressed SDK archive you will find the folders Skillz.framework and GeocomplySDKs. Select your project target and click + under Frameworks, Libraries, and Embedded Content. Select Add Other... -> Add Files... and navigate to the Skillz.framework folder and click Open. Repeat these steps for the GeocomplySDKs folder.


If you click and drag Skillz.framework into your project, make sure that the Create groups option is selected.

On the General tab, verify the Skillz.framework , GeoComplySDK.xcframework , GeoComplySDK280.xcframework, and GCSDKDomain.xcframework are listed under Frameworks, Libraries, and Embedded Content and toggle to Embed & Sign if not already set.

Skillz.framework contains everything needed for Skillz to operate. Your project should now contain the Skillz SDK.

3. Set the Deployment Target

Edit the project build settings by double clicking on your project’s root entry and selecting the General tab. Deployment Target must be 12.0 (the minimum iOS version the Skillz SDK is compatible with) or higher.

Deployment Target

4. Update Embed Binaries Build Step

The framework will need to be embedded in your app via Xcode’s Embed Binaries build setting. This setting can be found under the General settings page of your app target.

Skillz.framework should then be listed under both the Link Binary With Libraries build phases step, and the new Embed Frameworks build step as seen below. Make sure Code Sign on Copy is checked.


This error will occur if Code Sign on Copy is not checked

5. Add the Skillz Run Script

The final configuration step is to add a Skillz specific script to the Build Phases of your project.

Go into your project target in Xcode. Select the Build Phases section and click the + sign to add a New Run Script Phase.

Confirm the shell is set to /bin/sh and paste the following in the box,

if [ -e "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/Skillz.framework/" ]; then
/bin/sh "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/Skillz.framework/"

Ensure that this run script is the last item in Build Phases.

This script will add a standard NSLocationWhenInUseUsageDescription property to your project’s Info.plist if it isn’t already present. If this property already exists, we recommend updating the description string to reflect that cash gameplay requires location information for legal reasons.

6. Build and Run

Make sure the project builds successfully.

It is suggested to build and run the project to resolve any remaining conflicts or issues prior to further Skillz implementation. Once the project has been tested, you're ready to implement the Skillz UI.