Registering a plugin

Matt Leathes edited this page Jul 11, 2017 · 9 revisions

All plugins are Bower packages; to create your plugin you will first need to define your package, and then register it with our plugin registry.

Registering a new plugin

To register a plugin, it must first comply with the following:

  • There must be a valid manifest bower.json in the current working directory.
  • Your package must be available at a Git endpoint (e.g. git://<user>/<repo_name>.git).
  • There must be a valid .bowerrc file in the current Git repository. See the adapt_framework repository for an example (you are fine to copy this as-is to your plugin source).

Once you are ready to publish, run the adapt command line interface and provide the required information.

$ adapt register

Your plugin will be published to the registry, you can confirm this by doing adapt search <plugin-name>.

Plugin versioning

It is possible to maintain multiple versions of your plugin, giving you the freedom to change your plugin at any time without requiring existing users to migrate to newer versions. We strongly recommend that you follow Semantic version numbers for your releases.

To create a new version of a registered plugin, simply tag your git repository with the new version number.

To install a specific version of a plugin using the Adapt Command Line Interface run the install command followed by the name of the plugin, # symbol and then the version number.

For example, the following would install version 0.0.2 of the adapt-hello-world plugin:

adapt install hello-world#0.0.2

Note that if you don't create tags or releases, the Adapt CLI will always download the 'default branch' - usually 'master' - of your plugin.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.