grunt-aem-clientlib-generator
A Grunt plugin wrapper for aem-clientlib-generator.
Installation
npm install grunt-aem-clientlib-generator
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt;
Usage
Define clientlib
property in your grunt configuration file:
grunt;
Options
Options can be defined globally and for every task separately. The special file pattern properties can also be defined for assets.
Global Options
Global options will be used for all defined tasks and asset configurations until the property will be overridden.
options
{Object}
global configuration propertiesclientLibRoot
{String}
Clientlib root path for all clientlibscwd
{String}
directory all paths start with; paths are stripped from the beginningexpand
{Boolean}
using glob pattern for file searching (default: true)flatten
{Boolean}
removes the path component from source, keep the filename (default: true)filter
{String|Function}
if string it must be a valid fs.Stats method or a function that is passed the matchedsrc
filepath (default:isFile
)serializationFormat
{String}
Format of clientLib definition, eitherxml
orjson
, defaultjson
clientlib: // define options globally (used for all targets) options: clientLibRoot: "./test/result/clientlibs-root" // clientlib root path cwd: "./test/src/frontend" // task definitions follow.
Task Options
Task options defines properties for a specific clientlib and will override properties from
global options. cwd
, expand
and flatten
will also be used for all asset configurations.
options
{Object}
task configuration propertiespath
{String}
Clientlib root path (optional ifoptions.clientLibRoot
is set)cwd
{String}
directory all paths start with; paths are stripped from the beginningexpand
{Boolean}
using glob pattern for file searching (default: true)flatten
{Boolean}
removes the path component from source, keep the filenamefilter
{String|Function}
if string it must be a valid fs.Stats method or a function that is passed the matchedsrc
filepath (default:isFile
)
clientlib: "clientlib.name": options: clientLibRoot: "./test/result/clientlibs-root" // clientlib root path cwd: "./test/src/frontend" // asset configuration follows js: ...
ClientLib Configuration
A ClientLib can be configured for each task with the following properties:
embed
{Array<String>}
array of ClientLib names that should be embedded by AEM (optional)dependencies
{Array<String>}
array of other ClientLib names that should be included by AEM (optional)cssProcessor
{Array<String>}
array of configuration properties for the ClientLib CSS processor, requires AEM 6.2 (optional)jsProcessor
{Array<String>}
array of configuration properties for the ClientLib JS processor, requires AEM 6.2 (optional)allowProxy
{Boolean}
allow for Clientlib creation under/apps/myapp/clientLibs
but enable proxy to/etc.clientlibs/myapp/clientlibs/mylib
See AEM 6.3 DocumentationlongCacheKey
{String}
optional string with placeholders to use with URL Fingerprinting, eq."${project.version}-${buildNumber}"
serializationFormat
{String}
Format of clientLib definition, eitherxml
orjson
, defaultjson
js|css|resources
{Object}
asset configuration propertiescwd
{String}
directory all paths start with; paths are stripped from the beginningexpand
{Boolean}
using glob pattern for file searching (default: true)flatten
{Boolean}
removes the path component from source, keep the filenamefilter
{String|Function}
if string it must be a valid fs.Stats method or a function that is passed the matchedsrc
filepath (default:isFile
)base
{String}
subpath under clientlib folder where the assets should be copied to (default: asset key, e.g. for asset configuration "js" is the base folder "js/"; use "." to copy files into the clientlib base)src
{String|Array<String>}
globbing patterns for filename expansionrename
{String|Function}
- if a string is defined, a single
src
will be renamed (ensure thatsrc
is a string) - if a function is specified it will be used for building the destination path for every source path Important: Keep in mind that the destination path will be used as a relative path to the clientlib base folder.
- if a string is defined, a single
clientlib: "your.clientlib.name": "embed": "other.clientlib.name" // AEM embeds this ClientLib "jsProcessor": "default:none" "min:gcc;compilationLevel=whitespace" // change the processor for JS minification in AEM // asset configuration "js": flatten: false // keep folder structure cwd: "./test/src/frontend/js" // choose another directory src: "**/*.js" ...