| ## Developer environment |
| |
| New method `meson.add_devenv()` adds an [`environment()`](#environment) object |
| to the list of environments that will be applied when using `meson devenv` |
| command line. This is useful for developpers who wish to use the project without |
| installing it, it is often needed to set for example the path to plugins |
| directory, etc. Alternatively, a list or dictionary can be passed as first |
| argument. |
| |
| ``` meson |
| devenv = environment() |
| devenv.set('PLUGINS_PATH', meson.current_build_dir()) |
| ... |
| meson.add_devenv(devenv) |
| ``` |
| |
| New command line has been added: `meson devenv -C builddir [<command>]`. |
| It runs a command, or open interactive shell if no command is provided, with |
| environment setup to run project from the build directory, without installation. |
| |
| These variables are set in environment in addition to those set using `meson.add_devenv()`: |
| - `MESON_DEVENV` is defined to `'1'`. |
| - `MESON_PROJECT_NAME` is defined to the main project's name. |
| - `PKG_CONFIG_PATH` includes the directory where Meson generates `-uninstalled.pc` |
| files. |
| - `PATH` includes every directory where there is an executable that would be |
| installed into `bindir`. On windows it also includes every directory where there |
| is a DLL needed to run those executables. |
| - `LD_LIBRARY_PATH` includes every directory where there is a shared library that |
| would be installed into `libdir`. This allows to run system application using |
| custom build of some libraries. For example running system GEdit when building |
| GTK from git. On OSX the environment variable is `DYLD_LIBRARY_PATH` and |
| `PATH` on Windows. |
| - `GI_TYPELIB_PATH` includes every directory where a GObject Introspection |
| typelib is built. This is automatically set when using `gnome.generate_gir()`. |
