# gsharpc使用指南
因为gsharpc不是直接将C#源代码编译到hvm字节码，所以需要安装Visual Studio 2017(有免费的社区版)或者.Net Framework SDK来将C#源码编译到.Net字节码文件先， 然后再使用gsharpc编译.Net字节码文件dll文件转换到hvm字节码，推荐安装Visual Studio 2017
可以按照以下步骤配置开发环境:
- 请安装Visual Studio 2017 Community，安装时请确保其中的C#开发环境选中安装。
- 新建C#类库项目(.Net Framework)，在项目的“引用”中加入gsharpc的几个.dll文件。这个项目就是用来写智能合约或者链上脚本的项目，最终我们就是要把这个项目编译到hvm字节码
- 参照demo中例子，Class1.cs是支持的主要语法的例子。DemoContract1.cs是智能合约的例子。修改新建项目的Class1.cs(建议改为其他文件名)
- 在同一个Visual Studio解决方案下，添加创建一个新的C#控制台项目(.Net Framework)，在项目的“引用”中加入gsharpc的几个.dll文件,并在项目引用中添加刚刚创建的类库项目。 这个项目是用来直接在Visual Studio中调试调用智能合约C#代码用的，将此项目设置为解决方案的启动项目
- 在第4步创建的C#控制台项目中，可以运行项目对第2步创建的类库项目进行调试运行
- 编译整个解决方案，在第2步创建的类库项目的bin/Debug或者bin/Release文件夹下（根据是Debug还是Release模式区分）找到 "{项目名}.dll"，这就是项目产生的.dll文件
- 执行
gsharpc -gpc 第6步产生的文件路径.dll产生"项目名.gpc"，这是目标的合约.gpc文件 - 使用产生的.gpc文件来做注册合约，调用合约，注册脚本等后续行为
- 如果是不是要写合约上链，只是要执行代码，需要在第5步中，使用gsharpc -c 文件路径.dll 来产生 "项目名.out"文件，这是hvm字节码文件，然后可以用
hvm 文件路径.out来直接执行这个字节码文件 - 暂时尽量不要用Release模式编译C#项目。Release模式会把一些null值优化成0，而在hvm中0和hvm是不一致的，目前gsharpc不支持Release模式编译产生的dll