From 87340e7eb9c4d7b94816d4e1b83aff20be1ed182 Mon Sep 17 00:00:00 2001 From: Mikejo5001 Date: Fri, 7 Aug 2015 10:01:41 -0700 Subject: [PATCH 01/14] adding Ionic getting started tutorial --- getting-started/tutorial-ionic.md | 101 ++++++++++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 getting-started/tutorial-ionic.md diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md new file mode 100644 index 00000000..bcb46050 --- /dev/null +++ b/getting-started/tutorial-ionic.md @@ -0,0 +1,101 @@ +#Getting started with Ionic apps in Visual Studio +[Ionic](http://www.ionicframework.com) is a popular front-end JavaScript framework for developing cross-platform mobile apps using Cordova. You can use Visual Studio 2015 and the Ionic CLI to easily create and debug cross-platform apps + +In this topic, we'll answer the following questions: + +- [How do I set up my machine for Ionic with VS?](#getStarted) +- [How do I get the Ionic starter app templates?] (#getTemplates) +- [How do I configure the templates to work with VS?] (#configTemplates) +- [How do I get the app running on different platforms?] (#configPlatforms) +- [Known Issues and Windows 10 tips] (#win10tips) + +**Note** For a video walkthrough that shows similar steps, see the [Video tutorial] (http://go.microsoft.com/fwlink/p/?LinkID=534728). + +##How do I set up my machine for Ionic with VS? + +To follow these steps, you must: +1. [Install Visual Studio 2015] (http://go.microsoft.com/fwlink/?LinkID=533794) with Visual Studio Tools for Apache Cordova. +2. [Install the Ionic CLI] (http://ionicframework.com/docs/cli/install.html). +3. Verify your VS setup is correct. Create a Blank App template (File > New > Project > JavaScript > Apache Cordova Apps > Blank App). Name it "blank". +4. Run the Blank App template against Windows > Local Machine to make sure everything is working (the app loads correctly). If any issues occur, see [Configure the Tools] (https://msdn.microsoft.com/en-us/library/dn771551.aspx). + +##How do I get the Ionic starter app templates? + +1. Make sure you installed the Ionic CLI, then open a command line. +2. Go to the directory where you want to install the Ionic starter app templates, such as the Documents folder. +3. In the command line, type + ~~~~~~~~~~~~~~~~~~~~~~~ + ionic start ionicMySideMenu sidemenu. + ~~~~~~~~~~~~~~~~~~~~~~~ + Ionic creates the project. +4. Use the same command to install more templates, such as: + ~~~~~~~~~~~~~~~~~~~~~~~ + ionic start ionicMyView view + ionic start ionicMyTabs tabs + ionic start ionicMySlide slide + ~~~~~~~~~~~~~~~~~~~~~~~ + +##How do I configure the templates to work with VS? + +For each of the Ionic starter app templates that you installed, do this: +1. In Windows, open the folder where you created the Blank App project (which you named "blank" in the previous steps). +2. Copy blank.jsproj and taco.json from this folder to the Ionic starter template folder (e.g., ionicMySideMenu). + **Note** You may want to rename blank.jsproj to ionicMySideMenu.jsproj (or to the name of your starter template project). +4. In the Ionic starter template folder, open the .jsproj file. It will open in Visual Studio 2015. +5. Save the project to create a Visual Studio solution File (.sln). + +##How do I get the app running on different platforms? + +For Android: +1. If you want to use the Ionic CLI to add the Android platform, use this command in the command line: + ~~~~~~~~~~~~~~~~~~~~~~~ + ionic platform add Android + ~~~~~~~~~~~~~~~~~~~~~~~ + Or, you can add the platform by building in VS (Build > Build Solution). +2. Choose Android as a debug target (Solution Platforms list), and to get the app running choose a target such as Ripple (Chrome required) or the VS Emulator 5" KitKat (4.4) (Hyper-V required). +3. Press F5, and the app should load correctly. +**Note** If you have previously run the VS Emulator for Android and you have errors, try deleting the emulator VM instance in Hyper-V Manager. Otherwise, if you have errors see [Troubleshooting] (https://msdn.microsoft.com/en-us/library/mt228282(v=vs.140).aspx). +4. In some of the Ionic starter app templates, you may need to replace this line in app.js: + ```JavaScript + if (window.cordova && window.cordova.plugins.Keyboard) { + ``` +with this line, to prevent a runtime error: + ```JavaScript + if (window.cordova && window.cordova.plugins && + window.cordova.plugins.Keyboard) { + ``` +5. In some of the Ionic starter app templates, you may also need to remove the TypeScript file, angular-ui-router.d.ts, for the angular-ui-router module, or you may see this error. +![TypeScript error] (media/ionic-ts2304.PNG) +**Note** If you are using TypeScript, you need to get an updated version of the file or the template to support the routing module. + +For Windows & Windows Phone 8.1: +1. Open the folder for the Blank App project, and copy the merges folder (and its contents) to your Ionic project. Copy the folder under the top level folder (e.g., under ionicMySideMenu folder). This will resolve errors loading partial pages by using the winstore-jscompat.js shim. +2. Copy platformOverrides.js from the Blank App project's `www\js` folder to the Ionic project's `www\js` folder. +3. In the Ionic project, add the following script reference to index.html, just before the Ionic Framework reference (before the ionic.bundle.js reference): + ~~~~~~~~~~~~~~~~~~~~~~~ + + ~~~~~~~~~~~~~~~~~~~~~~~ +4. Select Windows or Windows Phone (Universal) as a debug target (Solution Platforms list). +* For Windows, choose Local Machine as a target. +* For Windows Phone 8.1, choose one of the Emulator 8.1 options. +5. Press F5 to start debugging. +**Note** If you see the TypeScript error or the Keyboard plugin error, see the previous steps for Android to resolve. + +For iOS: + +You can run initially on the Ripple Emulator after selecting iOS as a debug target, but for detailed info on setting up the remotebuild agent for iOS, see [this topic] (https://msdn.microsoft.com/en-us/library/dn757054.aspx#ios). + +The Ionic starter app should run correctly on iOS when the remotebuild agent is running on a Mac, and when VS is configured to connect to it. (the steps are outside the scope here.) + +##Known Issues and Windows 10 tips + +On Windows 8.1 dev machine, you may get a WWAHost runtime error when navigating between pages in the Ionic apps. You can work around this by: +* Closing DOM Explorer before navigating pages. +* Upgrading to Windows 10 on your dev machine (issue is fixed in Win10). + +To target Windows 10 in the app, you need to: +* Use VS install program to install optional software, the Universal Windows App Development Tools. +* In the configuration designer, select Cordova 5.1.1 and, in the Windows tab, choose Windows 10. +However, if you target Windows 10 in the app, note that you may get errors loading partial pages, such as this unhandled exception. +![unhandled exception](media/ionic-unhandled-exception.PNG) +If you see this error when targeting Win/WinPhone 8.1, follow the earlier steps to call platformOverrides.js to fix this issue. Targeting Win10, this fix currently requires another update to the compatibility shim or a platform fix. From 0aef028f57d4e5b0fbb1aa5410f802875ee24f2e Mon Sep 17 00:00:00 2001 From: Mikejo5001 Date: Fri, 7 Aug 2015 10:08:20 -0700 Subject: [PATCH 02/14] formatting fixes --- getting-started/tutorial-ionic.md | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index bcb46050..51d59110 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -24,11 +24,14 @@ To follow these steps, you must: 1. Make sure you installed the Ionic CLI, then open a command line. 2. Go to the directory where you want to install the Ionic starter app templates, such as the Documents folder. 3. In the command line, type + ~~~~~~~~~~~~~~~~~~~~~~~ ionic start ionicMySideMenu sidemenu. ~~~~~~~~~~~~~~~~~~~~~~~ + Ionic creates the project. 4. Use the same command to install more templates, such as: + ~~~~~~~~~~~~~~~~~~~~~~~ ionic start ionicMyView view ionic start ionicMyTabs tabs @@ -48,33 +51,39 @@ For each of the Ionic starter app templates that you installed, do this: For Android: 1. If you want to use the Ionic CLI to add the Android platform, use this command in the command line: + ~~~~~~~~~~~~~~~~~~~~~~~ ionic platform add Android ~~~~~~~~~~~~~~~~~~~~~~~ + Or, you can add the platform by building in VS (Build > Build Solution). 2. Choose Android as a debug target (Solution Platforms list), and to get the app running choose a target such as Ripple (Chrome required) or the VS Emulator 5" KitKat (4.4) (Hyper-V required). 3. Press F5, and the app should load correctly. **Note** If you have previously run the VS Emulator for Android and you have errors, try deleting the emulator VM instance in Hyper-V Manager. Otherwise, if you have errors see [Troubleshooting] (https://msdn.microsoft.com/en-us/library/mt228282(v=vs.140).aspx). 4. In some of the Ionic starter app templates, you may need to replace this line in app.js: + ```JavaScript if (window.cordova && window.cordova.plugins.Keyboard) { ``` with this line, to prevent a runtime error: + ```JavaScript if (window.cordova && window.cordova.plugins && window.cordova.plugins.Keyboard) { ``` 5. In some of the Ionic starter app templates, you may also need to remove the TypeScript file, angular-ui-router.d.ts, for the angular-ui-router module, or you may see this error. -![TypeScript error] (media/ionic-ts2304.PNG) +![TypeScript error] (media/ionic-ts2304.png) **Note** If you are using TypeScript, you need to get an updated version of the file or the template to support the routing module. For Windows & Windows Phone 8.1: 1. Open the folder for the Blank App project, and copy the merges folder (and its contents) to your Ionic project. Copy the folder under the top level folder (e.g., under ionicMySideMenu folder). This will resolve errors loading partial pages by using the winstore-jscompat.js shim. 2. Copy platformOverrides.js from the Blank App project's `www\js` folder to the Ionic project's `www\js` folder. 3. In the Ionic project, add the following script reference to index.html, just before the Ionic Framework reference (before the ionic.bundle.js reference): + ~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~ + 4. Select Windows or Windows Phone (Universal) as a debug target (Solution Platforms list). * For Windows, choose Local Machine as a target. * For Windows Phone 8.1, choose one of the Emulator 8.1 options. @@ -94,8 +103,10 @@ On Windows 8.1 dev machine, you may get a WWAHost runtime error when navigating * Upgrading to Windows 10 on your dev machine (issue is fixed in Win10). To target Windows 10 in the app, you need to: -* Use VS install program to install optional software, the Universal Windows App Development Tools. +* Use VS install program to install the Universal Windows App Development Tools (optional software). * In the configuration designer, select Cordova 5.1.1 and, in the Windows tab, choose Windows 10. However, if you target Windows 10 in the app, note that you may get errors loading partial pages, such as this unhandled exception. -![unhandled exception](media/ionic-unhandled-exception.PNG) -If you see this error when targeting Win/WinPhone 8.1, follow the earlier steps to call platformOverrides.js to fix this issue. Targeting Win10, this fix currently requires another update to the compatibility shim or a platform fix. + +![unhandled exception](media/ionic-unhandled-exception.png) + +If you see this error when targeting Win/WinPhone 8.1, follow the earlier steps to call platformOverrides.js to fix this issue. When targeting Win10, this fix currently requires another update to the compatibility shim or a platform fix. From d886e7dd554111ca133205f91c539b955836d038 Mon Sep 17 00:00:00 2001 From: Mikejo5001 Date: Fri, 7 Aug 2015 10:10:19 -0700 Subject: [PATCH 03/14] formatting fixes --- getting-started/tutorial-ionic.md | 1 + 1 file changed, 1 insertion(+) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index 51d59110..1c6608d6 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -14,6 +14,7 @@ In this topic, we'll answer the following questions: ##How do I set up my machine for Ionic with VS? To follow these steps, you must: + 1. [Install Visual Studio 2015] (http://go.microsoft.com/fwlink/?LinkID=533794) with Visual Studio Tools for Apache Cordova. 2. [Install the Ionic CLI] (http://ionicframework.com/docs/cli/install.html). 3. Verify your VS setup is correct. Create a Blank App template (File > New > Project > JavaScript > Apache Cordova Apps > Blank App). Name it "blank". From 4758af5234cb503c1ce54865447d44978dbcaffa Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:15:06 -0700 Subject: [PATCH 04/14] formatting --- getting-started/tutorial-ionic.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index 1c6608d6..ef12ad94 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -51,6 +51,7 @@ For each of the Ionic starter app templates that you installed, do this: ##How do I get the app running on different platforms? For Android: + 1. If you want to use the Ionic CLI to add the Android platform, use this command in the command line: ~~~~~~~~~~~~~~~~~~~~~~~ @@ -74,9 +75,11 @@ with this line, to prevent a runtime error: ``` 5. In some of the Ionic starter app templates, you may also need to remove the TypeScript file, angular-ui-router.d.ts, for the angular-ui-router module, or you may see this error. ![TypeScript error] (media/ionic-ts2304.png) + **Note** If you are using TypeScript, you need to get an updated version of the file or the template to support the routing module. For Windows & Windows Phone 8.1: + 1. Open the folder for the Blank App project, and copy the merges folder (and its contents) to your Ionic project. Copy the folder under the top level folder (e.g., under ionicMySideMenu folder). This will resolve errors loading partial pages by using the winstore-jscompat.js shim. 2. Copy platformOverrides.js from the Blank App project's `www\js` folder to the Ionic project's `www\js` folder. 3. In the Ionic project, add the following script reference to index.html, just before the Ionic Framework reference (before the ionic.bundle.js reference): @@ -89,7 +92,8 @@ For Windows & Windows Phone 8.1: * For Windows, choose Local Machine as a target. * For Windows Phone 8.1, choose one of the Emulator 8.1 options. 5. Press F5 to start debugging. -**Note** If you see the TypeScript error or the Keyboard plugin error, see the previous steps for Android to resolve. + + **Note** If you see the TypeScript error or the Keyboard plugin error, see the previous steps for Android to resolve. For iOS: @@ -106,7 +110,7 @@ On Windows 8.1 dev machine, you may get a WWAHost runtime error when navigating To target Windows 10 in the app, you need to: * Use VS install program to install the Universal Windows App Development Tools (optional software). * In the configuration designer, select Cordova 5.1.1 and, in the Windows tab, choose Windows 10. -However, if you target Windows 10 in the app, note that you may get errors loading partial pages, such as this unhandled exception. +However, if you target Windows 10 in the app, note that you may get errors loading partial pages in Ionic apps, such as this unhandled exception. ![unhandled exception](media/ionic-unhandled-exception.png) From 0f258d379aef38b3967aaa54465bbcf79da335b1 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:15:40 -0700 Subject: [PATCH 05/14] formatting --- getting-started/tutorial-ionic.md | 1 + 1 file changed, 1 insertion(+) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index ef12ad94..d0f10b73 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -42,6 +42,7 @@ To follow these steps, you must: ##How do I configure the templates to work with VS? For each of the Ionic starter app templates that you installed, do this: + 1. In Windows, open the folder where you created the Blank App project (which you named "blank" in the previous steps). 2. Copy blank.jsproj and taco.json from this folder to the Ionic starter template folder (e.g., ionicMySideMenu). **Note** You may want to rename blank.jsproj to ionicMySideMenu.jsproj (or to the name of your starter template project). From 09005f57d399e5ac2c067321e3aa7cf11340eaf5 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:16:50 -0700 Subject: [PATCH 06/14] formatting --- getting-started/tutorial-ionic.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index d0f10b73..f101b2f0 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -62,7 +62,8 @@ For Android: Or, you can add the platform by building in VS (Build > Build Solution). 2. Choose Android as a debug target (Solution Platforms list), and to get the app running choose a target such as Ripple (Chrome required) or the VS Emulator 5" KitKat (4.4) (Hyper-V required). 3. Press F5, and the app should load correctly. -**Note** If you have previously run the VS Emulator for Android and you have errors, try deleting the emulator VM instance in Hyper-V Manager. Otherwise, if you have errors see [Troubleshooting] (https://msdn.microsoft.com/en-us/library/mt228282(v=vs.140).aspx). + + **Note** If you have previously run the VS Emulator for Android and you have errors, try deleting the emulator VM instance in Hyper-V Manager. Otherwise, if you have errors see [Troubleshooting] (https://msdn.microsoft.com/en-us/library/mt228282(v=vs.140).aspx). 4. In some of the Ionic starter app templates, you may need to replace this line in app.js: ```JavaScript From 7032feea3efe5fd3e7c6242eac1246d95d0e8d3d Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:19:44 -0700 Subject: [PATCH 07/14] formatting --- getting-started/tutorial-ionic.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index f101b2f0..cecc9361 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -27,7 +27,7 @@ To follow these steps, you must: 3. In the command line, type ~~~~~~~~~~~~~~~~~~~~~~~ - ionic start ionicMySideMenu sidemenu. + ionic start ionicMySideMenu sidemenu ~~~~~~~~~~~~~~~~~~~~~~~ Ionic creates the project. @@ -63,7 +63,7 @@ For Android: 2. Choose Android as a debug target (Solution Platforms list), and to get the app running choose a target such as Ripple (Chrome required) or the VS Emulator 5" KitKat (4.4) (Hyper-V required). 3. Press F5, and the app should load correctly. - **Note** If you have previously run the VS Emulator for Android and you have errors, try deleting the emulator VM instance in Hyper-V Manager. Otherwise, if you have errors see [Troubleshooting] (https://msdn.microsoft.com/en-us/library/mt228282(v=vs.140).aspx). + > **Note** If you have previously run the VS Emulator for Android and you have errors, try deleting the emulator VM instance in Hyper-V Manager. Otherwise, if you have errors see [Troubleshooting] (https://msdn.microsoft.com/en-us/library/mt228282(v=vs.140).aspx). 4. In some of the Ionic starter app templates, you may need to replace this line in app.js: ```JavaScript @@ -78,7 +78,7 @@ with this line, to prevent a runtime error: 5. In some of the Ionic starter app templates, you may also need to remove the TypeScript file, angular-ui-router.d.ts, for the angular-ui-router module, or you may see this error. ![TypeScript error] (media/ionic-ts2304.png) -**Note** If you are using TypeScript, you need to get an updated version of the file or the template to support the routing module. + > **Note** If you are using TypeScript, you need to get an updated version of the file or the template to support the routing module. For Windows & Windows Phone 8.1: @@ -95,7 +95,7 @@ For Windows & Windows Phone 8.1: * For Windows Phone 8.1, choose one of the Emulator 8.1 options. 5. Press F5 to start debugging. - **Note** If you see the TypeScript error or the Keyboard plugin error, see the previous steps for Android to resolve. + > **Note** If you see the TypeScript error or the Keyboard plugin error, see the previous steps for Android to resolve. For iOS: From 33fc70b709e1451aa41712d87eeff4e264be6cc5 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:20:28 -0700 Subject: [PATCH 08/14] formatting --- getting-started/tutorial-ionic.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index cecc9361..c9c2bf78 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -45,7 +45,7 @@ For each of the Ionic starter app templates that you installed, do this: 1. In Windows, open the folder where you created the Blank App project (which you named "blank" in the previous steps). 2. Copy blank.jsproj and taco.json from this folder to the Ionic starter template folder (e.g., ionicMySideMenu). - **Note** You may want to rename blank.jsproj to ionicMySideMenu.jsproj (or to the name of your starter template project). + > **Note** You may want to rename blank.jsproj to ionicMySideMenu.jsproj (or to the name of your starter template project). 4. In the Ionic starter template folder, open the .jsproj file. It will open in Visual Studio 2015. 5. Save the project to create a Visual Studio solution File (.sln). From a3927f756703a508387d858ff63064683d9f9474 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:21:10 -0700 Subject: [PATCH 09/14] formatting --- getting-started/tutorial-ionic.md | 1 + 1 file changed, 1 insertion(+) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index c9c2bf78..96620168 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -45,6 +45,7 @@ For each of the Ionic starter app templates that you installed, do this: 1. In Windows, open the folder where you created the Blank App project (which you named "blank" in the previous steps). 2. Copy blank.jsproj and taco.json from this folder to the Ionic starter template folder (e.g., ionicMySideMenu). + > **Note** You may want to rename blank.jsproj to ionicMySideMenu.jsproj (or to the name of your starter template project). 4. In the Ionic starter template folder, open the .jsproj file. It will open in Visual Studio 2015. 5. Save the project to create a Visual Studio solution File (.sln). From 36239c0d29f82093bc4ddce293eaadaf9c3dd726 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:21:57 -0700 Subject: [PATCH 10/14] edits --- getting-started/tutorial-ionic.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index 96620168..9ef3d898 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -30,7 +30,7 @@ To follow these steps, you must: ionic start ionicMySideMenu sidemenu ~~~~~~~~~~~~~~~~~~~~~~~ - Ionic creates the project. + Ionic creates the project in your current folder. 4. Use the same command to install more templates, such as: ~~~~~~~~~~~~~~~~~~~~~~~ From f46569721f4ba28bad8a5f2ebaa95afd92cb0d35 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:26:01 -0700 Subject: [PATCH 11/14] formatting --- getting-started/tutorial-ionic.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index 9ef3d898..2edd7e3a 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -77,6 +77,7 @@ with this line, to prevent a runtime error: window.cordova.plugins.Keyboard) { ``` 5. In some of the Ionic starter app templates, you may also need to remove the TypeScript file, angular-ui-router.d.ts, for the angular-ui-router module, or you may see this error. + ![TypeScript error] (media/ionic-ts2304.png) > **Note** If you are using TypeScript, you need to get an updated version of the file or the template to support the routing module. @@ -102,7 +103,7 @@ For iOS: You can run initially on the Ripple Emulator after selecting iOS as a debug target, but for detailed info on setting up the remotebuild agent for iOS, see [this topic] (https://msdn.microsoft.com/en-us/library/dn757054.aspx#ios). -The Ionic starter app should run correctly on iOS when the remotebuild agent is running on a Mac, and when VS is configured to connect to it. (the steps are outside the scope here.) +The Ionic starter app should run correctly on iOS when the remotebuild agent is running on a Mac, and when VS is configured to connect to it. (The complete steps are outside the scope here.) ##Known Issues and Windows 10 tips From e9e03955a15a523945e410efd544b7b559847eb3 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:31:52 -0700 Subject: [PATCH 12/14] formatting --- getting-started/tutorial-ionic.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index 2edd7e3a..4ef2900a 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -84,7 +84,7 @@ with this line, to prevent a runtime error: For Windows & Windows Phone 8.1: -1. Open the folder for the Blank App project, and copy the merges folder (and its contents) to your Ionic project. Copy the folder under the top level folder (e.g., under ionicMySideMenu folder). This will resolve errors loading partial pages by using the winstore-jscompat.js shim. +1. Open the folder for the Blank App project and copy the merges folder (and its contents) to your Ionic project. Copy the folder under the top level folder (e.g., under ionicMySideMenu folder). When you complete the next few steps, you will resolve errors loading partial pages by using the winstore-jscompat.js shim. 2. Copy platformOverrides.js from the Blank App project's `www\js` folder to the Ionic project's `www\js` folder. 3. In the Ionic project, add the following script reference to index.html, just before the Ionic Framework reference (before the ionic.bundle.js reference): @@ -107,7 +107,7 @@ The Ionic starter app should run correctly on iOS when the remotebuild agent is ##Known Issues and Windows 10 tips -On Windows 8.1 dev machine, you may get a WWAHost runtime error when navigating between pages in the Ionic apps. You can work around this by: +When debugging on a Windows 8.1 dev machine, you may get a WWAHost runtime error when navigating between pages in Ionic apps. You can work around this by: * Closing DOM Explorer before navigating pages. * Upgrading to Windows 10 on your dev machine (issue is fixed in Win10). From f7f14e34efa546a696db2c1a1c5e0146c8e572d4 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 10:37:56 -0700 Subject: [PATCH 13/14] formatting --- getting-started/tutorial-ionic.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index 4ef2900a..a97327ad 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -80,7 +80,7 @@ with this line, to prevent a runtime error: ![TypeScript error] (media/ionic-ts2304.png) - > **Note** If you are using TypeScript, you need to get an updated version of the file or the template to support the routing module. + > **Note** If you are using TypeScript, you need to get updated d.ts files or an updated version of the template to support the routing module. For Windows & Windows Phone 8.1: From 6e1e36972a03dc5bf21d039a8a44b138e7dbfe60 Mon Sep 17 00:00:00 2001 From: Mike Jones Date: Fri, 7 Aug 2015 11:04:04 -0700 Subject: [PATCH 14/14] minor edits --- getting-started/tutorial-ionic.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting-started/tutorial-ionic.md b/getting-started/tutorial-ionic.md index a97327ad..70b9500f 100644 --- a/getting-started/tutorial-ionic.md +++ b/getting-started/tutorial-ionic.md @@ -7,7 +7,7 @@ In this topic, we'll answer the following questions: - [How do I get the Ionic starter app templates?] (#getTemplates) - [How do I configure the templates to work with VS?] (#configTemplates) - [How do I get the app running on different platforms?] (#configPlatforms) -- [Known Issues and Windows 10 tips] (#win10tips) +- [Known issues and Windows 10 tips] (#win10tips) **Note** For a video walkthrough that shows similar steps, see the [Video tutorial] (http://go.microsoft.com/fwlink/p/?LinkID=534728). @@ -105,7 +105,7 @@ You can run initially on the Ripple Emulator after selecting iOS as a debug targ The Ionic starter app should run correctly on iOS when the remotebuild agent is running on a Mac, and when VS is configured to connect to it. (The complete steps are outside the scope here.) -##Known Issues and Windows 10 tips +##Known issues and Windows 10 tips When debugging on a Windows 8.1 dev machine, you may get a WWAHost runtime error when navigating between pages in Ionic apps. You can work around this by: * Closing DOM Explorer before navigating pages.