The Open Screen library includes its dependencies as DEPS in the source tree under the //third_party/
directory. They are structured as follows:
//third_party/<library> BUILD.gn ...other necessary adapter files... src/ <library>'s source
When adding a new dependency to the project, you should first add an entry to the DEPS file. For example, let's say we want to add a new library called alpha
. Opening up DEPS, you would add
deps = { ... 'src/third_party/alpha/src': 'https://repo.com/path/to/alpha.git' + '@' + '<revision>'
Then you need to add a BUILD.gn file for it under //third_party/alpha
, assuming it doesn't already provide its own BUILD.gn.
Finally, add a new entry for the “src” directory of your dependency to the //third_party/.gitignore.
Rolling a dependency forward (or to any different version really) consists of two steps:
git add
the DEPS file and commit, then run gclient sync.Of course, you should also make sure that the new change is still compatible with the rest of the project, including any adapter files under //third_party/<library>
(e.g. BUILD.gn). Any necessary updates to make the rest of the project work with the new dependency version should happen in the same change.
If after running gclient sync
, your build starts failing due to errors in //third_party/
, then do the following:
//out/
directory.src/
directory of the failing //third_party
library.gclient sync
.This will remove any directories and files which were removed in the updated library but not deleted by gclient sync
.