|
|
Line 1: |
Line 1: |
− | The OpenEmbedded (OE) manual introduces Bitbake recipes using a single 'helloworld' tutorial. While this is a useful introduction, there are many other common use cases.
| + | This page has been superseded by the infomation [https://www.yoctoproject.org/docs/latest/bitbake-user-manual/bitbake-user-manual.html#hello-world-example here]. |
− | | + | |
− | ==Hello World==
| + | |
− | The git repository given below contains a user.collections directory complete with a number of sample helloworld recipes elucidating different use cases. An explanation for each is given below:
| + | |
− | <table>
| + | |
− | <tr>
| + | |
− | <th>Recipe:</th><th>Description:</th><th>Command:</th>
| + | |
− | </tr><tr>
| + | |
− | <td>myhelloworld</td><td>vanilla OE helloworld tutorial</td><td>myhelloworld</td>
| + | |
− | </tr><tr>
| + | |
− | <td>myhello-cpp</td><td>a simple C++ recipe</td><td>myhello-cpp<td>
| + | |
− | </tr><tr>
| + | |
− | <td>myhello-make</td><td>a recipe that uses a Makefile</td><td>myhello-make<td>
| + | |
− | </tr><tr>
| + | |
− | <td>myhello-cmake</td><td>a recipe that uses cmake and creates a library</td><td>myhello-cmake<td>
| + | |
− | </tr><tr>
| + | |
− | <td>myhello-python</td><td>a rather trivial python recipe</td><td>myhello-python<td>
| + | |
− | </tr><tr>
| + | |
− | <td>myhello-git</td><td>shows git fetcher and patching</td><td>myhello-git<td>
| + | |
− | </tr>
| + | |
− | </table>
| + | |
− | | + | |
− | ==Usage==
| + | |
− | # Clone this git repository from your top-level OE directory. For the sake of these instructions, we assume this is '~/overo-oe'.
| + | |
− | #:<pre>$ ~/overo-oe/ </pre>
| + | |
− | #:<pre>$ git clone git://github.com/ashcharles/oe-usercollection.git user.collection</pre>
| + | |
− | #:'''Note:''' If you already have a ''user.collection'' directory, you might like to clone the repository by its default name (oe-usercollection) and then let bitbake know about this folder. See the ''extras'' folder inside the recipe for hints on this.
| + | |
− | # Bitbake the desired recipe based on its recipe name e.g. ''bitbake myhello-cpp''
| + | |
− | # Copy the newly created package file from your build machine to your Gumstix. You might do this by transfering the files on microSD card, using a serial connection, or, most simply, copying them over an internet connection. E.g.
| + | |
− | #:<pre>$ scp ~/overo-oe/tmp/deploy/glibc/ipk/armv5te/myhelloworld_0.0.1-r0.5_armv5te.ipk root@mygumstixcom:~ </pre>
| + | |
− | # Install your package and test it out:
| + | |
− | #:<pre>> opkg install myhelloworld_0.0.1-r0.5_armv5te.ipk </pre>
| + | |
− | #:<pre>> myhelloworld </pre>
| + | |
− | #:<pre>Hello world! </pre>
| + | |
− | | + | |
− | There are lots of use cases not covered here, feel free to add new or request new ones (ash (AT) gumstix (DOT) com)
| + | |
− | | + | |
− | ==Helpful Links==
| + | |
− | * http://docs.openembedded.org/usermanual/usermanual.html#recipes_helloworld_example
| + | |
− | * http://www.gumstix.net/User-How-To-s/view/Build-system-overview/Hello-world-tutorial/110.html
| + | |