xref: /aosp_15_r20/external/cronet/third_party/abseil-cpp/README.chromium (revision 6777b5387eb2ff775bb5750e3f5d96f37fb7352b)
1*6777b538SAndroid Build Coastguard WorkerName: Abseil
2*6777b538SAndroid Build Coastguard WorkerShort Name: absl
3*6777b538SAndroid Build Coastguard WorkerURL: https://github.com/abseil/abseil-cpp
4*6777b538SAndroid Build Coastguard WorkerLicense: Apache 2.0
5*6777b538SAndroid Build Coastguard WorkerLicense File: LICENSE
6*6777b538SAndroid Build Coastguard WorkerVersion: N/A
7*6777b538SAndroid Build Coastguard WorkerRevision: 8f9e5f0203c8a708c71f4498bf59355d1d7bbf87
8*6777b538SAndroid Build Coastguard WorkerSecurity Critical: yes
9*6777b538SAndroid Build Coastguard WorkerShipped: yes
10*6777b538SAndroid Build Coastguard Worker
11*6777b538SAndroid Build Coastguard WorkerDescription:
12*6777b538SAndroid Build Coastguard WorkerThis directory contains the source code of Abseil for C++. This can be used by
13*6777b538SAndroid Build Coastguard WorkerChromium, subject to the guidance at
14*6777b538SAndroid Build Coastguard Workerhttps://chromium.googlesource.com/chromium/src/+/main/styleguide/c++/c++-features.md;
15*6777b538SAndroid Build Coastguard Workerit can be used without restriction by Chromium's dependencies, except that
16*6777b538SAndroid Build Coastguard Workerobjects compiled into Chromium itself cannot use anything relying on
17*6777b538SAndroid Build Coastguard Workerabsl::base_internal::FastTypeId (see https://crbug.com/1096380).
18*6777b538SAndroid Build Coastguard Worker
19*6777b538SAndroid Build Coastguard WorkerHow to update Abseil:
20*6777b538SAndroid Build Coastguard Worker
21*6777b538SAndroid Build Coastguard Worker1. From your source root run third_party/abseil-cpp/roll_abseil.py to download the code from the Abseil git repository and apply chromium specific patches.
22*6777b538SAndroid Build Coastguard Worker
23*6777b538SAndroid Build Coastguard Worker2. Update BUILD.gn files to match changes in BUILD.bazel
24*6777b538SAndroid Build Coastguard Worker
25*6777b538SAndroid Build Coastguard WorkerIf there is a new test, add dependcy on it from absl_tests in the
26*6777b538SAndroid Build Coastguard Workerthird_party/abseil-cpp/BUILD.gn target
27*6777b538SAndroid Build Coastguard Worker
28*6777b538SAndroid Build Coastguard Worker3. From your source root run third_party/abseil-cpp/generate_def_files.py to
29*6777b538SAndroid Build Coastguard Worker   regenerate Windows symbol definition files.
30*6777b538SAndroid Build Coastguard Worker
31*6777b538SAndroid Build Coastguard Worker4. If abseil adds new features, update styleguide/c++/c++-features.md and add headers for that feature into exclude list in root DEPS
32*6777b538SAndroid Build Coastguard Worker
33*6777b538SAndroid Build Coastguard WorkerLocal Modifications:
34*6777b538SAndroid Build Coastguard Worker
35*6777b538SAndroid Build Coastguard Worker* absl/copts.bzl has been translated to //third_party/absl-cpp/BUILD.gn. Both
36*6777b538SAndroid Build Coastguard Worker  files contain lists of compiler flags in order to reduce duplication.
37*6777b538SAndroid Build Coastguard Worker
38*6777b538SAndroid Build Coastguard Worker* All the BUILD.bazel files have been translated to BUILD.gn files.
39*6777b538SAndroid Build Coastguard Worker
40*6777b538SAndroid Build Coastguard Worker* Patches from //third_party/abseil-cpp/patches have been applied.
41*6777b538SAndroid Build Coastguard Worker
42*6777b538SAndroid Build Coastguard Worker* Increment this number to silence presubmits about modifying files in
43*6777b538SAndroid Build Coastguard Worker  third_party when regenerating absl .def files: 2
44