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 greater
- @types/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"
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.
Please see the wiki for additional how to tips from other users or to add your own tips. If an use case is frequent enough we can codify in the plugin. https://github.com/emberwatch/ember-cli-typescript/wiki/tsconfig-how-to
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"
}