[Documentation] [TitleIndex] [WordIndex

Construire des Packages

Une fois que le système de dépendances de votre package est installé, vous pouvez maintenant construire votre nouveau package.

Note: Si vous avez installé ROS en utilisant apt ou un manager de paquets, vous devriez avoir toutes vos dépendances.

Avant de continuer pensez à "sourcer" votre environnement si ce n'est pas déjà fait. Sur Ubuntu se serait quelque chose comme ça :

$ source /opt/ros/groovy/setup.bash

Utiliser catkin_make

catkin_make c'est un outil en ligne de commande qui ajoute un certain confort à la procédure standard catkin. Vous pouvez imaginer ça : catkin_make combine l'appel à cmake et make à la norme CMake.

Utilisation :

# In a catkin workspace
$ catkin_make [make_targets] [-DCMAKE_VARIABLES=...]

Pour ceux qui ne sont pas familier avec la procédure standard CMake, elle se décompose comme suit :

Note: Si vous exécutez les commandes ci-dessous elles ne marcheront pas, c'est juste à titre d'exemple pour montrer comment fonctionne Cmake de manière générale.

# In a CMake project
$ mkdir build
$ cd build
$ cmake ..
$ make
$ make install  # (optionally)

Cette procédure est appliqué pour chaque projet Cmake. En comparaison des projets catkin qui peuvent être construits ensemble dans le workspace. Construire zéro ou plusieurs packages catkin dans un workspace suit la procédure suivante :

# In a catkin workspace
$ catkin_make
$ catkin_make install  # (optionally)

Les commandes ci-dessus construirons tous les projets présent dans le dossier src. Cela fait suite aux recommandations formulées par REP128. Si votre code source est à un endroit différent, appelé my_src alors vous pouvez appeler catkin_make comme ceci :

Note: Si vous exécutez les commandes suivantes elles ne marcheront pas, si le dossier my_src n'existe pas.

# In a catkin workspace
$ catkin_make --source my_src
$ catkin_make install --source my_src  # (optionally)

Pour une utilisation plus avancée de catkin_make voir la documentation : catkin/commands/catkin_make

Construire Son Package

Pour les lecteurs de cette page qui voudraient construire leur propre code, regardez aussi un des tutoriels suivants (C++)/(Python) puisque vous devrez peut-être modifier le fichier CMakeLists.txt.

Vous devriez déjà avoir un espace de travail catkin (catkin workspace) et un nouveau package catkin appelé beginner_tutorials de la leçon précédente, Créer un Package. Allez dans l'espace de travail catkin (catkin_ws) si vous n'y êtes pas déjà et regarder dans le dossier src :

$ cd ~/catkin_ws/
$ ls src

Vous devriez voir qu'il ya un dossier appelé beginner_tutorials que vous avez créé avec catkin_create_pkg dans le tutoriel précédent. Nous pouvons maintenant construire ce package en utilisant catkin_make :

$ catkin_make

Vous devriez voir sur votre console la sortie de cmake et aussi de make , qui devrait être similaire à ceci :

Notez que catkin_make affiche en premiers quels sont les chemins qu'il utilise pour chacun des 'espaces'. Les espaces sont décrits dans le REP128 et par la documentation de catkin/workspaces. La chose importante à noter est qu'en raison de ces valeur par défaut, plusieurs dossiers ont été créés dans votre espace de travail catkin. Regardez avec ls :

$ ls

Le dossier build est l'emplacement par défaut de l'espace de construction build space et c'est là que cmake et make sont appelés à configurer et construire vos packages. Le dossier devel est l'emplacement par défaut de l'espace de développement devel space, qui est l'endroit où vos exécutables et les bibliothèques de vos packages vont être installés.


2023-10-28 12:36