docs/angle_in_chromium.md

   1 # Hacking on ANGLE in Chromium
   2
   3 In DEPS, comment out the part that looks like this.
   4
   5 ```
   6 #  "src/third_party/angle":
   7 #    Var("chromium_git") + "/angle/angle.git@" + Var("angle_revision"),
   8 ```
   9
  10 Delete or rename third\_party/angle.
  11
  12 (Optional) sync and make sure the third\_party/angle directory doesn't come
  13 back. It shouldn’t because it is no longer referenced from DEPS.
  14
  15 ```shell
  16 gclient sync -r CURRENT_REVISION
  17 ```
  18
  19 Clone the ANGLE git repository.
  20
  21 ```
  22 > git clone https://chromium.googlesource.com/angle/angle third_party/angle
  23 > gclient runhooks
  24 ```
  25
  26 To check ANGLE builds without building all of Chromium.
  27
  28 ```shell
  29 ninja -C out\Release libEGL.dll
  30 ```
  31
  32 Change files then commit locally.
  33
  34 Upload to Gerrit for review. You will need to have installed the git hook as
  35 described in the "Getting started with Gerrit for ANGLE" section of the
  36 ContributingCode doc before committing them locally.
  37
  38 ```shell
  39 git cl upload
  40 ```
  41
  42 As with subversion and Rietveld: visit the upload link for the review site,
  43 check the diff and the commit message then add reviewer(s) and publish.
  44
  45 Land your changes to the upstream repository from the Gerrit web interface.
  46
  47 If there are upstream changes, you may need to rebase your patches and reupload
  48 them.
  49
  50 ```shell
  51 git pull
  52 git cl upload
  53 ```
  54
  55 # Rolling ANGLE into Chrome
  56
  57 To roll DEPS, make sure this is not commented out and update the hash associated
  58 with "angle\_revision". (Your hash will be different than the one below.)
  59
  60 ```
  61   "angle_revision": "0ee126c670edae8dd1822980047450a9a530c032",
  62 ```
  63
  64 Then sync.
  65
  66 ```shell
  67 gclient sync
  68 ```
  69
  70 Your changes should now be in third\_party/angle.