Skip to main content

Known Issues

Missing Xcode Workspace File​

Issue:

Building to iOS creates an Xcode project file *.xcodeproj, but not create a Workspace file *.xcworkspace.

Workaround:

  1. Run sudo gem install cocoapods in the project directory via Terminal.

  2. Go to Assets > External Dependency Manager > iOS Resolver > Settings.

  3. Uncheck Use shell to execute Cocoapods Tool.

  4. Uncheck Auto Install Cocoapods Tools in Editor.

  5. Go to Assets > External Dependency Manager > iOS Resolver > Install Cocoapods. A message should be received that informs you that CocoaPods is already installed.

  6. Then after you build your project go to the generated Xcode project directory (folder chosen when building from the build settings) and run pod update.

  7. This should generate an Workspace file *.xcworkspace.

CocoaPods Install Fails​

Issue:

Installing CocoaPods fails with an error message related to missing or incorrect activesupport gem.

Workaround:

  1. The error message will direct you to run a command similar to:
gem install activesupport -v 6.1.7.3
  1. Open a terminal window.
  2. Run this command.
  3. You may need to add sudo to the beginning of command:
sudo gem install activesupport -v 6.1.7.3
  1. Try to install CocoaPods again.

Installing CocoaPods Dependencies Fail​

Issue:

Installing the Skillz CocoaPods dependency fails with an error message related to git-lfs command not found.

Workaround:

  1. Your machine needs to have git-lfs installed on it to checkout the Skillz CocoaPod
  2. Open a terminal window.
  3. Run the command specified here
brew install git-lfs
  1. Try to install CocoaPods dependencies again.

Gradle Build Failed​

Issue:

This version of the SDK requires Gradle 7.4+ while Unity versions 2020 and 2021 come bundled with Gradle 6.1.1.

Could not resolve all files for configuration ':launcher:debugRuntimeClasspath'.
   > Failed to transform dd-sdk-android-1.14.0.aar (com.datadoghq:dd-sdk-android:1.14.0) to match attributes {artifactType=android-manifest, org.gradle.category=library, org.gradle.dependency.bundling=external
A problem occurred evaluating project ':launcher'.
> Failed to apply plugin [id 'com.android.internal.version-check']
   > Minimum supported Gradle version is 7.4. Current version is 6.5. If using the gradle wrapper, try editing the distributionUrl in /Users/<UserName>/Documents/Unity/<ProjectName>/Library/Bee/Android/Prj/IL2CPP/Gradle/gradle/wrapper/gradle-wrapper.properties to gradle-7.4-all.zip

Solution:

  • Export the project to Android Studio.
    1. Android Studio will warn you about the Gradle dependency and provide you an option to update.
  • If you would like to build the APK from Unity itself, follow the instruction here

Incremental build fails​

Issue:

Incremental build fails for Android in Unity 2021.3 LTS.

Resolution:

Select Clean Build in the Build Settings when building for Android.

Skillz Manager Component Support with Unity 2019​

Issue:

When using the unsupported Unity version 2019 or older. The Skillz Manager component will not render correctly.

Resolution:

Either upgrade the version of Unity for your project to a supported version, or use the Legacy Unity/C# SkillzMatchDelegate to launch Skillz in your project.