Skip to content

Commit 5727177

Browse files
authored
doc: CHANGELOG entry for #8022 (#12507)
* doc: CHANGELOG entry for #8022 * checkers * address review comments * for example for example * oops
1 parent bd1be00 commit 5727177

File tree

1 file changed

+41
-0
lines changed

1 file changed

+41
-0
lines changed

CHANGELOG.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -140,6 +140,45 @@ The library has been expanded to include the v2 service.
140140
consider this a breaking change, as Bazel 5.x has been in maintenance mode for
141141
more than 6 months.
142142

143+
**CMake Proto Libraries**: We only compile service-specific protos if the
144+
corresponding client library is enabled, via `-DGOOGLE_CLOUD_CPP_ENABLE=...`.
145+
146+
This change reduces build times for customers who use CMake but who are not
147+
using **all** of the client libraries listed below.
148+
149+
We considered it [a bug][#8022] that customers building with CMake were forced
150+
to compile large proto libraries that they did not need. It was certainly
151+
[confusing][#10174].
152+
153+
Any change in behavior, including fixing bugs, can be considered "breaking". By
154+
policy we don't consider bug fixes to be breaking changes. We applied that
155+
policy in this case.
156+
157+
The impacted libraries are:
158+
159+
- `bigquery`
160+
- `bigtable`
161+
- `dialogflow_es`
162+
- `iam`
163+
- `logging`
164+
- `pubsub`
165+
- `speech`
166+
- `storage`
167+
- `texttospeech`
168+
- `trace`
169+
170+
If you are dependent on any of these proto libraries **and** you are not
171+
compiling the corresponding client library, you will need to update your build
172+
scripts.
173+
174+
For example, if you depend on `google_cloud_cpp_speech_protos` (e.g., if you
175+
have been using this library to make calls to Cloud Speech using raw gRPC), add
176+
`-DGOOGLE_CLOUD_CPP_ENABLE=...,speech,...` to your CMake configure command. If
177+
you build with `vcpkg`, include `speech` in your install command.
178+
179+
Note that `google_cloud_cpp_storage_protos` are associated with the
180+
`experimental-storage-grpc` feature, not the `storage` feature.
181+
143182
## v2.14.0 - 2023-08
144183

145184
### New Libraries
@@ -4247,13 +4286,15 @@ releases. The relevant notes are:
42474286
- Synchronous API for table admin operations is complete.
42484287

42494288
[#10170]: https://github.com/googleapis/google-cloud-cpp/issues/10170
4289+
[#10174]: https://github.com/googleapis/google-cloud-cpp/discussions/10174
42504290
[#5726]: https://github.com/googleapis/google-cloud-cpp/issues/5726
42514291
[#5923]: https://github.com/googleapis/google-cloud-cpp/issues/5923
42524292
[#5929]: https://github.com/googleapis/google-cloud-cpp/issues/5929
42534293
[#5976]: https://github.com/googleapis/google-cloud-cpp/issues/5976
42544294
[#7356]: https://github.com/googleapis/google-cloud-cpp/issues/7356
42554295
[#7463]: https://github.com/googleapis/google-cloud-cpp/issues/7463
42564296
[#7835]: https://github.com/googleapis/google-cloud-cpp/issues/7835
4297+
[#8022]: https://github.com/googleapis/google-cloud-cpp/issues/8022
42574298
[#8095]: https://github.com/googleapis/google-cloud-cpp/pull/8095
42584299
[#8099]: https://github.com/googleapis/google-cloud-cpp/pull/8099
42594300
[#8234]: https://github.com/googleapis/google-cloud-cpp/issues/8234

0 commit comments

Comments
 (0)