update angle install notes
This commit is contained in:
parent
b27dc615d1
commit
f69a6b31ae
|
|
@ -0,0 +1,77 @@
|
|||
## Angle install on macOS
|
||||
|
||||
* Get ninja if needed: `brew install ninja`
|
||||
* Get the `depot_tools`repo: `git clone https://chromium.googlesource.com/* chromium/tools/depot_tools.git`
|
||||
* Set path: `export PATH=/path/to/depot_tools:$PATH`
|
||||
|
||||
* Maybe necessary to fiddle with certificates here, otherwise `fetch angle` fails in the subsequent steps.
|
||||
|
||||
```
|
||||
cd /Applications/Python\ 3.6
|
||||
sudo ./Install\ Certificates.command
|
||||
```
|
||||
* Fetch angle:
|
||||
|
||||
```
|
||||
mkdir angle
|
||||
cd angle
|
||||
fetch angle
|
||||
```
|
||||
* Generate build config: `gn gen out/Debug`
|
||||
|
||||
* To see available arguments: `gn args out/Debug --list`
|
||||
* To change arguments: `gn args out/Debug`
|
||||
|
||||
For example, to generate dwarf dsyms files, set:
|
||||
|
||||
```
|
||||
enable_dsyms=true
|
||||
use_debug_fission=true
|
||||
symbol_level=2
|
||||
```
|
||||
|
||||
We also need to set `is_component_build=false` in order to have self-contained librarries.
|
||||
|
||||
Then, build with `autoninja -C out/Debug`and wait until you pass out.
|
||||
|
||||
## Angle install on windows
|
||||
|
||||
* need Python3 (can install through win app store)
|
||||
* need Windows SDK
|
||||
* clone `depot_tools`: `git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git`
|
||||
or download and unzip bundle at [https://storage.googleapis.com/chrome-infra/depot_tools.zip](https://storage.googleapis.com/chrome-infra/depot_tools.zip)
|
||||
* set `depot_tools` in path env variable through control panel>System and security>system>advanced system settings
|
||||
* run `gclient` in a cmd shell
|
||||
* set `DEPOT_TOOLS_WIN_TOOLCHAIN=0`
|
||||
* `mkdir angle`
|
||||
* `cd angle`
|
||||
* `fetch angle`
|
||||
* wait a million years
|
||||
|
||||
* if it fails when running `python3 third_party/depot_tools/download_from_google_storage.py ...`
|
||||
-> open `DEPS` and change `third_party/depot_tools` to `../depot/tools`
|
||||
* run `gclient sync` to complete previous step
|
||||
|
||||
* `gn gen out/Debug`
|
||||
* `gn args out/Debug` and edit arguments:
|
||||
* `angle_enable_vulkan = false`
|
||||
* `angle_build_tests = false`
|
||||
* `is_component_build = false`
|
||||
|
||||
* link with `libEGL.dll.lib` and `libGLESv2.dll.lib`
|
||||
* put `libEGL.dll` and `libGLESv2.dll` in same directory as executable
|
||||
|
||||
## To get debugging kinda working with renderdoc:
|
||||
|
||||
Run `gn args out/Debug` and set
|
||||
* `angle_enable_trace = true`
|
||||
* `angle_enable_annotator_run_time_checks = true`
|
||||
|
||||
* `autoninja -C out/Debug`
|
||||
* wait a while
|
||||
|
||||
In renderdoc, set env variables
|
||||
`RENDERDOC_HOOK_EGL 0` (if you want to trace underlying native API)
|
||||
`RENDERDOC_HOOK_EGL 1` (if you want to trace EGL calls. You also need to put `libEGL` in the renderdoc folder so it's found when capturing stuff. Unfortunately though, that seems to provoke crashes...)
|
||||
|
||||
`ANGLE_ENABLE_DEBUG_MARKERS 1` (to turn on debug markers)
|
||||
|
|
@ -1,44 +0,0 @@
|
|||
angle install on windows
|
||||
|
||||
* need Python3 (can install through win app store)
|
||||
* need Windows SDK
|
||||
* clone depot_tools git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
|
||||
or download and unzip bundle at https://storage.googleapis.com/chrome-infra/depot_tools.zip
|
||||
* set depot_tools in path env variable through control panel>System and security>system>advanced system settings
|
||||
* run gclient in a cmd shell
|
||||
|
||||
* set DEPOT_TOOLS_WIN_TOOLCHAIN=0
|
||||
* mkdir angle
|
||||
* cd angle
|
||||
* fetch angle
|
||||
* wait a million years
|
||||
|
||||
* fails when running python3 third_party/depot_tools/download_from_google_storage.py ...
|
||||
-> open DEPS and change third_party/depot_tools with ../depot/tools
|
||||
|
||||
* run gclient sync to complete previous step
|
||||
|
||||
* gn gen out/Debug
|
||||
* gn args out/Debug and edit arguments:
|
||||
angle_enable_vulkan = false
|
||||
angle_build_tests = false
|
||||
is_component_build = false
|
||||
|
||||
#to get debugging kinda working with renderdoc:
|
||||
angle_enable_trace = true
|
||||
angle_enable_annotator_run_time_checks = true
|
||||
|
||||
|
||||
* autoninja -C out/Debug
|
||||
* wait a while
|
||||
|
||||
* link with libEGL.dll.lib and libGLESv2.dll.lib
|
||||
* put libEGL.dll and libGLESv2.dll in same directory as executable
|
||||
|
||||
Debugging
|
||||
---------
|
||||
in renderdoc, set env variables
|
||||
RENDERDOC_HOOK_EGL 0 (if you want to trace underlying native API)
|
||||
RENDERDOC_HOOK_EGL 1 (if you want to trace EGL calls. You also need to put libEGL in the renderdoc folder so it's found when capturing stuff. Unfortunately though, that seems to provoke crashes...)
|
||||
|
||||
ANGLE_ENABLE_DEBUG_MARKERS 1 (to turn on debug markers)
|
||||
Loading…
Reference in New Issue