第19篇 Protocol Buffers 编译器生成proto文件

1.下载 Protocol Buffers 编译器（protoc）

前往 Protocol Buffers GitHub Releases 页面。在 "Assets" 下找到适合您系统的压缩文件，通常为 protoc-{version}-win32.zip 或 protoc-{version}-win64.zip，其中 {version} 是版本号。

2.解压缩 Protoc 编译器

创建一个空文件夹，用于存放 protoc 编译器，将下载的压缩文件解压到该文件夹。找到 bin 文件所在目录，将路径复制下来。

3.设置环境变量

鼠标点击桌面左下角的搜索框，然后输入“环境变量”，搜索出来后双击鼠标点进去。
在弹出的窗口中选择“高级->环境变量”按钮。在“用户变量”里找到 path，双击打开。
点击“新建”并添加 protoc 编译器的路径，将刚才下载地址的 bin 路径粘贴进去即可。

4.验证安装

我们现在打开控制台看一下变量是否配置成功，Win+R然后输入 cmd，在命令行中运行命令protoc --version，如果看到版本信息，说明配置成功。

5.使用 protoc 编译 .proto 文件 转成C#，.cs文件

1. 检查 .NET SDK 安装

    dotnet --version
   

2. 重新安装 gRPC C# 工具，先执行卸载，再装

    dotnet tool uninstall -g dotnet-grpc
    dotnet tool install -g dotnet-grpc
   

3. 手动下载和安装【如果以上步骤无法安装】
   如果通过 dotnet tool install 命令无法安装 grpc_csharp_plugin.exe，你可以尝试手动下载和安装。

访问 gRPC GitHub 仓库。
导航到 grpc/src/csharp/Grpc.Tools 目录。
下载适用于你操作系统的 Grpc.Tools 包。

4. 手动安装
   解压下载的 Grpc.Tools 包。
   将解压后的文件夹中的 tools 目录复制到你希望安装插件的位置。
   将插件路径添加到系统的 PATH 环境变量中。

5. 检查环境变量
   确保 grpc_csharp_plugin.exe 的路径已添加到系统的 PATH 环境变量中。你可以通过以下步骤检查和配置环境变量：

Windows
右键点击“此电脑”或“计算机”，选择“属性”。
点击“高级系统设置”。
在“系统属性”窗口中，点击“环境变量”按钮。
在“系统变量”部分，找到并选择 Path 变量，然后点击“编辑”。
确保 C:\Users<YourUsername>.dotnet\tools 路径已添加到 Path 变量中。如果没有，请点击“新建”并添加该路径。

Linux/macOS
打开终端。
编辑 ~/.bashrc 或 ~/.zshrc 文件，添加以下行：

	export PATH="$PATH:$HOME/.dotnet/tools"

保存文件并运行以下命令使更改生效：

source ~/.bashrc

或

source ~/.zshrc

6. 使用绝对路径
   如果你找到了 grpc_csharp_plugin.exe 的路径，可以使用绝对路径来运行 protoc 命令：

example.proto文件内容

生成C#类文件的命令：

	protoc --proto_path=D:\Project\GrpcServiceDemo\protocolbuffers\protos --csharp_out=D:\Project\GrpcServiceDemo\protocolbuffers\codes --grpc_out=D:\Project\GrpcServiceDemo\protocolbuffers\codes --plugin=protoc-gen-grpc=D:\Project\GrpcServiceDemo\protocolbuffers\tools\windows_x64\grpc_csharp_plugin.exe example.proto

执行成功后，会生成这两个文件：

6.如果通过git仓库代码无法找到插件grpc_csharp_plugin.exe ，可以通过以下方式

1. 手动下载
   访问 NuGet 官方网站。
   搜索 Grpc.Tools 包。
   下载适用于你操作系统的包（例如 Grpc.Tools.2.41.0.nupkg）。

2. 解压 Grpc.Tools 包
   下载完成后，解压 Grpc.Tools 包。你可以使用以下命令解压 .nupkg 文件：

    mkdir Grpc.Tools
    unzip Grpc.Tools.2.41.0.nupkg -d Grpc.Tools
   

3. 配置环境变量
   将 grpc_csharp_plugin.exe 的路径添加到系统的 PATH 环境变量中。

Windows
右键点击“此电脑”或“计算机”，选择“属性”。
点击“高级系统设置”。
在“系统属性”窗口中，点击“环境变量”按钮。
在“系统变量”部分，找到并选择 Path 变量，然后点击“编辑”。
确保 Grpc.Tools/tools/windows_x64 路径已添加到 Path 变量中。如果没有，请点击“新建”并添加该路径。

Linux/macOS
打开终端。
编辑 ~/.bashrc 或 ~/.zshrc 文件，添加以下行：

export PATH="$PATH:/path/to/Grpc.Tools/tools/linux_x64"

或

export PATH="$PATH:/path/to/Grpc.Tools/tools/macosx_x64"

保存文件并运行以下命令使更改生效：

source ~/.bashrc

或

source ~/.zshrc