Build Demo app


  • Latest stable xCode

Get the client token

To start working with the Banuba SDK Demo project for iOS, you need to have the client token. To receive the client token please fill in our form on website, or contact us via


Before building the xCode Demo project, place your client token inside appropriate file in the following location: src/BanubaSdk/BanubaSdkApp/BanubaSdkApp/BanubaClientToken.swift.

Client token usage example

internal let banubaClientToken = "YOUR_TOKEN_HERE"

Get the Banuba SDK archive

With the client token, you will also receive the Banuba SDK archive for iOS which contains:

  • Banuba Effect Player Framework (BanubaEffectPlayer.framework),
  • xCode project folder under src/BanubaSdk,
  • Effect examples located under effects folder.

Build the Banuba SDK Demo app

  1. Copy BanubaEffectPlayer.framework from BNBEffectPlayer/bin to src/BanubaSdk/BanubaSdkApp/BanubaSdkApp.

  2. Open src/BanubaSdk/BanubaSdk.xcworkspace in XCode.


  1. Select the target BanubaSdkApp in BanubaSdkApp project.

  2. Sign the target with your provisioning profile in Signing seciton of the target.


  1. Remove the existing reference to BanubaEffectPlayer.framework under BanubaSdkApp โ†’ General โ†’ Embedded Binaries section.


  1. Add new reference to BanubaEffectPlayer.framework from step 1.


  1. Open the tab Build Phases โ†’ Copy Bundle Resources. Replace the existing reference to effects with your effects folder. Provide a path to the right folder via Xcode.


  1. Open the project BanubaSdk and target BanubaSdk, remove the existing reference to BanubaEffectPlayer.framework under General โ†’ Linked Frameworks and Libraries section and do the same as in step 6.


  1. Open BanubaSdkApp โ†’ Scheme โ†’ Edit Scheme. On Run tab select the build configuration (debug or release):
  • debug - allows to debug and profile app in realtime,
  • release - build variant allows to test the release variant of the application (faster performance).

image image

  1. Now you can run the Banuba SDK Demo app example on your device
Last updated on