NEO Blockchain Quick Start Guide for .NET Developers
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.
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)
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.
- Provide reliable documentation: timely, accurate, visual, and complete
- Save as much of a person's time as possible
- Use open source software whenever possible
- 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
Download the Visual Studio 2017 installer from either of:
Figure 1.1. Generic Visual Studio downloads site (all editions)
Figure 1.2. Visual Studio Community Edition specific download site
In your Downloads folder, double click on the
Accept the Visual Studio EULA.
Figure 1.3. Accept the Visual Studio EULA
Select the workloads (options) you want to use for your conventional front-end, middle-tier, and back-end components of your solution.
Figure 1.4. Visual Studio Installer: Workloads
IMPORTANT Select the
.NET Core cross-platform developmenttoolset to enable compilation of all of the NEO developer tools.
Figure 1.5. Visual Studio Installer: Toolsets
Modifyto complete the installation.
Figure 1.6. Installation complete
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.
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.
Start Visual Studio 2017
Figure 1.8. Visual Studio 2017
In the Visual Studio toolbar, select
Tools > Get Tools and Features.... The Visual Studio installer will start.
Figure 1.9. Visual Studio Installer
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
- Download the Visual Studio Code installer from either of:
Figure 1.10. Generic Visual Studio downloads site (all editions)
Figure 1.11. Visual Studio Code specific download site
In your Downloads folder, double click on the
Follow the default installation instructions to completion.
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).
- [VSCODE] Microsoft, Microsoft Visual Studio Code web site