Permalink
Branch: master
Find file Copy path
a46539e Mar 13, 2018
1 contributor

Users who have contributed to this file

141 lines (74 sloc) 7.25 KB

NEO Blockchain Quick Start Guide for .NET Developers

NEO Blockchain C# Developers Center of Excellence

The neo-csharpcoe project is an "umbrella" project for several initiatives related to providing tools and libraries (code), frameworks, how-to documentation, and best practices for enterprise application development using .NET/C#, C#.NEO and the NEO Blockchain software platform.

The neo-csharpcoe is an independent, free, open source project that is 100% community-supported by people like yourself through your contributions of time, energy, passion, promotion, and donations.

To learn more about contributing to the neo-csharpcoe, click here.

Activity 1 - Download and install Visual Studio 2017 Community Edition integrated development environment (IDE)

Purpose

The purpose of this activity is to download, install and perform basic configuration Visual Studio 2017 Community Edition if you don't already have an existing version of Visual Studio 2017 installed.

Goals, Non-Goals and Assumptions

  • Ensure you have a working and properly configured version of Visual Studio 2017 installed

Any additional Visual Studio customization steps are decribed in subsequent activities.

Visual Studio 2017 will install side-by-side with previous versions/editions of Visual Studio without affecting them (other than reducing your free disk space). This includes Visual Studio 2015 and Visual Studio Code, etc.

Principles

  • Provide reliable documentation: timely, accurate, visual, and complete
  • Save as much of a person's time as possible
  • Use open source software whenever possible

Drivers

  • Need in the NEO .NET developer community to have concise and easy-to-follow documentation to enable people to get up to speed developing NEO smart contracts in as short a time as possible

Download and install Visual Studio 2017 Community Edition integrated development environment (IDE)

There are 2 scenarios:

  • Scenario 1 - You don't have any version of Visual Studio 2017 installed
  • Scenario 2 - You have an existing verson of Visual Studio 2017 installed

If Scenario 1 applies to you, you need to perform the tasks in Scenario 1 and then skip Scenario 2.

If only scenario 2 applies to you, you can skip the tasks in Scenario 1 and only perform the tasks in Scenario 2.

In addition, it is quite useful to have the Visual Studio Code installed on your computer. The installation and configuration of Visual Studio Code is documented as Scenario 3 and is optional but recommended.

Visual Studio Code is a code editor redefined and optimized for building and debugging modern web and cloud applications. Visual Studio Code is free and available on your favorite platform - Linux, Mac OSX, and Windows. [VSCODE]

Scenario 1 - You don't have any version of Visual Studio 2017 installed

  1. Download the Visual Studio 2017 installer from either of:

  2. In your Downloads folder, double click on the vs_community.exe installer executable.

  3. Accept the Visual Studio EULA.

    Accept the Visual Studio EULA

    Figure 1.3. Accept the Visual Studio EULA

  4. Select the workloads (options) you want to use for your conventional front-end, middle-tier, and back-end components of your solution.

    Visual Studio Installer: Workloads

    Figure 1.4. Visual Studio Installer: Workloads

  5. IMPORTANT Select the .NET Core cross-platform development toolset to enable compilation of all of the NEO developer tools.

    Visual Studio Installer: Toolsets.

    Figure 1.5. Visual Studio Installer: Toolsets

  6. Click Modify to complete the installation.

  7. Installation complete.

    Installation complete

    Figure 1.6. Installation complete

  8. Test the installation. From the Windows start menu, type "visual studio". Select the Visual Studio app from the list. After a short delay, Visual Studio should start and look like something similar to the following.

    Test the installation

    Figure 1.7. Test the installation

Scenario 2 - You have an existing version of Visual Studio 2017 installed

If you have an existing version of Visual Studio 2017 installed, confirm that the required set of workloads and toolsets have been installed.

  1. Start Visual Studio 2017

    Visual Studio 2017

    Figure 1.8. Visual Studio 2017

  2. In the Visual Studio toolbar, select Tools > Get Tools and Features.... The Visual Studio installer will start.

    Visual Studio Installer

    Figure 1.9. Visual Studio Installer

  3. Proceed to Task 4 (above) in Scenario 1 - You don't have any version of Visual Studio 2017 installed and complete the remaining tasks.

Scenario 3 - (OPTIONAL) Installing and configuring Visual Studio Code

  1. Download the Visual Studio Code installer from either of:
  1. In your Downloads folder, double click on the VSCodeSetup-x64-1.20.0.exe installer executable.

  2. Follow the default installation instructions to completion.

  3. Test the installation. From the Windows start menu, type "visual studio code". Select the Visual Studio Code app from the list.

The tasks for this activity are complete. Proceed to Activity 2 - Download and unpack NEO developer tool projects (source).

References

  • [VSCODE] Microsoft, Microsoft Visual Studio Code web site