Skip to main content
Version: 27.1.3


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 folder Skillz.framework. Select your project target and click + under Frameworks, Libraries, and Embedded Content. Select Add Other... -> Add Files... and navigate to the Skillz.framwork folder and click Open.


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

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 10.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.


  1. Verify Tech Requirements
  2. Get Game ID from Skillz Developer Console
  3. Install the SDK
  4. Build and Test
  5. Implement the Skillz Delegate
  6. Initialize Skillz
  7. Launch Skillz
  8. Exit Skillz
  9. Build and Test
  10. Launch Gameplay
  11. Submit the Score
  12. End Replay
  13. Return to Skillz
  14. Implement Score Reporting Fallback
  15. Handle Incomplete Matches
  16. Build and Test