README.chromium 1.5 KB

12345678910111213141516171819202122232425262728293031323334
  1. Name: grpc
  2. URL: https://github.com/grpc/grpc
  3. License: Apache 2.0
  4. Version: v1.49.0-dev
  5. Revision: dd77c67217b10ffeaf766e25eb8b46d2d59de4ff
  6. Security Critical: yes
  7. Please note that that the use of gRPC is not generally allowed within Chromium.
  8. Before integrating with this library, consult with the security team.
  9. See go/chrome-grpc-advice for more details.
  10. Steps to upgrade to a new version of GRPC, all relative to //third_party/grpc:
  11. 1. Update ../../DEPS to pull origin/grpc/master.
  12. NOTE: Tagged "official releases" do not work on the buildbots. The master
  13. branch must be used.
  14. 2. Update revision and version information in this file. Version can be found
  15. in the root BUILD file in gRPC repo.
  16. 3. Checkout GRPC submodules by running from the src/ directory:
  17. git submodule update --init
  18. 4. Copy template/BUILD.chromium.gn.template to src/templates.
  19. 5. Rebuild BUILD.gn by running from the src/ directory:
  20. tools/buildgen/generate_projects.sh
  21. (make sure mako_templates python module is installed in your system using
  22. command "apt-get install python3-mako")
  23. This will use the template in templates/BUILD.chromium.gn.template to
  24. generate src/BUILD.chromium.gn file.
  25. 6. Run: mv third_party/grpc/src/BUILD.chromium.gn third_party/grpc/BUILD.gn
  26. 7. Run: gn format --in-place BUILD.gn
  27. We have a helper script `generate_gn.sh` does step (4), (5), (6), and (7).
  28. Note: Please also remember to check if `plugin_registry/grpc_plugin_registry.cc`
  29. needs update! Upstream sometimes introduces new plugins and we may need to update
  30. our custom `grpc_plugin_registry.cc`.