Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
software:linux:yocto:getting_started_cpp [2020-03-31 11:15] mlammerichsoftware:linux:yocto:getting_started_cpp [2024-04-23 13:08] (aktuell) Moritz Lammerich
Zeile 1: Zeile 1:
-======= Getting started with Yocto and C/C++ =======+======= Getting Started with Yocto and C/C++ =======
  
-This guide will go through setting up a build environment and building an x86_64 image, and adding a small "hello world" application to it. First the application will be compiled using the [[ .:sdk SDK ]], then it will be added to the image directly by creating a [[ .:recipes | recipe ]].+This guide will go through setting up a build environment and building an x86_64 image, and adding a small "hello world" application to it. This page is a summary of the information from [[software:linux:yocto:setup|Setup and Building]], [[software:linux:yocto:recipes|Recipes]] and [[software:linux:yocto:devtool|devtool]].
  
-===== Setting up the build environment =====+===== Setting up the Build Environment =====
  
 Create a directory in a suitable place to store everything related to this build. Create a directory in a suitable place to store everything related to this build.
 This guide will assume everything is in a directory called ''yocto'' in your the home of the user ''ubuntu'': ''/home/ubuntu/yocto''. This folder can by anywhere on the system though. This guide will assume everything is in a directory called ''yocto'' in your the home of the user ''ubuntu'': ''/home/ubuntu/yocto''. This folder can by anywhere on the system though.
  
-Next, clone ''poky'', [[..: | yocto']] reference distribution. At the time of writing ''yocto-3.0.2'' is the newest release, feel free to substitute it for a newer/different version.+Next, clone ''poky'', yocto's reference distribution. At the time of writing ''yocto-3.0.2'' is the newest release, feel free to substitute it for a newer/different version.
 <code> <code>
-git clone -b yocto-3.0.2 git://git.yoctoproject.org/poky+git clone -b kirkstone git://git.yoctoproject.org/poky
 </code> </code>
  
Zeile 18: Zeile 18:
 </code> </code>
  
-Now we can initialize [[..: | yocto ]] using:+Now we can initialize yocto using:
 <code> <code>
 . poky/oe-init-build-env build/ . poky/oe-init-build-env build/
 </code> </code>
-This will populate the build directory with all necessary files and give you access to ''bitbake'', the build system used by [[..: | yocto ]].+This will populate the build directory with all necessary files and give you access to ''bitbake'', the build system used by yocto.
  
-==== Setting the machine ====+==== Setting the Machine ====
  
 Setting the machine tells bitbake what hardware to build for. This build will be a 64bit qemu image, so we can set the machine to ''qemu86-64''. This means we can run this image in Qemu. Setting the machine tells bitbake what hardware to build for. This build will be a 64bit qemu image, so we can set the machine to ''qemu86-64''. This means we can run this image in Qemu.
Zeile 40: Zeile 40:
 The build environment is now set up. The build environment is now set up.
  
-===== Building an image =====+===== Building an Image =====
  
 You can now build an image. This command will build a minimal image provided by ''poky'': You can now build an image. This command will build a minimal image provided by ''poky'':
Zeile 55: Zeile 55:
  
 ''runqemu'' is a script that comes with bitbake, ''qemux86-64'' specifies the machine, and ''nographic'' tells qemu to run in the terminal rather than its own window. This is useful when building on a system with no graphical environment such as a container or when building in the cloud. ''runqemu'' is a script that comes with bitbake, ''qemux86-64'' specifies the machine, and ''nographic'' tells qemu to run in the terminal rather than its own window. This is useful when building on a system with no graphical environment such as a container or when building in the cloud.
 +
 +The default login is ''root'' with no password. You can use ''poweroff'' to shut down the virtual machine and exit qemu.
  
 ===== Creating a Hello World C++ Application ===== ===== Creating a Hello World C++ Application =====
Zeile 105: Zeile 107:
 </code> </code>
  
-==== Optional: Verifying the application works ====+==== Optional: Verifying that the Application Works ====
  
 This is an optional step to verify the application itself is built correctly before adding it to the image. This is an optional step to verify the application itself is built correctly before adding it to the image.
 Create a ''build'' directory inside the application folder for cmake to store its data in. Create a ''build'' directory inside the application folder for cmake to store its data in.
 Then execute ''cmake'' inside that folder to create the build configuration and build the  Then execute ''cmake'' inside that folder to create the build configuration and build the 
-applucation by running ''make''.+application by running ''make''.
 Now there should be a ''hello'' executable that prints "hello world" when executed. Now there should be a ''hello'' executable that prints "hello world" when executed.
 After confirming it works, change back to ''yocto/build'' before continuing with the next step. After confirming it works, change back to ''yocto/build'' before continuing with the next step.
Zeile 120: Zeile 122:
 make make
 ./hello ./hello
-cd ../build+cd ../../build
 </code> </code>
  
 +===== Creating a Recipe for the application =====
 +
 +We use [[software:linux:yocto:devtool|devtool]] to create a new [[ .:recipes | Recipe ]] for our ''hello'' application.
 +<code>
 +devtool add ../helloworld/
 +</code>
 +
 +This should finish with a message similar to this one:
 +<code>
 +INFO: Recipe /home/ubuntu/yocto/build/workspace/recipes/helloworld/helloworld.bb has been automatically created; further editing may be required to make it fully functional
 +</code>
 +
 +This means devtool ran successfully and created a recipe at the specified location. 
 +
 +To test whether this recipe works, build it by running bitbake:
 +
 +<code>
 +bitbake helloworld
 +</code>
 +
 +This should run without errors and print something like this when it's finished:
 +
 +<code>
 +NOTE: Tasks Summary: Attempted 506 tasks of which 497 didn't need to be rerun and all succeeded.
 +</code>
 +
 +This means the package provided by the recipe was built successfully.
 +
 +===== Adding the Recipe to the Image =====
 +
 +Now that we have a recipe, we need to add it to the image to test it out.
 +Adding packages to recipes is done in ''conf/local.conf'' by appending them to ''CORE_IMAGE_EXTRA_INSTALL'':
 +
 +Edit ''local.conf''
 +<code>
 +nano conf/local.conf
 +</code>
 +
 +and add the following:
 +<code>
 +CORE_IMAGE_EXTRA_INSTALL += "helloworld"
 +</code>
 +
 +Rebuild the image
 +<code>
 +bitbake core-image-minimal
 +</code>
 +
 +And run qemu
 +
 +<code>
 +runqemu qemux86-64 nographic
 +</code>
 +
 +Log in as ''root'' and you can now run our ''hello'' application:
 +<code>
 +root@qemux86-64:~# hello
 +Hello World!
 +</code>
  
 +Congratulations! You have now developed your own C++ application and added it to a yocto image.