Differences

This shows you the differences between two versions of the page.

--- map_suite_mono_environment_setup_guide_on_linux [2017/03/01 07:33]
tgwikiupdate [WebAPI / WebForms:]
+++ map_suite_mono_environment_setup_guide_on_linux [2017/03/28 19:46] (current)
bradrollins [For Winforms:]
@@ Line 1: / Line 1: @@
 ====== Map Suite Mono Environment Setup Guide on Linux ======
-<div msgbox>The Map Suite mono environment setup guide on Linux will guide you through a process of setting Mono environment on Map Suite WebAPI and Map Suite WebForms. The guide supports Map Suite 10.0.0.0 and higher.</div>
+<div msgbox>The Map Suite Mono environment setup guide on Linux will guide you through a process of setting up a Mono environment for Map Suite WebAPI and Map Suite WebForms. The guide supports Map Suite 10.0.0.0 and higher.</div>
-The purpose of this guide is to help you quickly setup Map Suite WebAPI or Map Suite WebForms environment on Linux.
+The purpose of this guide is to help you quickly setup a Map Suite WebAPI or Map Suite WebForms environment on Linux.
-Map Suite controls are created with Microsoft .Net Frameworks. These controls are depended on Mono runtime and MonoDevelop IDE. Following steps will guide to setup Mono environment on Linux.
+Map Suite controls are created with Microsoft .Net Frameworks. These controls depend on the Mono runtime and MonoDevelop IDE. The following steps will guide you to setup a Mono environment on Linux.
 =====Setup Mono runtime and MonoDevelop IDE=====
@@ Line 12: / Line 12: @@
   * Prepare a clean Ubuntu environment with version [[https://www.ubuntu.com/download/desktop|16.04.01 LTS]].
   * Press Ctrl + Alt + T to open a terminal window.
-  * Install the IDE MonoDevelop as it is recommended to develop on Linux. Run the following command to install Mono Develop on your computer.
+  * Install the MonoDevelop IDE as it is recommended to develop on Linux. Run the following command to install Mono Develop on your computer.
 <code asp>
   sudo apt-get install monodevelop
 </code>
-  * Run monodevelop command in terminal to open MonoDevelop, or you can click on left top corner of task bar to search MonoDevelop and run it. You can open Visual Studio solution file via MonoDevelop.
+  * Type monodevelop in the terminal to open MonoDevelop or you can click on the left top corner of task bar to search MonoDevelop and run it. You can open the Visual Studio solution file via MonoDevelop.
 ====WebAPI / WebForms:====
-  * Follow the above steps 1-4, then proceed to the next step.
+  * Follow the above steps, then proceed to the next step.
   * Add the Mono Project GPG signin key and the package repository to your system (if you don’t use sudo, be sure to switch to root). Please issue the following commands line by line:
 <code asp>
@@ Line 41: / Line 41: @@
 sudo apt-get install referenceassemblies-pcl
 </code>
-//**Notice**//:Please enter Y when asked to continue. *
+//**Notice**//: Please enter Y when asked to continue. *
   * Run monodevelop command in terminal to open MonoDevelop, or you can click on left top corner of task bar to search MonoDevelop and run it. You can open Visual Studio solution file via MonoDevelop.
 =====Migrate Map Suite Web Projects from Windows to Linux=====
-We can create a WebForms project in MonoDevelop and install the NuGet packages. However, there are a couple of steps:
+We can create a WebForms project in MonoDevelop and install the NuGet packages. However, there are a couple of necessary steps:
-  - We cannot drag to add control to design page as MonoDevelop does not have a designer. We need to write aspx code manually.
+  - We cannot drag and drop to add a control to the design page as MonoDevelop does not have a designer. We need to write aspx code manually.
-  - The map control needs ScriptManager class in System.Web.Extensions assembly, but it is not referenced by default. We need to add it manually.
+  - The map control needs the ScriptManager class in System.Web.Extensions assembly, but it is not referenced by default. We need to add it manually.
-The WebAPI and WebForms projects created in Visual Studio on Windows cannot run on Linux with MonoDevelop directly. The following steps shows how to migrate them to MonoDevelop.
+The WebAPI and WebForms projects created in Visual Studio on Windows cannot run on Linux with MonoDevelop directly. The following steps show how to migrate them to MonoDevelop.
+  - Create a WebAPI or WebForms project with Visual Studio and copy the solution to Linux. Open the solution with MonoDevelop.
+  - After the project is created in Visual Studio, the project will rely on two NuGet packages by default. < * Microsoft.CodeDom.Providers.DotNetCompilerPlatform > and < * Microsoft.Net.Compilers >
+    These two packages are not supported on Linux. You need to uninstall them.
+    * Open the Packages solution folder.
+    * Right-Click on the package that you want to uninstall and click on remove.(See figure 1.)
+    {{:uninstall_package.png|uninstall}}
+\\
+//Figure 1. Uninstall the package that you want.//
+  * In Web.config of this project, you need to remove the xml element named system.codedom. Usually it will be found on the bottom of Web.config.
+  * After making these changes, press F5 to start the WebAPI project.

User Tools

Site Tools

Differences

Page Tools