Enable typescript preprocessing on Ember 2.x apps.
In addition to ember-cli-typescript, the following files are required:
- typescript version 2.0.0 or better
- @type/ember
- tsconfig
You can setup all of these at once with:
ember install "ember-cli-typescript@emberwatch/ember-cli-typescript"
All dependencies will be added to your package.json, and you're ready to roll!
The configuration file is used by both Ember
CLI/broccoli and VS
Code/tsc
command line compiler.
Broccoli controls the inputs and the output folder of the various build steps that make the Ember build pipeline. Its expectation are impacted by Typescript configuration properties like "include", "exclude", "outFile", "outDir".
We want to allow you to change unrelated properties in the tsconfig file.
This addon takes the following approach to allow this dual use:
-
is starts with the following blueprint
-
the generated tsconfig file does not set "outDir" and sets "noEmit" to true. This allows you to run vscode and tsc without creating
.js
files throughout your codebase. -
before calling broccoli the addon removes "outDir" and sets "noEmit" and "includes"
Please let us know if this does not satisfy your use cases by opening issues on this repo.
You can customize this file further for your use case. For example to see the output of the compilation in a separate folder you are welcome to set and outDir and set noEmit to false. Then VS Code and tsc will generate files here while the broccoli pipeline will use its own temp folder.
If you porting an existing app to typescript you can install this addon and
migrate your files incrementally by changing their extensions from .js
to
.ts
. A good approach is to start at your leaf files and then work your way
up. As typescript starts to find errors make sure to celebrate your (small)
wins with your team, specially if some people are not convinced yet. We would also
love to hear your stories.
Create the file .vscode/settings.json
with the following content:
// Place your settings in this file to overwrite default and user settings.
{
"typescript.tsdk" : "node_modules/typescript/lib"
}