174 lines
4.9 KiB
ReStructuredText
174 lines
4.9 KiB
ReStructuredText
==========
|
||
Vala CMake
|
||
==========
|
||
:Author:
|
||
Jakob Westhoff
|
||
:Version:
|
||
Draft
|
||
|
||
|
||
Overview
|
||
========
|
||
|
||
Vala CMake is a collection of macros for the CMake_ build system to allow the
|
||
creation and management of projects developed using the Vala_ programming
|
||
language or its "Genie" flavor (less tested).
|
||
|
||
|
||
Installation
|
||
============
|
||
|
||
To use the Vala macros in your own project you need to copy the macro files to
|
||
an arbitrary folder in your projects directory and reference them in your
|
||
``CMakeLists.txt`` file.
|
||
|
||
Assuming the macros are stored under ``cmake/vala`` in your projects folder you
|
||
need to add the following information to your base ``CMakeLists.txt``::
|
||
|
||
list(APPEND CMAKE_MODULE_PATH
|
||
${CMAKE_SOURCE_DIR}/cmake/vala
|
||
)
|
||
|
||
After the new module path as been added you can simply include the provided
|
||
modules or use the provided find routines.
|
||
|
||
|
||
Finding Vala
|
||
============
|
||
|
||
The find module for vala works like any other Find module in CMake.
|
||
You can use it by simply calling the usual ``find_package`` function. Default
|
||
parameters like ``REQUIRED`` and ``QUIETLY`` are supported.
|
||
|
||
::
|
||
|
||
find_package(Vala REQUIRED)
|
||
|
||
After a successful call to the find_package function the following variables
|
||
will be set:
|
||
|
||
VALA_FOUND
|
||
Whether the vala compiler has been found or not
|
||
|
||
VALA_EXECUTABLE
|
||
Full path to the valac executable if it has been found
|
||
|
||
VALA_VERSION
|
||
Version number of the available valac
|
||
|
||
|
||
Precompiling Vala sources
|
||
=========================
|
||
|
||
CMake is mainly supposed to handle c or c++ based projects. Luckily every vala
|
||
program is translated into plain c code using the vala compiler, followed by
|
||
normal compilation of the generated c program using gcc.
|
||
|
||
The macro ``vala_precompile`` uses that fact to create c files from your .vala
|
||
sources for further CMake processing.
|
||
|
||
The first parameter provided is a variable, which will be filled with a list of
|
||
c files outputted by the vala compiler. This list can than be used in
|
||
conjunction with functions like ``add_executable`` or others to create the
|
||
necessary compile rules with CMake.
|
||
|
||
The initial variable is followed by a list of .vala files to be compiled.
|
||
Please take care to add every vala file belonging to the currently compiled
|
||
project or library as Vala will otherwise not be able to resolve all
|
||
dependencies.
|
||
|
||
The following sections may be specified afterwards to provide certain options
|
||
to the vala compiler:
|
||
|
||
PACKAGES
|
||
A list of vala packages/libraries to be used during the compile cycle. The
|
||
package names are exactly the same, as they would be passed to the valac
|
||
"--pkg=" option.
|
||
|
||
OPTIONS
|
||
A list of optional options to be passed to the valac executable. This can be
|
||
used to pass "--thread" for example to enable multi-threading support.
|
||
|
||
DIRECTORY
|
||
Specify the directory where the output source files will be stored. If
|
||
ommitted, the source files will be stored in CMAKE_CURRENT_BINARY_DIR.
|
||
|
||
CUSTOM_VAPIS
|
||
A list of custom vapi files to be included for compilation. This can be
|
||
useful to include freshly created vala libraries without having to install
|
||
them in the system.
|
||
|
||
GENERATE_VAPI
|
||
Pass all the needed flags to the compiler to create an internal vapi for
|
||
the compiled library. The provided name will be used for this and a
|
||
<provided_name>.vapi file will be created.
|
||
|
||
GENERATE_HEADER
|
||
Let the compiler generate a header file for the compiled code. There will
|
||
be a header file as well as an internal header file being generated called
|
||
<provided_name>.h and <provided_name>_internal.h
|
||
|
||
The following call is a simple example to the vala_precompile macro showing an
|
||
example to every of the optional sections::
|
||
|
||
vala_precompile(VALA_C
|
||
source1.vala
|
||
source2.vala
|
||
source3.vala
|
||
PACKAGES
|
||
gtk+-2.0
|
||
gio-1.0
|
||
posix
|
||
OPTIONS
|
||
--thread
|
||
CUSTOM_VAPIS
|
||
some_vapi.vapi
|
||
GENERATE_VAPI
|
||
myvapi
|
||
GENERATE_HEADER
|
||
myheader
|
||
)
|
||
|
||
Most important is the variable VALA_C which will contain all the generated c
|
||
file names after the call. The easiest way to use this information is to tell
|
||
CMake to create an executable out of it.
|
||
|
||
::
|
||
|
||
add_executable(myexecutable ${VALA_C})
|
||
|
||
|
||
Further reading
|
||
===============
|
||
|
||
The `Pdf Presenter Console`__ , which is a vala based project of mine, makes
|
||
heavy usage of the here described macros. To look at a real world example of
|
||
these macros the mentioned project is the right place to take a look. The svn
|
||
trunk of it can be found at::
|
||
|
||
svn://pureenergy.cc/pdf_presenter_console/trunk
|
||
|
||
|
||
__ http://westhoffswelt.de/projects/pdf_presenter_console.html
|
||
|
||
|
||
Acknowledgments
|
||
===============
|
||
|
||
Thanks go out to Florian Sowade, a fellow local PHP-Usergroupie, who helped me
|
||
a lot with the initial version of this macros and always answered my mostly
|
||
dumb CMake questions.
|
||
|
||
.. _CMake: http://cmake.org
|
||
.. _Vala: http://live.gnome.org/Vala
|
||
.. _Genie: http://live.gnome.org/Genie
|
||
|
||
|
||
|
||
..
|
||
Local Variables:
|
||
mode: rst
|
||
fill-column: 79
|
||
End:
|
||
vim: et syn=rst tw=79
|