| layout | default |
|---|---|
| title | Tools & Testing |
If something seems terrible wrong, check out {{site.project_title}}'s build status page.
Vulcanization is process that turns polymers into more durable materials.
Vulcanize is a tool to concatenate a set of web components into a single file. It's our current recommendation for a "build step". Read more about it in "Concatenating Web Components with Vulcanize".
In Chrome, native Shadow DOM is not inspectable. That is, you can't use the DevTools to drill down into a Shadow Root.
To be able to inspect Shadow DOM, turn on "Show Shadow DOM" in the DevTools general settings:
After reloading the DevTools, Shadow DOM is inspectable and renders as #document-fragments in the tree.
{{site.project_title}} polyfills the HTML Imports specification. In order for code to be debuggable at run-time, scripts embedded in components are injected into <head> in the main document. Tools/browsers that support source maps will identify these scripts as belonging to their source components.
To run tests, build minified files, or build documentation you need node and
grunt-cli on your system.
-
install NodeJS using the instructions on their website
-
use
npmto install the GruntJS task runner for the command-linenpm install -g grunt-cli
Now for any repository in which you want to use tools, install the Node dependencies
and use Grunt to perform tasks. In the project's root folder (e.g. <somepath>/platform/), run:
npm install
Once things are installed, you may run the tests or use grunt to perform tasks.
Build minified project files (default):
grunt
Build documentation:
grunt docs
Run tests:
grunt test
We are currently in the early stages of investigating modern front-end tooling for projects built with {{site.project_title}}. This includes using Yeoman for scaffolding out {{site.project_title}} elements, Grunt for building and optimizing projects and Bower for component dependency management.
While our work in this area is just beginning, take a look at the potential workflow:
The {{site.project_title}} + Grunt proof-of-concept project is a good start. Also follow our work on generator-polymer.
We hope to announce more stable support for these projects in the near future.