Scaleform SDK for iOS and tvOS
The Scaleform SDK is supported on devices using iOS 8.0 and tvOS 9.0 and above.
Note: Scaleform now supports XCode 8.1.
Building the Scaleform SDK requires Xcode 6 or higher. It is recommended to use the latest available version. When building for iOS, the target --platform option to the make.rb script (as described in the 'Building Scaleform' section in SDK Installation) should be ios. When building for tvOS, the --platform option should be tvos.
To connect to Scaleform iOS apps and tvOS apps, you require valid signing credentials. Set these credentials before compiling Scaleform, otherwise builds from the command line will fail.
- Create environment variables SF_IOS_CODE_SIGN_IDENTITY and SF_IOS_DEVELOPMENT_TEAM to set signing credentials for Scaleform iOS and tvOS apps.
- Assign these variables the appropriate values for your Apple Developer account.
Note that the development team must be your Team ID, not your Team Name
- You can also run the following command from a terminal to get the signing identities available on your machine: security find-identity
First, ensure that your iOS/tvOS development platform is setup correctly before attempting to run Scaleform samples. We suggest following the iOS/tvOS setup documentation, and ensuring that its samples run correctly first.
After recompiling the Scaleform SDK,
- Load the generated solution in Xcode (Projects/<platform>/xcode/Scaleform GFx SDK.xcodeproj).
- Select the appropriate Scheme from the dropdown menu (for example, GFxPlayer/<ios/tvos device).
- Run (Command+R).
- The iOS project defaults to using the Metal renderer. If your device does not support Metal, force the use of the OpenGL ES backend using the --renderer compile option.
- If using XCode 8, the deployment target defaults to iOS 10 or higher. Note that armv7 devices cannot be updated to iOS 10. To target them, you must use the new build option --deployment-target <x>, which sets the deployment target for all projects. For example: ruby make.rb --platform ios --deployment-target 9.0 --renderer OPENGL