Det här avsnittet ger en översikt över vad gruntjs är och varför en utvecklare kanske vill använda den.
Det bör också nämna alla stora ämnen inom gruntjs och länka till relaterade ämnen. Eftersom dokumentationen för gruntjs är ny kan du behöva skapa initialversioner av relaterade ämnen.
Version | Utgivningsdatum |
---|---|
0.3.0 | 2012-07-30 |
0.4.0 | 2013/02/17 |
0.4.1 | 2013/03/12 |
0.4.2 | 2013/11/20 |
0.4.3 | 2014/03/06 |
0.4.4 | 2014/03/13 |
0.4.5 | 2014/05/11 |
1.0.0 | 2016/04/04 |
1.0.1 | 2016/04/05 |
Kör grymma -h för att se följande:
Grunt kräver att Node.js och npm installeras. Om du inte har Node.js och / eller npm installerat på din maskin, gå till https://nodejs.org och ladda ner installationsprogrammet eller paketet för ditt operativsystem.
Om du installerar Grunt för första gången måste du först installera Grunt-kommandoradsgränssnittspaketet grunt-cli
globalt.
npm install -g grunt-cli
Detta installerar kommandoradsgränssnittet för Grunt globalt så att du kan köra den lokala versionen av Grunt i ditt projekt.
Du kan verifiera att du har installerat grunt-cli
paketet genom att köra följande kommando:
grunt --version
Detta bör skriva ut minst den nuvarande versionen av ditt grunt-cli
paket.
När du har grunt-cli
igång grunt-cli
kan du installera själva grunt
och ditt första Grunt-paket grunt-contrib-jshint
:
npm install grunt --save-dev npm install grunt-contrib-jshint --save-dev
Detta hämtar paketen från NPM-pakethanteraren och sparar dem som devDependencies
till din package.json
fil.
Nästa behöver du en Gruntfile.js
i din projektrot som fungerar som en konfigurationsfil för Grunt-uppgifter:
module.exports = function(grunt) { grunt.initConfig({ jshint: { files: ['Gruntfile.js'], } }); grunt.loadNpmTasks('grunt-contrib-jshint'); grunt.registerTask('default', ['jshint']); };
Denna fil gör tre saker:
grunt-contrib-jshint
uppgiften från NPM-paketet jshint
uppgiften att köra mot filen Gruntfile.js
default
som kör jshint
uppgiften När du har konfigurerat ditt projekt kan du köra Grunt: s default
genom att ringa:
grunt
Detta fyrar upp grunt-cli
som kör den lokala grunt
som letar efter en Grunt-uppgift som heter default
som är konfigurerad för att köra uppgiften som heter jshint
.
Alla attribut för grunt.initConfig
är giltiga uppgifter, så om din Gruntfile ser ut så här:
module.exports = function(grunt) {
grunt.initConfig({
jshint: {
files: ['Gruntfile.js'],
}
});
grunt.loadNpmTasks('grunt-contrib-jshint');
grunt.registerTask('default', ['jshint']);
};
$ grunt jshint
kör jshint
uppgiften.
Uppgifter kan ha olika mål. Ta detta kodavsnitt till exempel:
grunt.initConfig({
jshint: {
gruntfile: {
files: ['Gruntfile.js']
},
project: {
files: 'src/**/*.js'
}
}
});
Här kan jshint rikta in sig på gruntfilen eller alla JavaScript-filer i ditt projekt. Om vi kör $ grunt jshint
båda målen att användas, men om vi kör $ grunt jshint:gruntfile
gruntfile kommer linter endast att tillämpas på gruntfilen.
Standarduppgifterna registrerade som denna grunt.registerTask('default', ['jshint']);
kommer att köras med skalkommandot $ grunt
.
Nya registrerade uppgifter körs med namnet som ett kommandoradsargument för att gnälla. Till exempel:
grunt.registerTask('gruntfile', ['jshint:gruntfile']);
Kommer med $ grunt gruntfile
.