Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
thommyho authored Dec 28, 2024
1 parent 6f5c482 commit 9628f2e
Showing 1 changed file with 78 additions and 35 deletions.
113 changes: 78 additions & 35 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,103 @@
# Prebuilt binaries gRPC C++ for Windows

##### Current stable build of gRPC v1.68.2
##### Current stable build of gRPC v1.69.0

##### gRPC [v1.68.2](https://github.com/grpc/grpc/releases/tag/v1.68.2)
##### gRPC [v1.69.0](https://github.com/grpc/grpc/releases/tag/v1.69.0)

> They can be downloaded separately as zip archives from the [releases](https://github.com/thommyho/gRPC_windows/releases) page
> **Note**: Prebuilt binaries can be downloaded as zip archives from the [Releases](https://github.com/thommyho/gRPC_windows/releases) page.
### Additional Visual Studio Examples

Most C++ examples from the [gRPC repository](https://github.com/grpc/grpc/tree/master/examples/cpp) have been ported to a
Visual Studio-compatible structure. These examples are maintained at [Cpp-gRPC-Visual-Studio-Examples](https://github.com/thommyho/Cpp-gRPC-Visual-Studio-Examples)
and are tested with gRPC versions v1.42.0 and above.

### Documentation

➡️ [Step-by-Step Installation Guide](https://thommyho.github.io/Cpp-gRPC-Windows-PreBuilts) ⬅️

______________________________________________________________________

##### Releases

| Version | Commit | Commit-Date | Debug | Release | RelWithDebInfo | MSVC143 32Bit | MSVC143 64Bit | MSVC142 32 Bit | MSVC142 64 Bit | Example |
| ------------------------------------------------------------------------ | ---------------------------------------- | ------------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- |
| [v1.68.2](https://github.com/thommyho/gRPC_windows/releases/tag/v1.68.2) | 859bc5216ba3955fb8925326bdec391fd93c8730 | 2024-12-04 02:03:35+08:00 | :ballot_box_with_check: | :ballot_box_with_check: | :ballot_box_with_check: | :ballot_box_with_check: | :ballot_box_with_check: | :ballot_box_with_check: | :ballot_box_with_check: | :ballot_box_with_check: |
| Version | Commit | Commit-Date | Build Configurations | Compiler Set | Example |
| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- | -------------------------- | ------------------------------------------- | -------------------------------------------------------------------- | ------- |
| [v1.69.0](https://github.com/thommyho/gRPC_windows/releases/tag/v1.69.0) | [b4ef7c1](https://github.com/grpc/grpc/commit/b4ef7c141d960be62e0008601261bb22cecb5d40) | Tuesday, December 24, 2024 | 🛠️ Debug<br>🚀 Release<br>🔧 RelWithDebInfo | 💻 MSVC143: x86, x64<br>🖥️ MSVC142: x86, x64<br>🔲 MSVC141: x86, x64 ||

______________________________________________________________________

### Explanation of Symbols

- **Build Configurations**:
- 🛠️ Debug: Development configuration with debugging symbols.
- 🚀 Release: Optimized for production use.
- 🔧 RelWithDebInfo: Combination of optimizations and debugging symbols.
- **Compiler Sets**:
- 💻 MSVC143: Visual Studio 2022 (x86/x64).
- 🖥️ MSVC142: Visual Studio 2019 (x86/x64).
- 🔲 MSVC141: Visual Studio 2017 (x86/x64) --> Discontinued from v1.45.2.

______________________________________________________________________

Build instructions from here: <https://github.com/grpc/grpc/blob/master/BUILDING.md>

Examples included. Tested with msvc142, msvc143 (Win 10, SDK 10.0)

______________________________________________________________________

#### Information about Build system and Tools

| Operating System | SDK Version |
| ---------------- | ------------------------------------------------- |
| Windows | 10.0.22631 |
| Operating System | SDK Version |
| ---------------- | --------------------------------------------------- |
| Windows | 10.0.19042 |
| Processor | Intel64 Family 6 Model 142 Stepping 9, GenuineIntel |
| Architecture | AMD64 |

#### Build Tools

| Build Tool | Version |
| ---------- | ------- |
| git | 2.47.0 |
| cmake | 3.30.5 |
| nasm | 2.16.03 |
| golang | 1.23.2 |
| git | 2.30.2 |
| cmake | 3.23.1 |
| nasm | 2.15.05 |
| golang | 1.23.1 |

#### Visual Studio Versions and Compiler Sets

| Visual Studio Version | Compiler Set Versions |
| --------------------- | ------------------------ |
| 2022 | 14.29.30133, 14.41.34120 |
| 2019 | 14.29.30133 |
| Visual Studio Version | Compiler Set Versions |
| --------------------- | --------------------- |
| 2022 | 14.42.34433 |
| 2019 | 14.29.30133 |
| 2017 | 14.16.27023 |

#### gRPC c++ Third Party Components

| Third Party Component | Version | Commit | Link | Timestamp |
| --------------------- | ------------ | ---------------------------------------- | ---------------------------------------------------------------- | ------------------------- |
| abseil-cpp | 20240722.0 | 4447c7562e3bc702ade25105912dce503f0c4010 | <https://github.com/abseil/abseil-cpp.git> | 2024-08-01 22:05:11+04:00 |
| benchmark | v1.8.3 | 344117638c8ff7e239044fd0fa7085839fc03021 | <https://github.com/google/benchmark> | 2023-08-31 11:16:50-01:00 |
| bloaty | No tag | 60209eb1ccc34d5deefb002d1b7f37545204f7f2 | <https://github.com/google/bloaty.git> | 2021-08-16 00:36:22+07:00 |
| boringssl-with-bazel | No tag | b8b3e6e11166719a8ebfa43c0cde9ad7d57a84f6 | <https://github.com/google/boringssl.git> | 2024-09-03 23:53:10+00:00 |
| cares/cares | cares-1_19_1 | 6360e96b5cf8e5980c887ce58ef727e53d77243a | <https://github.com/c-ares/c-ares.git> | 2023-05-22 16:01:44+04:00 |
| envoy-api | No tag | f8b75d1efa92bbf534596a013d9ca5873f79dd30 | <https://github.com/envoyproxy/data-plane-api.git> | 2024-07-19 16:50:15+00:00 |
| googleapis | No tag | fe8ba054ad4f7eca946c2d14a63c3f07c0b586a0 | <https://github.com/googleapis/googleapis.git> | 2024-08-19 21:44:05+07:00 |
| googletest | v1.15.0 | 2dd1c131950043a8ad5ab0d2dda0e0970596586a | <https://github.com/google/googletest.git> | 2023-10-06 04:13:04+07:00 |
| opencensus-proto | v0.3.0 | 4aa53e15cbf1a47bc9087e6cfdca214c1eea4e89 | <https://github.com/census-instrumentation/opencensus-proto.git> | 2020-07-20 19:46:08-10:00 |
| opentelemetry | v0.10.0 | 60fa8754d890b5c55949a8c68dcfd7ab5c2395df | <https://github.com/open-telemetry/opentelemetry-proto.git> | 2021-07-30 00:27:50-04:00 |
| protobuf | v3.28.1 | 10ef3f77683f77fb3c059bf47725c27b3ff41e63 | <https://github.com/protocolbuffers/protobuf.git> | 2024-09-11 03:36:10+07:00 |
| protoc-gen-validate | v1.0.4 | 32c2415389a3538082507ae537e7edd9578c64ed | <https://github.com/envoyproxy/protoc-gen-validate.git> | 2024-01-17 06:01:04+08:00 |
| re2 | 2022-04-01 | 0c5616df9c0aaa44c9440d87422012423d91c7d1 | <https://github.com/google/re2.git> | 2022-03-30 18:41:25+00:00 |
| xds | No tag | 3a472e524827f72d1ad621c4983dd5af54c46776 | <https://github.com/cncf/xds.git> | 2023-11-16 19:28:03+05:00 |
| zlib | v1.3 | 09155eaa2f9270dc4ed1fa13e2b4b2613e6e4851 | <https://github.com/madler/zlib> | 2023-08-18 15:45:36+07:00 |
| opentelemetry-cpp | v1.13.0 | 4bd64c9a336fd438d6c4c9dad2e6b61b0585311f | <https://github.com/open-telemetry/opentelemetry-cpp> | 2023-12-06 18:39:21-01:00 |
| Third Party Component | Version | Commit | Link | Timestamp |
| --------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------- |
| abseil-cpp | 20240722.0 | [4447c75](https://github.com/abseil/abseil-cpp.git/commit/4447c7562e3bc702ade25105912dce503f0c4010) | [abseil-cpp](https://github.com/abseil/abseil-cpp.git) | Thursday, August 01, 2024 |
| benchmark | v1.9.0 | [12235e2](https://github.com/google/benchmark/commit/12235e24652fc7f809373e7c11a5f73c5763fc4c) | [benchmark](https://github.com/google/benchmark) | Friday, August 16, 2024 |
| bloaty | No tag | [60209eb](https://github.com/google/bloaty.git/commit/60209eb1ccc34d5deefb002d1b7f37545204f7f2) | [bloaty](https://github.com/google/bloaty.git) | Monday, August 16, 2021 |
| boringssl-with-bazel | No tag | [b8b3e6e](https://github.com/google/boringssl.git/commit/b8b3e6e11166719a8ebfa43c0cde9ad7d57a84f6) | [boringssl-with-bazel](https://github.com/google/boringssl.git) | Tuesday, September 03, 2024 |
| cares/cares | cares-1_19_1 | [6360e96](https://github.com/c-ares/c-ares.git/commit/6360e96b5cf8e5980c887ce58ef727e53d77243a) | [cares/cares](https://github.com/c-ares/c-ares.git) | Monday, May 22, 2023 |
| envoy-api | No tag | [f8b75d1](https://github.com/envoyproxy/data-plane-api.git/commit/f8b75d1efa92bbf534596a013d9ca5873f79dd30) | [envoy-api](https://github.com/envoyproxy/data-plane-api.git) | Friday, July 19, 2024 |
| googleapis | No tag | [fe8ba05](https://github.com/googleapis/googleapis.git/commit/fe8ba054ad4f7eca946c2d14a63c3f07c0b586a0) | [googleapis](https://github.com/googleapis/googleapis.git) | Monday, August 19, 2024 |
| googletest | v1.15.0 | [2dd1c13](https://github.com/google/googletest.git/commit/2dd1c131950043a8ad5ab0d2dda0e0970596586a) | [googletest](https://github.com/google/googletest.git) | Friday, October 06, 2023 |
| opencensus-proto | v0.3.0 | [4aa53e1](https://github.com/census-instrumentation/opencensus-proto.git/commit/4aa53e15cbf1a47bc9087e6cfdca214c1eea4e89) | [opencensus-proto](https://github.com/census-instrumentation/opencensus-proto.git) | Monday, July 20, 2020 |
| opentelemetry | v0.10.0 | [60fa875](https://github.com/open-telemetry/opentelemetry-proto.git/commit/60fa8754d890b5c55949a8c68dcfd7ab5c2395df) | [opentelemetry](https://github.com/open-telemetry/opentelemetry-proto.git) | Friday, July 30, 2021 |
| protobuf | v3.29.0 | [2d4414f](https://github.com/protocolbuffers/protobuf.git/commit/2d4414f384dc499af113b5991ce3eaa9df6dd931) | [protobuf](https://github.com/protocolbuffers/protobuf.git) | Thursday, November 28, 2024 |
| protoc-gen-validate | v1.0.4 | [32c2415](https://github.com/envoyproxy/protoc-gen-validate.git/commit/32c2415389a3538082507ae537e7edd9578c64ed) | [protoc-gen-validate](https://github.com/envoyproxy/protoc-gen-validate.git) | Wednesday, January 17, 2024 |
| re2 | 2022-04-01 | [0c5616d](https://github.com/google/re2.git/commit/0c5616df9c0aaa44c9440d87422012423d91c7d1) | [re2](https://github.com/google/re2.git) | Wednesday, March 30, 2022 |
| xds | No tag | [3a472e5](https://github.com/cncf/xds.git/commit/3a472e524827f72d1ad621c4983dd5af54c46776) | [xds](https://github.com/cncf/xds.git) | Thursday, November 16, 2023 |
| zlib | v1.3 | [09155ea](https://github.com/madler/zlib/commit/09155eaa2f9270dc4ed1fa13e2b4b2613e6e4851) | [zlib](https://github.com/madler/zlib) | Friday, August 18, 2023 |
| opentelemetry-cpp | v1.18.0 | [a388e87](https://github.com/open-telemetry/opentelemetry-cpp/commit/a388e87d72b8321c189c8d41edb746ffa687ce3c) | [opentelemetry-cpp](https://github.com/open-telemetry/opentelemetry-cpp) | Friday, November 15, 2024 |

### Feedback

For suggestions or issues, feel free to open a ticket in the respective repositories:

- Prebuilt binaries: [gRPC Windows](https://github.com/thommyho/gRPC_windows).
- Visual Studio Examples: [Cpp-gRPC-Visual-Studio-Examples](https://github.com/thommyho/Cpp-gRPC-Visual-Studio-Examples).

______________________________________________________________________

Thank you for using gRPC for C++ on Windows!

0 comments on commit 9628f2e

Please sign in to comment.