.. _section-building-micro:

Building |me_h|
===============

.. highlight:: none

This section is for users who are already familiar with `CMake <https://cmake.org/>`_ and may have
built earlier versions of |me|. The sections following describe the process
in detail and are recommended for everyone building |me|.

This section assumes that the |me| source-bundle has been downloaded and installed and
that `CMake <https://cmake.org/>`_ is available.

1. Make sure `CMake <https://cmake.org/>`_ is in the path. 
2. Run ``rtime-make``. 

   On UNIX® systems::

    cd <rti_me install directory>
    # you should see directories like doc/ lib/ rtiddsgen/ src/
    # and CMakeLists.txt

    resource/scripts/rtime-make --target x64Linux4gcc7.3.0 \
                -G "Unix Makefiles" --build

   On Windows® systems::

    cd <rti_me install directory>
    # you should see directories like doc/ lib/ rtiddsgen/ src/
    # and CMakeLists.txt

    resource\scripts\rtime-make --target x64Win64VS2017 \
                -G "NMake Makefiles" --build

   .. note::

      Running the command above will build debug libraries. To build release 
      libraries, add the following flag::

      --config Release

3. You will find the |me| libraries here: 

   On UNIX-based systems: ::

    # <rti_me install directory>/lib/x64Linux4gcc7.3.0

   On Windows systems: ::

    # <rti_me install directory>\lib\x64Win64VS2017

.. note::
   
   ``rtime-make`` uses the platform specified with ``--target`` 
   to determine a few settings needed by |me|. 
   Please refer to :ref:`prepare` for details.