New Developer Setup

New Developer Setup

Windows

Install Visual Studio 2017. Usually the LTAP Admin will do this, but if you are setting things up on your own go to https://docs.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=vs-2017 (Visual Studio 2019 will probably work as well, but this hasn't been tested). Once Visual Studio 2017 is installed on your computer, follow these steps.

1. Clone the TAMS4 Repository to your computer

   1. Open Visual Studio, this should display the default start page.
   2. In the top navbar, select View -> Team Explorer
   3. A panel titled “Team Explorer – Connect” should appear.
   4. Under the section “Local Git Repositories” click the dropdown button titled “Clone”.
   5. Make sure the checkbox “Recursively Clone Submodules” is selected.
   6. In the second text box, choose a location on your computer where you want to store the local repository.
   7. From the tams4 github repository, under the “<> Code” tab, select the “Clone or Download” button. Copy the link in the dropdown, and paste the link into the Visual Studio pane into the first text box where it says “Enter the URL of Git repo to clone ”. Then click the “Clone” button.
   8. Once the repository is cloned, you can open the project for development by double clicking on tams4a.sln file. This will open the project in visual studio.

2. Configure Package Manager Settings. To finish setting up Visual Studio for development, you will need to download and point to package manager to the correct files. Most of the packages can be accessed through nuget.org using their api, this is built into Visual Studio. One package you will have to manually add is DotSpatial.Plugins.ShapeEditor 1.0.1185(as of July 2020).

   1. Either go to https://www.myget.org/feed/dotspatial/package/nuget/DotSpatial.Plugins.ShapeEditor or search "myget DotSpatial.Plugins.ShapeEditor 1.0.1185" in Google.
   2. Make sure you are on the page for DotSpatial.Plugins.ShapeEditor 1.0.1185. At the bottom of the page click one of the two buttons to download the package file. Download the package folder somewhere on you computer. You will need to know where you save the package file so you can tell Visual Studio where the package can be found.
   3. Once the package is downloaded, open the project by clicking on the tams4a.sln file. Under the tools tab at the top taskbar, go to "Nuget Package Manager", and click "Package Manager Settings", a new window titled "Options" should open.
   4. Under the "Nuget Package Manager" tab, select "Package Sources" in the left panel. Click the green plus sign in the top right to add a new path to look for packages.
   5. In the bottom two textboxes you can change the name of the package source, and in the "source" textbox enter the path on your computer where you downloaded the DotSpatial.Plugins.ShapeEditor 1.0.1185 package. Then press the "Update" button, and the "OK" button.

3. Download Adobe Acrobat Reader. The TAMS program has functionality that can display PDFs so the computer running TAMS will need some way to open .pdf files.

   1. Go to https://get.adobe.com/reader/, or search for Adobe Acrobat Reader DC in Google.
   2. Make sure the check boxes for the chrome extension, and the McAfee are unchecked. Then click the button to download Acrobat Reader(you don't need to download the pro-version).
   3. Follow the onscreen directions to run the installer once the installer is downloaded(or go to your downloads folder and double click the installer that was downloaded). Follow the installer directions. Don't change any of the suggested installation paths.

Once these steps are complete, the packages for the tams4a.sln should be up to date. You can then click the "Start" button in Visual Studio to run the project in the debugger. If this doesn't work, you can contact Derek Smith at [email protected] for help (developer in 2020).