README.txt 1.1 KB

12345678910111213141516171819202122232425262728293031
  1. This directory is here to hold .gni files that contain sets of GN build
  2. arguments for given configurations.
  3. (Currently this directory is empty because we removed the only thing here, but
  4. this has come up several times so I'm confident we'll need this again. If this
  5. directory is still empty by 2017, feel free to delete it. --Brett)
  6. Some projects or bots may have build configurations with specific combinations
  7. of flags. Rather than making a new global flag for your specific project and
  8. adding it all over the build to each arg it should affect, you can add a .gni
  9. file here with the variables.
  10. For example, for project foo you may put in build/args/foo.gni:
  11. target_os = "android"
  12. use_pulseaudio = false
  13. use_ozone = true
  14. system_libdir = "foo"
  15. Users wanting to build this configuration would run:
  16. $ gn args out/mybuild
  17. And add the following line to their args for that build directory:
  18. import("//build/args/foo.gni")
  19. # You can set any other args here like normal.
  20. is_component_build = false
  21. This way everybody can agree on a set of flags for a project, and their builds
  22. stay in sync as the flags in foo.gni are modified.