安装准备:
1.Visual Studio 2017 Community : 15.3.5
2.CMake : cmake-3.9.3-win64-x64.msi
3.Protobuf:3.4.1
开始安装
注:其实全部的步骤基本都有在README文件中有说明,文件在protobuf-3.4.1\cmake\README.md
1.VS2017的安装方面,按照指引安装,C#方面需要用到的插件和工具尽量按照默认的勾选进行安装,避免产生奇怪的异常
2.CMake的安装,默认安装,可以修改安装路径,安装后使用cmake确认是否路径配置也完成
3.Protobuf安装,需要通过CMake进行
(1)将Protobuf压缩包解压到磁盘目录下,在哪里不影响
例如:
F:\Protobuf\protobuf-3.4.1
(2)在Protobuf解压的目录内的cmake文件夹内建立debug,release文件夹(两者其一,或者两者兼备),用于CMake对Protobuf的debug版和release版的安装
例如:
F:\Protobuf\protobuf-3.4.1\cmake\build\debug
F:\Protobuf\protobuf-3.4.1\cmake\build\release
(3)在protobuf的解压目录创建install文件夹,用于在执行cmake install存放生成的文件
(4)进入对应的debug,release文件夹,使用VS CMD运行命令创建对应版本的makefile文件内容,这些文件用于往后的编译过程
例如:
(Debug)
cmake -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=../../../../install ../..
(Release)
cmake -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=../../../../install ../..
其中-G为指明生成的工程文件,-DCMAKE_BUILD_TYPE为指明生成工程类型,-DCMAKE_INSTALL_PREFIX重定向解压目录到上一步创建的文件夹
(5)然后完成之后再对应的debug或release文件夹目录下VS CMD运行nmake进行编译
(6)编译成功之后目录下会生成各式的文件,其中包含一个protoc.exe的执行文件,用作将proto各式文件转化为cs各式文件
(7)将protoc.exe所在的文件夹路径添加到环境变量的Path属性中方便使用,然后就可以在各处使用protoc进行转化
例如:
F:\Protobuf\protobuf-3.4.1\cmake\build\debug
(8)编写简单proto后缀文件在这里名为Hello.proto,将其生成cs后缀文件Hello.cs
例如:
protoc -I=F:\Protobuf\proto_file --csharp_out=F:\Protobuf\csharp_file Hello.proto
其中-I表示源文件所在文件夹地址,--cssharp_out表示生成平台为CSharp以及生成的文件存放目标地址,最后Hello.proto为源文件的文件名
(9)将cs文件添加到项目中,发现缺少google.protobuf一些文件库引用,VS2017的nuget管理功能可以添加这一缺少的程序包
(10)搜索google.protobuf,下载安装
(11)protobuf就可以在当前项目内进行使用了
备注
(1)在README中提到的使用cmake install解压出的文件内容如何关联VS项目暂时不明朗,不确定是否VS2017版本原因,使用nuget添加代码包为从GG的指引中获得的想法,暂时没有异常,待以后解决
End