Getting started¶
Download¶
- Navigate to the repository
- On the landing page select your desired gRPC version
Or use following release table
| Version | Build-Info | All Build-Configurations | Examples |
|---|---|---|---|
| 1.71.0 ( latest) | link | ||
| 1.46.6 ( latest) | link | ||
| 1.70.1 | link | ||
| 1.70.0 | link | ||
| 1.69.0 | link | ||
| 1.68.2 | link | ||
| 1.68.1 | link | ||
| 1.68.0 | link | ||
| 1.67.0 | link | ||
| 1.66.2 | link | ||
| 1.66.1 | link | ||
| 1.65.0 | link | ||
| 1.64.2 | link | ||
| 1.64.1 | link | ||
| 1.64.0 | link | ||
| 1.63.0 | link | ||
| 1.62.1 | link | ||
| 1.62.0 | link | ||
| 1.61.1 | link | ||
| 1.61.0 | link | ||
| 1.60.0 | link | ||
| 1.59.1 | link | ||
| 1.58.0 | link | ||
| 1.57.0 | link | ||
| 1.56.2 | link | ||
| 1.56.0 | link | ||
| 1.55.1 | link | ||
| 1.55.0 | link | ||
| 1.54.2 | link | ||
| 1.54.1 | link | ||
| 1.54.0 | link | ||
| 1.53.0 | link | ||
| 1.52.1 | link | ||
| 1.52.0 | link | ||
| 1.51.1 | link | ||
| 1.51.0 | link | ||
| 1.50.1 | link | ||
| 1.50.0 | link | ||
| 1.49.1 | link | ||
| 1.48.0 | link | ||
| 1.47.0 | link | ||
| 1.46.5 | link | ||
| 1.46.4 | link | ||
| 1.46.3 | link | ||
| 1.46.1 | link | ||
| 1.46.0 | link | ||
| 1.45.2 | link | ||
| 1.45.1 | link | ||
| 1.45.0 | link | ||
| 1.44.0 | link | ||
| 1.43.2 | link | ||
| 1.43.0 | link | ||
| 1.42.0 | link | ||
| 1.41.1 | link | ||
| 1.41.0 | link | ||
| 1.40.0 | link | ||
| 1.39.1 | link | ||
| 1.22.0 | link | ||
| 1.21.4 | link | ||
| 1.20.0 | link |
The precompiled libraries are attached as assets compressed in zip archives to the bottom of the page. !!! warning "So far all releases had been successfully built and tested against 2019 and 2022 compilers.
Success
- Downloaded one or more archives e.g.:
MSVC143_64.zip. - Downloaded the corresponding
Examples.zipof the release.
Unpack the archives¶
If you completed the task, proceed as follows to this project setup
.
├─ vs2015/ # -> From Examples.zip - Directory containing project files (organize source code files and other resources) for Visual Studio 2015
├─ vs2017/ # -> From Examples.zip - Directory containing project files (organize source code files and other resources) for Visual Studio 2017
├─ vs2019/ # -> From Examples.zip - Directory containing project files (organize source code files and other resources) for Visual Studio 2019
├─ vs2022/ # -> From Examples.zip - Directory containing project files (organize source code files and other resources) for Visual Studio 2022
├─ MSVC140_32/ # -> From MSC140_32.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2015 targeting 32-bit
├─ MSVC140_64/ # -> From MSC140_64.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2015 targeting 64-bit
├─ MSVC140_32/ # -> From MSC141_32.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2017 targeting 32-bit
├─ MSVC140_64/ # -> From MSC141_64.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2017 targeting 64-bit
├─ MSVC142_32/ # -> From MSC142_32.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2019 targeting 32-bit
├─ MSVC142_64/ # -> From MSC142_64.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2019 targeting 64-bit
├─ MSVC143_32/ # -> From MSC143_32.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2022 targeting 32-bit
├─ MSVC143_64/ # -> From MSC143_64.zip - Directory containing the prebuilt libraries and header files for Visual Studio 2022 targeting 64-bit
├─ .gitattributes # Can be ignored.
├─ .gitignore # Can be ignored.
└─ README.md # Can be ingored.
Build Examples¶
The project setup¶
Place for holding the Visual Studio Examples source code is following git repository
(from version 1.43.0) In every directory there is solution file with Examples_<vs_compiler_name>.sln and other directories holding the wanted examples, required project, configuration and resource files. For e.g. vs2019 the directory-file-tree looks like that
.
├─ vs2019/
│ ├─ 0_HelperScripts/* # Contains required helper projects e.g. copying files or calling the protobuf compiler
│ ├─ 1_HelloWorld_Client/* # Contains project files and source code for this example
│ ├─ 1_HelloWorld_Server/* # ~
│ ├─ 2_HelloWorld_Client_Callback/* # ~
│ ├─ 2_HelloWorld_Server_Callback/* # ~
│ ├─ 3_HelloWorld_Client_Async_1/* # ~
│ ├─ 3_HelloWorld_Client_Async_2/* # ~
│ ├─ 3_HelloWorld_Server_Async/* # ~
│ ├─ 4_HelloWorld_Client_Compression/* # ~
│ ├─ 4_HelloWorld_Server_Compression/* # ~
│ ├─ 5_HelloWorld_Client_Load_Balancing/* # ~
│ ├─ 5_HelloWorld_Server_Load_Balancing/* # ~
│ ├─ 6_HelloWorld_Client_Meta/* # ~
│ ├─ 6_HelloWorld_Server_Meta/* # ~
│ ├─ 7_KeyValueStore_Client/* # ~
│ ├─ 7_KeyValueStore_Server/* # ~
│ ├─ 8_Route_Guide_Client/* # ~
│ ├─ 8_Route_Guide_Server/* # ~
│ ├─ 9_Route_Guide_Client_Callback/* # ~
│ ├─ 9_Route_Guide_Server_Callback/* # ~
│ ├─ gRPC_PropertySheet/* # Contains the property sheet for easy including the required compile and linking dependencies
│ ├─ protos/* # Contains the required protofiles of the examples
│ ├─ res/* # Contains required files for specific examples.
│ └─ Examples_vs2019.sln # The solution file including and organizing all the example projects
Using Visual Studio IDE ¶
Please make sure that you have the correct/any build tools installed.
Open the Examples_<vs_compiler_name>.sln with the required IDE version.
If everything was correctly placed (unpacked), no error popup will appear 
.
For further help checkout the FAQ or create an issue.
And it will look this snapshot using VS 2019 IDE.
Click Examples_<vs_compiler_name> and choose Build Solution or simply use the shortcut Ctrl+Shift+B to build all examples.
Success
Output Directory
The output layout follows this scheme
.
└─ _out_/
└─ <architecture>/ # x64 or x86
└─ <build configuration>/ # Debug, Release or RelWithDebInfo
└─ <All the examples>/* # binares and ressources