Changes between Initial Version and Version 1 of clone_demo

Timestamp:

Mar 23, 2021, 4:30:06 PM (4 years ago)

Author:

Sanahuja Guillaume

Comment:

--

clone_demo

@@ +1 @@
+[[PageOutline]]
+
+= How to properly clone a demo =
+
+== Intro ==
+
+This page will help you to copy sources of an existing demo and prepare them for your new application.
+
+A script is provided to do that, it will change any references from the old demo to the new one. If needed, it will rename source files, change the name of the classes, adapt the CMakeLists.txt and adapt the launch scripts for both uav and simulator.
+
+This is very useful if you want to base your work on an existing demo. **Just copying source files from the demos is not a good practice.** 
+
+== Cloning a demo ==
+
+A good practice is to put your sources in a separate folder (assumed to be ''my_src'' in this section) from other flair sources.
+To clone the !CircleFollower demo to a new application called !MyApp in ''my_src'' folder:
+{{{
+cd $FLMAIR_ROOT/my_src
+$FLAIR_ROOT/flair-src/scripts/clone_demo.sh $FLAIR_ROOT/flair-src/demos/CircleFollower/ MyApp
+}}} 
+Output should be something like that:
+{{{
+cloning CircleFollower/ to MyApp
+old project name is CircleFollower
+
+parsing ./CMakeLists.txt
+changed reference of CircleFollower to MyApp
+
+parsing ./simulator/CMakeLists.txt
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/CMakeLists.txt
+renamed src/CircleFollower.cpp to src/MyApp.cpp
+renamed src/CircleFollower.h to src/MyApp.h
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/src/main.cpp
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/src/MyApp.cpp
+changed reference of CircleFollower to MyApp
+
+parsing ./simulator/src/main.cpp
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/src/MyApp.h
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/resources/core2-64/x4.sh
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/resources/core2-64/x8.sh
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/resources/armv5te/CircleFollower_minidrones.sh
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/resources/armv7a-neon/CircleFollower_hdsx8.sh
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/resources/armv7a-neon/CircleFollower_bebop.sh
+changed reference of CircleFollower to MyApp
+
+parsing ./uav/resources/armv7a-neon/CircleFollower_ardrone2.sh
+changed reference of CircleFollower to MyApp
+
+parsing ./simulator/resources/core2-64/simulator_x8.sh
+changed reference of CircleFollower to MyApp
+
+parsing ./simulator/resources/core2-64/simulator_x4.sh
+changed reference of CircleFollower to MyApp
+}}}
+Showing you the changes made.
+
+You can then build the project with the documentation from [wiki:compile_all#Compileyourownproject this page].
+
+== Notes ==
+
+This script has been successfully tested on the following demos:
+
+* !CircleFollower
+* !TwoWheelRobotCircleFollower
+* !DemoGps
+* !MixedReality
+* !DemoOpticalFlow
+* !PidStandalone
+* !SimpleFleet
+* !TwoWheelRobotSimpleFleet
+* Sinus
+
+It also should work to clone your own applications!
+
+**NB**: the script heavily relies on ''sed'' to replace strings. It can make mistakes if the source or the destination project name is contained in an existing class or method of flair! 
+