As of March 2019, this repo is no longer maintained by Microsoft. If you're interested in continuing this project, please feel free to fork it. As of March 2019, we will no longer monitor or respond to open issues. Thanks for your support!
Note. This template is based on Ionic 2 Beta 10.
A template to create Ionic 2 apps with Visual Studio tools for Apache Cordova using TypeScript
- Visual Studio 2015 Update 3
- Tools for Apache Cordova Update 10
- Microsoft ASP.Net and WebTools
- NPM Task Runner
- A recent version of Node/NPM
- A global installed version of Cordova,Ionic, and TypeScript npm packages:
npm i -g cordova ionic@beta typescript
Once you have your first project based on this template/repo created, you should follow the next steps:
VSCode will depend on you to execute npm install
from the root folder.
Visual Studio should start the restore process as soon the project is opened. You should see the Dependencies node in Solution Explorer show a message saying "Restoring..".
You can always invoke the restore process manually with RightClick->Restore Packages
To verify that the packages are completely restored you can check that the folder www\build
contains some folders.
Note. Visual Studio shows the restore log in the Output Window
Ctrl+Alt+O
under the Npm/Bower category.
Ionic uses Ionic App Scripts to perform some tasks like Sass, and TypeScript compilation to process your source code and produce the output in the www
folder.
Visual Studio 2015 includes a Task Runner Explorer that will show you all the available tasks to execute from the UI.
You can access the Task Runner Explorer from the Menu: View->Other Windows-Task Runner Explorer
or with the shortcut Ctrl+Alt+Bkspce
. Ensure that you've installed the NPM Task Runner (.vsix) which adds support for npm scripts defined in package.json directly in Visual Studio's Task Runner Explorer.
Note: To ensure that the default tasks are executed before the VS build, we configured the Task Runner Explorer binding the default task to the BeforeBuild event, however you can customize this setting to match your needs (e.g. Binding watch to project opened)
To execute this tasks from the CLI you manually run: npm run build
Note: If VS is unable to show the tasks, you can check the log in the Ouput window under the Task Runner Explorer Logs category.
Once you have all the packages restored, and the Gulp tasks executed, you can use your favorite cordova workflow:
Ionic cli offers the ionic serve
command to implement a Live Reload development workflow, you can obtain similar results executing the gulp task watch
and using the Live Reload capabilities of the Ripple Emulator
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.