kc3-lang/angle/doc/BuildingAngleForChromiumDevelopment.md

Branch : - branch - main - tag -

• Show log

  Commit

• Author : Frank Henigman
  Date : 2017-11-16 23:45:34
  Hash : 3c613c0d
  Message : Update docs for GN standalone and GYP deprecation. Explain how to use GN and say not to use GYP. BUG=angleproject:1569 Change-Id: I972126dced28fa7a70eb301b500f172376a569c1 Reviewed-on: https://chromium-review.googlesource.com/775858 Reviewed-by: Jamie Madill <jmadill@chromium.org> Reviewed-by: Geoff Lang <geofflang@chromium.org>

• doc/BuildingAngleForChromiumDevelopment.md

• # How to build ANGLE in Chromium for dev
  
  ## Introduction
  
  On Windows, Linux, and Mac ANGLE now builds most core components cross platform, including the shader validator and translator as well as the graphics API translator. These parts can be built and tested inside a Chromium checkout.
  
  Steps:
  
    * Checkout and build [Chromium](http://dev.chromium.org/Home).
    * You should now be able to use `ninja -C out/Debug angle_end2end_tests`, for example.
  
  ## Building Standalone ANGLE inside Chromium
  
  On Mac, ANGLE doesn't yet include the dEQP tests or the API translation libraries as part of Chromium. ANGLE also includes some sample applications and a few other targets that don't build on Chromium. These steps describe how to build such targets within a Chromium checkout.
  
  Steps:
  
    * Checkout and build [Chromium](http://dev.chromium.org/Home).
    * To setup run these commands (note similarity to [DevSetup](DevSetup.md)):
  
  ```bash
  cd src/third_party/angle
  gclient config --name . --unmanaged https://chromium.googlesource.com/angle/angle.git
  
  gclient sync
  git checkout master
  ```
  
    * To make the build files run these commands
  
  ```bash
  cd src/third_party/angle
  gn gen out/Debug
  ```
  
    * To build
  
  ```bash
  cd src/third_party/angle
  ninja -j 10 -k1 -C out/Debug
  ```
  
    * To build a specific target add the target at the end:
  
  ```bash
  cd src/third_party/angle
  ninja -j 10 -k1 -C out/Debug angle_gles2_deqp_tests
  ```
  
    * To run
  
  ```bash
  cd src/third_party/angle
  ./out/Debug/hello_triangle
  ```
  
  If you decide to go back to the Chromium-managed version, just remove the `.gclient` file.
  
  ## Working with Top of Tree ANGLE in Chromium
  
  If you're actively developing within ANGLE in your Chromium workspace you will want to work with top of tree ANGLE. To do this do the following:
  
    * Ignore ANGLE in your `.gclient`
  
  ```python
  solutions = [
    {
      # ...
      u'custom_deps':
      {
        "src/third_party/angle": None,
      },
    },
  ]
  ```
  
  You then have full control over your ANGLE workspace and are responsible for running all git commands (pull, rebase, etc.) for managing your branches.
  
  If you decide you need to go back to the DEPS version of ANGLE:
  
    * Comment out the `src/third_party/angle` line in your `custom_deps`.
    * Go into your ANGLE workspace and switch back to the master branch (ensure there are no modified or new files).
    * `gclient sync` your Chromium workspace.