Installation

• Scoped registry — the recommended path. Add Playtolia’s registry once and the package behaves like any built-in one: browse it in the Package Manager, install by name, and get a one-click Update button when new versions ship.
• Git URL — pull a tagged version straight from the distribution repository. No registry setup, but updates are a manual tag bump (no Update button).
• Tarball (.tgz) — a self-contained archive you download once. Good for offline or air-gapped machines, or when you want the exact bytes checked into your own storage.

​

Requirements

• Unity 6000.0 or later (developed and tested against 6000.0.32f1)
• iOS builds: Xcode and CocoaPods; deployment target 13.0+
• Android builds: Android SDK; min SDK 24 (Android 7.0)

​

Install with the Package Manager

• Scoped registry (recommended)
• Git URL
• Tarball (.tgz)

A scoped registry tells Unity where to find Playtolia packages. Add it once and every future version — plus the Package Manager Update button — comes for free.Add it from Project Settings (no file editing). Open Edit ▸ Project Settings ▸ Package Manager, expand Scoped Registries, and:

1. Click the + button to add a new registry.
2. Fill in the fields exactly:
   • Name — Playtolia
   • URL — https://dist.playtolia.com/unity-sdk
   • Scope(s) — com.playtolia
3. Click Save.

Then install the package: Window ▸ Package Manager ▸ My Registries ▸ Playtolia ▸ Playtolia SDK ▸ Install (or + ▸ Add package by name… → com.playtolia.sdk).

Prefer to edit manifest.json directly?

Add the same registry and the package to Packages/manifest.json (create the scopedRegistries array if it isn’t there):

{
  "scopedRegistries": [
    {
      "name": "Playtolia",
      "url": "https://dist.playtolia.com/unity-sdk",
      "scopes": ["com.playtolia"]
    }
  ],
  "dependencies": {
    "com.playtolia.sdk": "1.4.0"
  }
}

Unlike a Git URL, a registry dependency uses normal version numbers ("1.4.0"), so the Package Manager shows every available version and an Update button when a newer one is published. This is the smoothest way to stay current. Grab the latest version number from the Releases page.

1. In the Package Manager, click + ▸ Add package from git URL…
2. Paste the repository URL with the version tag you want and click Add:

https://github.com/Playtolia/unity-sdk.git#vX.Y.Z

Replace vX.Y.Z with the version you want — grab the latest tag from the Releases page (e.g. #v1.4.0). Unity clones that tag and adds it to your project.

Pin to a tag. Git URLs don’t support version ranges, and the package’s C# is matched to a specific iOS framework and Android (Maven) version — so a fixed #vX.Y.Z keeps all three in sync and builds reproducible. Omitting the fragment resolves main at the moment you add it and then locks that commit in Packages/packages-lock.json; it does not auto-update, so a tag is clearer and safer.

You can also add the same line to Packages/manifest.json directly:

{
  "dependencies": {
    "com.playtolia.sdk": "https://github.com/Playtolia/unity-sdk.git#vX.Y.Z"
  }
}

Installing from a Git URL requires a Git client on your machine and on your PATH before you launch Unity. See Unity’s Install from a Git URL guide for details and troubleshooting.

1. Download playtolia-sdk-X.Y.Z.tgz from the Releases page.
2. In the Package Manager, click + ▸ Add package from tarball…
3. Select the downloaded .tgz and click Open.

Unity copies the archive into your project and resolves it in place. The tarball is self-contained — it already includes the iOS core.framework — so it works without network access once downloaded.

Unity references the tarball by its file path, not its contents. Keep the .tgz somewhere stable inside or alongside your project (many teams commit it to a Packages/ subfolder). If you move or delete it, the package fails to resolve on the next import. See Unity’s Install from a local tarball guide.

​

Native dependencies

• Android — resolved from Maven Central by the External Dependency Manager for Unity (EDM4U). The package ships an Editor/SharedAndroidDependencies.xml pinned to the matching com.playtolia.sdk:core-android version, and EDM4U downloads it at build time. EDM4U is a transitive requirement; if your project doesn’t already have it, install com.google.external-dependency-manager alongside Playtolia.
• iOS — the core.framework binary ships inside the package and is embedded into your Xcode project automatically by the included build post-processor.

​

Verify the install

​

Updating

• Scoped registry — the smooth path: the Package Manager shows a version list and a one-click Update button whenever a newer version is published. Nothing to edit by hand.

• Git URL — bump the tag in Packages/manifest.json (e.g. #v1.4.0 → #v1.5.0). Since the URL changes, Unity re-resolves on the next window focus and updates the lock file. You can also just re-run + ▸ Add package from git URL… with the new tag. (No manual lock editing needed — that’s only required if you track a moving branch instead of a tag.)
• Tarball — download the newer .tgz, remove the existing package from the Package Manager, and add the new archive.

​

Next step