Metaplay Docs

Appearance

metaplay update sdk [flags]

Update the Metaplay SDK to a newer version

metaplay update sdk [flags] ​

Update the Metaplay SDK in your project to a newer version.

This command reads the current SDK version from MetaplaySDK/version.yaml, fetches available versions from the Metaplay portal, and offers update options:

  • Latest minor version within your current major release (e.g., 34.1 -> 34.3)
  • Latest version in the next major release (e.g., 34.x -> 35.2)

Experimental: If local modifications to SDK files are detected, a patch file (metaplay-sdk-modifications.patch) will be extracted before updating. You can re-apply the changes with 'patch -p1' or 'git apply --reject'. Some hunks may fail if there are conflicts with the new SDK version and will require manual resolution. This feature is experimental - please ensure you use version control (e.g., git) to have a backup of your SDK modifications.

You may also use your own preferred way to preserve the changes. If so, use --skip-patch to disable patch file generation.

You must be logged in to the Metaplay portal (use 'metaplay auth login').

Examples ​

sh
# Interactive update - choose from available versions
metaplay update sdk
# Update to a specific version
metaplay update sdk --to-version=35.2
# Update to latest in a major version (e.g., latest 35.x)
metaplay update sdk --to-version=35
# Non-interactive update for CI/automation
metaplay update sdk --to-version=35 --auto-agree --yes
# Skip patch file generation (when handling SDK modifications yourself)
metaplay update sdk --skip-patch

Flags ​

  • --auto-agree: Automatically agree to privacy policy and terms & conditions
  • --skip-patch: Skip patch file generation for SDK modifications
  • --to-version <string>: Target SDK version to update to (required in non-interactive mode)
  • --yes: Skip confirmation prompts

Inherited Flags ​

  • --color <string>: Should the output be colored (yes/no/auto)? [env: METAPLAYCLI_COLOR] (default: auto)
  • --project <string>: Path to the to project directory (where metaplay-project.yaml is located)
  • --skip-version-check: Skip the check for a new CLI version being available
  • --verbose: Enable verbose logging, useful for troubleshooting [env: METAPLAYCLI_VERBOSE]