Nastaví název, verzi a povolovací jazyky pro celý projekt.
project(<PROJECT-NAME> )project(<PROJECT-NAME> ]]] )
Nastaví název projektu a uloží jej do proměnnéPROJECT_NAME. Kromě toho nastaví proměnné
-
PROJECT_SOURCE_DIR,<PROJECT-NAME>_SOURCE_DIR -
PROJECT_BINARY_DIR,<PROJECT-NAME>_BINARY_DIR
Pokud je zadáno VERSION, dané komponenty musí být nezáporná celá čísla.Není-li VERSION zadáno, je výchozí verzí prázdný řetězec. VERSION Volbu VERSION nelze použít, pokud není zásada CMP0048nastavena na NEW.
Příkaz project() ukládá číslo verze a jeho složkyv proměnných
-
PROJECT_VERSION,<PROJECT-NAME>_VERSION -
PROJECT_VERSION_MAJOR,<PROJECT-NAME>_VERSION_MAJOR -
PROJECT_VERSION_MINOR,<PROJECT-NAME>_VERSION_MINOR -
PROJECT_VERSION_PATCH,<PROJECT-NAME>_VERSION_PATCH -
PROJECT_VERSION_TWEAK,<PROJECT-NAME>_VERSION_TWEAK
Proměnné odpovídající nespecifikovaným verzím jsou nastaveny na prázdný řetězec(pokud je politika CMP0048 nastavena na NEW).
Volitelně můžete určit, které jazyky váš projekt podporuje. příklady jazyků jsou C, CXX (tj. C++), Fortran atd. ve výchozím nastavení jsou povoleny C a CXX, pokud nejsou zadány žádné jazykové volby. Zadejte jazyk NONE nebo použijte klíčové slovo LANGUAGESa nevypisujte žádné jazyky, abyste vynechali povolení jakýchkoli jazyků.
Pokud existuje proměnná s názvem CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE,soubor, na který tato proměnná ukazuje, bude zařazen jako poslední krok příkazuproject.
Soubor nejvyšší úrovně CMakeLists.txt pro projekt musí obsahovat přímé volání příkazu project(); načtení příkazu include() nestačí. Pokud takové volání neexistuje, CMake implicitně přidá na začátek takové volání, které povolí výchozí jazyky (C a CXX).
Poznámka
Volání příkazu cmake_minimum_required() na začátku souboru nejvyšší úrovně CMakeLists.txt ještě před voláním příkazuproject(). Je důležité stanovit nastavení verze a politiky před vyvoláním dalších příkazů, jejichž chování mohou ovlivnit. Viz také zásady CMP0000.
.