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 (assumes you ran hooks with GYP\_GENERATORS=ninja) without
  27 building all of Chromium.
  28
  29 ```shell
  30 ninja -C out\Release libEGL.dll
  31 ```
  32
  33 Change files then commit locally.
  34
  35 Upload to gerrit for review. You will need to have installed the git hook as
  36 described in the "Getting started with Gerrit for ANGLE" section of the
  37 ContributingCode doc before committing them locally.
  38
  39 ```shell
  40 git cl upload
  41 ```
  42
  43 As with subversion and rietveld: visit the upload link for the review site,
  44 check the diff and the commit message then add reviewer(s) and publish.
  45
  46 Land your changes to the upstream repository from the gerrit web interface.
  47
  48 If there are upstream changes, you may need to rebase your patches and reupload
  49 them.
  50
  51 ```shell
  52 git pull
  53 git cl upload
  54 ```
  55
  56 # Rolling ANGLE into Chrome
  57
  58 To roll DEPS, make sure this is not commented out and update the hash associated
  59 with "angle\_revision". (Your hash will be different than the one below.)
  60
  61 ```
  62   "angle_revision": "0ee126c670edae8dd1822980047450a9a530c032",
  63 ```
  64
  65 Then sync.
  66
  67 ```shell
  68 gclient sync
  69 ```
  70
  71 Your changes should now be in third\_party/angle.