Migration guide to v3.1.0 or newer

Migrating from TyrAds SDK v3.0 (.unitypackage) to v3.1.0 or newer (UPM)

This guide walks you through upgrading a project that previously used the v3.0 .unitypackage to the new v3.1.0 or newer package distributed via the Unity Package Manager (UPM).

Before you start

• Commit or back up your project.

• Close running play sessions and save all open scenes.

---

1) Remove the old v3.0 installation

The .unitypackage installed files directly under your Assets/ folder. To avoid duplicate symbols and GUID conflicts, remove the old content completely.

Default folder path:

Assets/Plugins/TyrAdsSDK/. //Path could be if differ if your team have moved sdk

---

2) Install latests (v3.1.0 or newer) package via the Unity Package Manager (UPM)

Follow the steps from Installation page.

After installation, you should see TyrAds Unity SDK under Packages/ in the Project window.

---

3) Verify & refresh scene references

Because the UPM package provides new prefab and script GUIDs, references from the old .unitypackage may be missing. Open your main scenes and fix any missing references.

3.1 Main SDK object on the scene

• Look for your previous TyrSDKPlugin object.

• If the component shows Missing (Mono Script) or a broken reference:

  1. Remove the broken component/prefab instance.

  2. Locate the new prefab in the package folder

     Packages/com.tyrads.unity-sdk/Runtime/Prefabs/TyrSDKPlugin.prefab.

  3. Drag the new prefab into your scene.

  4. Reapply any scene-specific settings you previously had.

3.2 Premium widget prefab

• Find any UI locations where the premium widget was used.

• If you see a Missing (Prefab) or Missing (Mono Script):

  1. Remove the broken reference.

  2. Locate the new prefab in the package folder

     Packages/com.tyrads.unity/Runtime/Prefabs/PremiumWidget/PremiumWidget.prefab .

  3. Drag the new premium widget prefab into your scene.

  4. Reconnect it to your UI hierarchy and set its properties as needed.

---

4) Reapply configuration (only if you used the SDK editor window)

• If you previously configured the SDK via its Editor Window (e.g., entering app ids/keys, toggles, or project-wide settings):

  • Open the new TyrAds Settings

    TyrSDK > TyrSDK Settings.

  • Re-enter your configuration values as before.

• If your configuration is set programmatically (in code):

  • No extra steps needed. Your code-based configuration should continue to work after you fix script/component references.

---

5) Clean up and validate

1. Save all modified scenes.

2. Enter Play Mode and validate:

   • Initialization logs appear without errors.

   • The premium widget renders and behaves as expected.

   • Ads/placements load and show as before (in appropriate test/dev environments).

---

Troubleshooting

• Duplicate class/namespace or redefinition errors:

  You still have old .cs files under Assets/. Recheck step 1 and remove any leftovers.

• Missing script on a prefab after install:

  Replace the instance with the new prefab from the UPM package (see step 3).

• Editor window/menu not found:

  Ensure v3.1.0 or newer is installed under Packages/ and re-open Unity if needed. Some editor menus appear after a domain reload.

---

Quick Checklist

• Old TyrAds folders removed from Assets/ (default or any custom locations)

• TyrAds SDK v3.1.0 or newer installed via UPM

• Main SDK scene object replaced/verified

• Premium widget prefab replaced/verified

• Configurations re-applied (only if previously set in editor)

• Play Mode sanity test passed