В этом разделе представлен обзор того, что такое gruntjs, и почему разработчик может захотеть его использовать.
Следует также упомянуть о любых крупных предметах в пределах gruntjs и ссылаться на связанные темы. Поскольку Documentation for gruntjs является новым, вам может потребоваться создать начальные версии этих связанных тем.
Версия | Дата выхода |
---|---|
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 |
Запустите grunt -h, чтобы увидеть следующее:
Grunt требует установки Node.js и npm. Если на вашем компьютере нет Node.js и / или npm, перейдите на страницу https://nodejs.org и загрузите установочный пакет или пакет для своей операционной системы.
Если вы впервые устанавливаете Grunt, сначала вам нужно будет установить пакет командной строки Grunt для командной строки grunt-cli
всему миру.
npm install -g grunt-cli
Это устанавливает интерфейс командной строки для Grunt по всему миру, поэтому вы можете запустить локальную версию Grunt в своем проекте.
Вы можете убедиться, что у вас установлен пакет grunt-cli
, выполнив следующую команду:
grunt --version
Это должно печатать хотя бы текущую версию вашего пакета grunt-cli
.
После запуска и запуска grunt-cli
вы можете установить фактический бегун задания grunt
и ваш первый пакет Grunt grunt-contrib-jshint
:
npm install grunt --save-dev npm install grunt-contrib-jshint --save-dev
Это загружает пакеты из диспетчера пакетов NPM и сохраняет их как devDependencies
в файл package.json
.
Затем вам понадобится Gruntfile.js
в корне вашего проекта, который действует как файл конфигурации для задач Grunt:
module.exports = function(grunt) { grunt.initConfig({ jshint: { files: ['Gruntfile.js'], } }); grunt.loadNpmTasks('grunt-contrib-jshint'); grunt.registerTask('default', ['jshint']); };
Этот файл выполняет три функции:
grunt-contrib-jshint
из пакета NPM jshint
задачу jshint
для работы с файлом Gruntfile.js
default
которая запускает задачу jshint
После того, как вы настроили свой проект, вы можете запустить задачу Grunt по default
:
grunt
Это запускает grunt-cli
который запускает локальный grunt
который ищет задачу Grunt с именем default
которая настроена для запуска задачи с именем jshint
.
Все атрибуты grunt.initConfig
являются допустимыми задачами, поэтому если ваш файл Grunt выглядит примерно так:
module.exports = function(grunt) {
grunt.initConfig({
jshint: {
files: ['Gruntfile.js'],
}
});
grunt.loadNpmTasks('grunt-contrib-jshint');
grunt.registerTask('default', ['jshint']);
};
Команда командной $ grunt jshint
будет запускать задачу jshint
.
Задачи могут иметь разные цели. Возьмите этот фрагмент кода, например:
grunt.initConfig({
jshint: {
gruntfile: {
files: ['Gruntfile.js']
},
project: {
files: 'src/**/*.js'
}
}
});
Здесь jshint может указывать на файл grunt или все файлы JavaScript вашего проекта. Если мы запустим $ grunt jshint
будут использованы обе цели, но если мы запустим $ grunt jshint:gruntfile
то $ grunt jshint:gruntfile
будет применен только к файлу grunt.
Задачи по умолчанию, зарегистрированные как grunt.registerTask('default', ['jshint']);
будет работать с командой shell $ grunt
.
Новые зарегистрированные задачи будут запускать передачу своего имени в качестве аргумента командной строки для хрюкания. Например:
grunt.registerTask('gruntfile', ['jshint:gruntfile']);
Будет работать с $ grunt gruntfile
.