addonscript-spec/docs/schema/manifest.md
Timo Ley 967a4b9a24 Remove semver property from manifest
An addon should not have two version numbers, either the main version number is semver compatible or nor
2022-09-16 16:59:39 +02:00

2.1 KiB

Addon Manifest Object

{
  "addonscript": {},
  "id": "myaddon",
  "namespace": "com.example",
  "version": "1.0.0",
  "files": [],
  "relations": [],
  "flags": {},
  "repositories": [],
  "env_api": "https://example.com",
  "meta": {}
}

Required properties

addonscript

This is an AddonScript object containing information about the version of AddonScript used in this file.

id

This is the ID of the addon.

It MUST only contains lowercase alphanumeric characters and hyphens and SHOULD be written in the kebab-case format.

version

This is the version number of this version. Versions are compared by Maven version order rules. If this version number is valid semver, this version of the addon is semver compatible and implies all semantics according to the semver specifications. AddonScript implementations MAY provide specific behavior based on the semver semantics, for example warning the user before updating to a next major version.

namespace

This is the canonical namespace of the addon.

flags

This is an flags object which contains manifest flags for both sides for this manifest.

Optional properties

files

This is an array of file objects including the files belonging to this addon.

relations

This is an array of relation objects which represent addons in relation to this one.

repositories

This is an array of repository objects. Each repository object defines one repository from which files or addons can be retrieved.

env_api

This is the base URL of an AddonScript API instance, which has the env feature and will be used to build the launch environment for this addon. This property will only be used if this addon has the env manifest flag.

meta

This is a meta object containing metadata about the addon.