Troubleshooting

Here you can find details on specific problems you might face with your integration or when using older versions of our SDK. We always recommend using the most up to date version of our SDKs where possible.

Unity iOS

Removing unsupported architectures for App Store

The AwesomeAds Unity SDK contains both ARM and x86_64 code. This enables it to run on a physical device and on a simulator at the same time. To publish your app to the App Store, the unused simulator architectures must be removed from the binary before publishing. To do this, there are 2 options:

Option 1: Use AwesomeAds SDK v7.2.12 and above.

Versions of our SDK above v7.2.12 include a post-build processor script that automatically removes simulator architecture codes from the binary when you finally export (archive) the Xcode project to release it to the App Store or for test distribution. The script does not run when testing on the simulator.

Option 2: Manually remove architectures

In Xcode go to Target > Build Settings > Valid Architectures menu, ensure i386 and x86_64 are not in the list.

Unity Android

Android release build fails with StackOverflowError (Unity 2022.3 + SDK 10.x)

When building a Release APK or AAB in Unity 2022.3 with SuperAwesome SDK 10.x, you may see a Gradle build failure similar to:

StackOverflowError
	at com.android.tools.r8.dex.DexWriter.computeMetadata

or it may appear as a generic dexBuilderRelease or mergeExtDexRelease task failure.

Cause: Unity 2022.3 bundles Android Gradle Plugin 7.4.2, which includes D8/R8 version 3.3.x. This version of R8 cannot correctly process Kotlin 2.x @Metadata annotations present in superawesome-base 10.x and kotlin-stdlib 2.x, causing a stack overflow during the dex compilation step.

Workaround: Override the R8 version by adding a custom Base Gradle Template to your project.

1. In Unity, go to Edit → Project Settings → Player → Android → Publishing Settings and enable Custom Base Gradle Template. This creates Assets/Plugins/Android/baseProjectTemplate.gradle.

2. Replace the contents of that file with the following:

buildscript {
    repositories {
        **ARTIFACTORYREPOSITORY**
        maven { url 'https://storage.googleapis.com/r8-releases/raw' }
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2'
        // Overrides the R8 version bundled with AGP 7.4.2 (3.3.x) which crashes
        // with StackOverflowError when processing Kotlin 2.x class metadata.
        classpath 'com.android.tools:r8:8.3.37'
        **BUILD_SCRIPT_DEPS**
    }
}

allprojects {
    buildscript {
        repositories {
            **ARTIFACTORYREPOSITORY**
            google()
            mavenCentral()
        }
    }
}

1. Rebuild. The release build should now complete successfully.