| --- |
| short-description: Project templates |
| ... |
| |
| # Project templates |
| |
| To make it easier for new developers to start working, Meson ships a |
| tool to generate the basic setup of different kinds of projects. This |
| functionality can be accessed with the `meson init` command. A typical |
| project setup would go like this: |
| |
| ```console |
| $ mkdir project_name |
| $ cd project_name |
| $ meson init --language=c --name=myproject --version=0.1 |
| ``` |
| |
| This would create the build definitions for a helloworld type |
| project. The result can be compiled as usual. For example it |
| could be done like this: |
| |
| ``` |
| $ meson setup builddir |
| $ meson compile -C builddir |
| ``` |
| |
| The generator has many different projects and settings. They can all |
| be listed by invoking the command `meson init --help`. |
| |
| This feature is available since Meson version 0.45.0. |
| |
| # Generate a build script for an existing project |
| |
| With `meson init` you can generate a build script for an existing |
| project with existing project files by running the command in the |
| root directory of your project. Meson currently supports this |
| feature for `executable`, and `jar` projects. |
| |
| # Build after generation of template |
| |
| It is possible to have Meson generate a build directory from the |
| `meson init` command without running `meson setup`. This is done |
| by passing `-b` or `--build` switch. |
| |
| ```console |
| $ mkdir project_name |
| $ cd project_name |
| $ meson init --language=c --name=myproject --version=0.1 --build |
| ``` |
