Facebook Instant Games SDK for Unity upgrade guide

Upgrade the Facebook Instant Games SDK for Unity package to the latest version to take advantage of new features, bug fixes, and improvements.

To upgrade the package to a new version, follow the steps in Switch to another version of a UPM package. Once you upgrade, follow the steps on this page to ensure your project works correctly with the new package version.

Choose a version of the Instant Games SDK

When you upgrade the package, the SDK version defaults to Instant Games SDK 8 (Zero Permissions). Because previous versions of the package used SDK 7.1, this is a breaking change for existing projects.

Important

For existing projects, you must change the SDK version back to 7.1 after upgrading the package.

To change the Instant Games SDK version:

  1. Go to Edit > Project Settings > Facebook Instant Games.
  2. Set SDK Version to either 7.1 or 8 (Zero Permissions).

Refer to Facebook Instant Games SDK version settings for more information about choosing an SDK version.

Continue using Instant Games SDK 7.1

If you set the version SDK 7.1, you must update the namespace in your scripts from Meta.InstantGames to Meta.InstantGames.v7.

Note

The Runtime namespace, Meta.InstantGames.Runtime, remains unchanged.

Migrate to Instant Games SDK 8

If you keep the default version of SDK 8, your existing code may not compile. To migrate your code, refer to Facebook's New App Onboarding documentation for Network Enabled Zero Permissions.

You must also update the namespace in your scripts from Meta.InstantGames to Meta.InstantGames.v8.

Additional resources