##Google Closure Package for TYPO3 Flow
I recommend to install this package using composer.
Just require the flynetworks/google-closure
package in your composer.json
"require": {
"flynetworks/google-closure": "2.*"
}After you have the package installed there is a new configuration file "GoogleClosure.yaml" available to you.
This file has basically the following structure:
UniqueIdentifier:
compiler:
options:
MyUniqueKey:
compiler:
options:
id: 'my-project-id'
externs:
- 'resource://My.Package/Public/JavaScripts/Externs/SomeExterns.js'
paths:
- 'resource://My.Package/Public/JavaScripts/'
moduleOutputPath: 'resource://My.Package/Public/JavaScripts/%s.min.js'
moduleProductionUri: 'resource://My.Package/Public/JavaScripts/%s.min.js'
modules:
'Application':
deps: []
inputs:
- 'resource://My.Package/Public/JavaScripts/Application.js'
Don't use a dot "." for the UniqueIdentifier! I recommend to use only alphanumeric characters.
Within the "options" property you can start to configure the compiler parameters.
This package is using the plovr build tool.
A documentation about
the options you can use is located here: http://plovr.com/options.html
In the list below all options are listed with their corresponding type.
| Option | Type |
|---|---|
| id required | string |
| inputs | array[string] |
| paths | array[string] |
| externs | array[string] |
| customExternsOnly | boolean |
| closureLibrary | string |
| experimentalExcludeClosureLibrary | boolean |
| mode | RAW, WHITESPACE, SIMPLE, ADVANCED |
| level | QUIET, DEFAULT, VERBOSE |
| inherits | string |
| debug | boolean |
| prettyPrint | boolean |
| printInputDelimiter | boolean |
| outputFile | string |
| outputWrapper | array[string] |
| outputCharset | string |
| fingerprint | boolean |
| modules | object |
| moduleOutputPath | string |
| moduleProductionUri | string |
| moduleInfoPath | string |
| globalScopeName | string |
| define | object |
| treatWarningsAsErrors | boolean |
| exportTestFunctions | boolean |
| nameSuffixesToStrip | array[string] |
| typePrefixesToStrip | array[string] |
| idGenerators | array[string] |
| ambiguateProperties | boolean |
| disambiguateProperties | boolean |
| experimentalCompilerOptions | object |
| customPasses | object |
| soyFunctionPlugins | array[string] |
| jsdocHtmlOutputPath | string |
| variableMapInputFile | string |
| variableMapOutputFile | string |
| propertyMapInputFile | string |
| propertyMapOutputFile | string |
| testTemplate | string |
| testExcludes | array[string] |
There are some more configuration properties available to you.
Just see the example below.
MyFancyConfiguration:
embedMode: 'dependency' #Viewhelper renders the dependency version
dependency:
command: 'python %FLOW_PATH_PACKAGES%Application/My.Cool.Package/Resources/Public/closure/bin/build/depswriter.py'
outputFileName: 'MyCustomDepsFileName.js'
compiler:
command: 'java -jar %FLOW_PATH_PACKAGES%Application/My.Cool.Package/Resources/Private/Bin/Plovr.jar build'
ChildConfiguration:
embedMode: 'compiled' #Viewhelper renders the compiled version
extends: 'MyFancyConfiguration'
compiler:
command: 'java -jar %FLOW_PATH_PACKAGES%Application/Super.Child.Package/Resources/Private/Bin/Plovr.jar build'
Also a ViewHelper "EmbedScriptViewHelper" is available through this package :)
{namespace gc=FlyNetworks\Google\Closure\ViewHelpers}
<!DOCTYPE html>
<html>
<head>
<gc:embedScript configurationKey="MyFancyConfiguration" />
<gc:embedScript configurationKey="ChildConfiguration" />
</head>
</html>
./flow closure:compile
./flow closure:dependency