forked from addonscript/addonscript-spec
81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
# Addon Manifest Object
|
|
|
|
```json
|
|
{
|
|
"addonscript": {},
|
|
"id": "myaddon",
|
|
"namespace": "com.example",
|
|
"version": "1.0.0",
|
|
"files": [],
|
|
"relations": [],
|
|
"flags": {},
|
|
"repositories": [],
|
|
"instance": false,
|
|
"use_builder": false,
|
|
"launch": {},
|
|
"meta": {}
|
|
}
|
|
```
|
|
|
|
## Required properties
|
|
|
|
### addonscript
|
|
|
|
This is an [AddonScript object](addonscript.md) 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 [AddonScript version number](../concepts/versioning.md#addonscript-version-numbers) of this version.
|
|
|
|
### namespace
|
|
|
|
This is the [canonical namespace](../concepts/namespaces.md#canonical-namespaces) of the addon.
|
|
|
|
### flags
|
|
|
|
This is an [flags object](flags.md) which contains [manifest flags](../concepts/flags.md#manifest-flags) for both sides for this manifest.
|
|
|
|
## Optional properties
|
|
|
|
### files
|
|
|
|
This is an array of [file objects](file.md) including the files belonging to this addon.
|
|
|
|
### relations
|
|
|
|
This is an array of [relation objects](relation.md) which represent addons in relation to this one.
|
|
|
|
### repositories
|
|
|
|
This is an array of [repository objects](repository.md). Each repository object defines one repository from which files or
|
|
addons can be retrieved. Each AddonScript manifest SHOULD have a repository for the [canonical namespace](#namespace) of
|
|
that manifest, from which AddonScript implementations MAY check for updates for this addon. If [use_builder](#usebuilder) is `true`,
|
|
this addon MUST have such a repository to provide API instances, which can be used to request the
|
|
[launch environment](../api/features/builder.md#build-launch-environment).
|
|
|
|
### instance
|
|
|
|
This is a boolean which specifies, if this addon is an [instance addon](../concepts/instance.md).
|
|
If this property is not present, it defaults to `false`.
|
|
|
|
### use_builder
|
|
|
|
This is a boolean which specifies, if this addon will use the [environment builder](../api/features/builder.md).
|
|
Only valid if [instance](#instance) is `true`.
|
|
If this property is not present, it defaults to `false`.
|
|
|
|
### launch
|
|
|
|
This is a [launch config object](launch.md) which can be used to modify the
|
|
inherited launch configuration of this instance.
|
|
Only available for [instance addons](../concepts/instance.md).
|
|
|
|
### meta
|
|
|
|
This is a [meta object](meta.md) containing metadata about the addon.
|