Resolve iOS mediation runtime errors
Stay organized with collections
Save and categorize content based on your preferences.
If you encounter dynamic linker errors after app launch, you might encounter
the following runtime errors:
dylibdynamic frameworkLibrary not loadedno such file
To resolve these errors, link these frameworks statically. This guide covers how
to build the Unity application for iOS and link these frameworks.
Prerequisites
Before continuing, complete Get started.
Link frameworks statically
The following table lists ad sources with dynamic frameworks and the minimum
adapter version that automatically handles static linking. To link frameworks
statically, update your adapters to the following minimum version or higher:
| Ad source |
Minimum version for automatic static linking |
| AppLovin |
8.1.1 |
| InMobi |
4.7.1 |
| maio |
3.0.0 |
To use an older adapter version that doesn't automatically configure static
linking, do the following:
Create an Assets/GoogleMobileAds/Editor/iOSDynamicDependencies.xml file
with the following content:
<dependencies>
<iosPods>
<!-- AppLovin adapter dependencies. -->
<iosPod name="AppLovinSDK" addToAllTargets="true"/>
<!-- InMobi adapter dependencies. -->
<iosPod name="InMobiSDK" addToAllTargets="true"/>
<!-- maio adapter dependencies. -->
<iosPod name="MaioSDK-v2" addToAllTargets="true"/>
</iosPods>
</dependencies>
Keep only the <iosPod> elements for ad sources that apply to your app.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["If you encounter dynamic linker errors after app launch, you might encounter\nthe following runtime errors:\n\n- `dylib`\n- `dynamic framework`\n- `Library not loaded`\n- `no such file`\n\nTo resolve these errors, link these frameworks statically. This guide covers how\nto build the Unity application for iOS and link these frameworks.\n\nPrerequisites\n\nBefore continuing, complete [Get started](/admob/unity/quick-start).\n\nLink frameworks statically\n\nThe following table lists ad sources with dynamic frameworks and the minimum\nadapter version that automatically handles static linking. To link frameworks\nstatically, update your adapters to the following minimum version or higher:\n\n| Ad source | Minimum version for automatic static linking |\n|-----------|--------------------------------------------------------|\n| AppLovin | [8.1.1](/admob/unity/mediation/applovin#version-8.1.1) |\n| InMobi | [4.7.1](/admob/unity/mediation/inmobi#version-4.7.1) |\n| maio | [3.0.0](/admob/unity/mediation/maio#version-3.0.0) |\n\nManually configure static linking\n\nTo use an older adapter version that doesn't automatically configure static\nlinking, do the following:\n\n1. Create an `Assets/GoogleMobileAds/Editor/iOSDynamicDependencies.xml` file\n with the following content:\n\n \u003cdependencies\u003e\n \u003ciosPods\u003e\n \u003c!-- AppLovin adapter dependencies. --\u003e\n \u003ciosPod name=\"AppLovinSDK\" addToAllTargets=\"true\"/\u003e\n \u003c!-- InMobi adapter dependencies. --\u003e\n \u003ciosPod name=\"InMobiSDK\" addToAllTargets=\"true\"/\u003e\n \u003c!-- maio adapter dependencies. --\u003e\n \u003ciosPod name=\"MaioSDK-v2\" addToAllTargets=\"true\"/\u003e\n \u003c/iosPods\u003e\n \u003c/dependencies\u003e\n\n2. Keep only the `\u003ciosPod\u003e` elements for ad sources that apply to your app."]]