Package Tool

Tool for create unity packages

Requirements

• Unity 2021.3 or newer.
• Playdarium.PackageTool.Editor — runs on Editor only.

Dependencies

| Package | Version | |---------|---------| | com.unity.nuget.newtonsoft-json | 3.2.1 |

Installation

Add the package to Packages/manifest.json:

{
  "scopedRegistries": [
    {
      "name": "Playdarium",
      "url": "https://npm.playdarium.studio",
      "scopes": [
        "com.elestrago"
      ]
    }
  ],
  "dependencies": {
    "com.elestrago.unity.package-tools": "2.5.3"
  }
}

Replace the registry URL above with your scoped registry, or remove the scopedRegistries block when consuming a published package.

Getting Started

1. Create a PackageManifestConfig asset via Assets > Create > JCMG/PackageTools/PackageManifestConfig.
2. Fill in packageName, displayName, packageVersion, unityVersion, sourcePath (the folder under Assets/ that holds your package's source), and packageDestinationPath (where the assembled package will be written, e.g. Release).
3. Optionally add dependencies, samples, and copyEntries rows in the inspector.
4. Click Export Package Source to assemble the package; Export as Legacy Package to emit a .unitypackage; or Generate VersionConstants.cs to write a versions file at versionConstantsPath.

To export from your own editor code, call PackageTool.PackageToolApi — the same methods the inspector buttons use:

using PackageTool;

// Selectors match the config id, the package name, or the config asset name.
var config = PackageToolApi.GetConfig("com.elestrago.unity.package-tools");

PackageToolApi.ExportPackageSource(config, version: "1.2.3");
PackageToolApi.ExportLegacyPackage(config);

For CI, invoke the PackageTool.CIUtils entry points in batch mode. Generate exports both outputs for every config; ExportPackageSource, ExportLegacyPackage and ListConfigs are the narrower entry points. Pass resultpath=<file> to get a JSON report instead of scraping the log:

unity -batchmode -quit -projectPath . \
  -executeMethod PackageTool.CIUtils.ExportPackageSource \
  id=com.elestrago.unity.package-tools \
  version=1.2.3 \
  resultpath=/tmp/package-tool-result.json

Documentation

• Manual — concepts and architecture.
• API Reference — every public type and member.
• Examples — short usage examples for the public API.

License

See LICENSE.