Plugins do Grunt definem tarefas que executam certas etapas de build e podem ser reutilizadas em vários projetos. Os exemplos utilizarão o plugin "grunt-contrib-uglify". Verifique o website do Grunt para uma lista de plugins disponíveis.
O primeiro passo para usar um plugin do Grunt existente é instalando-o. Os plugins do Grunt são empacotados como módulos Node e podem ser instalados usando o npm desta forma:
npm install --save-dev grunt-contrib-uglify
Isso vai instalar o plugin "grunt-contrib-uglify" para o Grunt localmente dentro da pasta node_modules
(ref.: npm folders). Plugins devem ser instalados localmente para evitar conflitos de versões quando utilizados em múltiplos projetos.
Especificando --save-dev
como opção, vai adicionar automaticamente este plugin á seção "devDependency" no arquivo package.json
. Este arquivo lista todas as dependências para Node no projeto.
Adicionando o plugin do Grunt, permitirá que outros desenvolvedores trabalhando no projeto simplesmente executem npm install
para instalar localmente estas dependências necessárias.
Agora que o plugin está instalado, é hora de avisar ao Grunt sobre ele e deixá-lo carregar todas as tarefas definidas. Para fazer isso, adicione a seguinte linha ao seu Gruntfile.js
:
grunt.loadNpmTasks('grunt-contrib-uglify')
Esta linha deve ser adicionada dentro do escopo da função de nível superior (não na seção initConfig) onde também grunt.registerTask()
é chamado.
Tarefas de plugins podem ser executadas como outras tarefas do grunt, até mesmo quando especificada na linha de comando:
grunt uglify
Ou registrando um novo atalho para esta tarefa, que é chamada e executada:
grunt.registerTask("dist", ["uglify"])
A configuração do Plugin depende do plugin em específico, então verifique a documentação do plugin para mais informações. Em geral, a configuração está localizado na seção initConfig
do Gruntfile.
TODO: Configuration Targets/options (Merge [Configuring tasks](Configuring tasks)?)