(Quick Reference)

install-plugin

Purpose

Installs a plugin from the Grails central SVN repository, a file, or a URL

Plugins should be installed by listing them in BuildConfig.groovy with the appropriate scope instead of using install-plugin.

Examples

grails install-plugin shiro
grails install-plugin shiro 1.1
grails install-plugin ../grails-bar-1.0.zip
grails install-plugin http://foo.com/grails-bar-1.0.zip

Description

Usage:

grails install-plugin [name] [version]*
grails install-plugin [URL/File]

Fired Events:

  • StatusUpdate - Fired at various points during the plugin installation
  • StatusError - When an error occurs during plugin installation
  • StatusFinal - When the plugin is installed successfully
  • PluginInstalled - When the plugin is installed successfully

The install-plugin command is a versatile command that installs plugins from the Grails central SVN repository at http://svn.codehaus.org/grails-plugins/, a local file, or a remote URL.

To install a plugin from the remote central repository, for example the "shiro" plugin, use the install-plugin command followed by the plugin name:

grails install-plugin shiro

This will install the latest version of the plugin. To install a specific version specify it as an argument:

grails install-plugin shiro 1.1

To find out what plugins are available use the list-plugins command.

To install from a URL, simply specify the absolute URL to the plugin package:

grails install-plugin http://foo.com/grails-bar-1.0.zip

To install from a local file, specify the absolute or relative path to the file:

grails install-plugin ../grails-bar-1.0.zip