forked from brl/citadel
103 lines
4.8 KiB
XML
103 lines
4.8 KiB
XML
|
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|||
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
|
|||
|
|
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
|
|||
|
|
|
|||
|
|
<chapter id='adt-package'>
|
|||
|
|
<title>Optionally Customizing the Development Packages Installation</title>
|
|||
|
|
|
|||
|
|
<para>
|
|||
|
|
Because the Yocto Project is suited for embedded Linux development, it is
|
|||
|
|
likely that you will need to customize your development packages installation.
|
|||
|
|
For example, if you are developing a minimal image, then you might not need
|
|||
|
|
certain packages (e.g. graphics support packages).
|
|||
|
|
Thus, you would like to be able to remove those packages from your target sysroot.
|
|||
|
|
</para>
|
|||
|
|
|
|||
|
|
<section id='package-management-systems'>
|
|||
|
|
<title>Package Management Systems</title>
|
|||
|
|
|
|||
|
|
<para>
|
|||
|
|
The OpenEmbedded build system supports the generation of sysroot files using
|
|||
|
|
three different Package Management Systems (PMS):
|
|||
|
|
<itemizedlist>
|
|||
|
|
<listitem><para><emphasis>OPKG:</emphasis> A less well known PMS whose use
|
|||
|
|
originated in the OpenEmbedded and OpenWrt embedded Linux projects.
|
|||
|
|
This PMS works with files packaged in an <filename>.ipk</filename> format.
|
|||
|
|
See <ulink url='http://en.wikipedia.org/wiki/Opkg'></ulink> for more
|
|||
|
|
information about OPKG.</para></listitem>
|
|||
|
|
<listitem><para><emphasis>RPM:</emphasis> A more widely known PMS intended for GNU/Linux
|
|||
|
|
distributions.
|
|||
|
|
This PMS works with files packaged in an <filename>.rpm</filename> format.
|
|||
|
|
The build system currently installs through this PMS by default.
|
|||
|
|
See <ulink url='http://en.wikipedia.org/wiki/RPM_Package_Manager'></ulink>
|
|||
|
|
for more information about RPM.</para></listitem>
|
|||
|
|
<listitem><para><emphasis>Debian:</emphasis> The PMS for Debian-based systems
|
|||
|
|
is built on many PMS tools.
|
|||
|
|
The lower-level PMS tool <filename>dpkg</filename> forms the base of the Debian PMS.
|
|||
|
|
For information on dpkg see
|
|||
|
|
<ulink url='http://en.wikipedia.org/wiki/Dpkg'></ulink>.</para></listitem>
|
|||
|
|
</itemizedlist>
|
|||
|
|
</para>
|
|||
|
|
</section>
|
|||
|
|
|
|||
|
|
<section id='configuring-the-pms'>
|
|||
|
|
<title>Configuring the PMS</title>
|
|||
|
|
|
|||
|
|
<para>
|
|||
|
|
Whichever PMS you are using, you need to be sure that the
|
|||
|
|
<ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_CLASSES'><filename>PACKAGE_CLASSES</filename></ulink>
|
|||
|
|
variable in the <filename>conf/local.conf</filename>
|
|||
|
|
file is set to reflect that system.
|
|||
|
|
The first value you choose for the variable specifies the package file format for the root
|
|||
|
|
filesystem at sysroot.
|
|||
|
|
Additional values specify additional formats for convenience or testing.
|
|||
|
|
See the <filename>conf/local.conf</filename> configuration file for
|
|||
|
|
details.
|
|||
|
|
</para>
|
|||
|
|
|
|||
|
|
<note>
|
|||
|
|
For build performance information related to the PMS, see the
|
|||
|
|
"<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-package'><filename>package.bbclass</filename></ulink>"
|
|||
|
|
section in the Yocto Project Reference Manual.
|
|||
|
|
</note>
|
|||
|
|
|
|||
|
|
<para>
|
|||
|
|
As an example, consider a scenario where you are using OPKG and you want to add
|
|||
|
|
the <filename>libglade</filename> package to the target sysroot.
|
|||
|
|
</para>
|
|||
|
|
|
|||
|
|
<para>
|
|||
|
|
First, you should generate the IPK file for the
|
|||
|
|
<filename>libglade</filename> package and add it
|
|||
|
|
into a working <filename>opkg</filename> repository.
|
|||
|
|
Use these commands:
|
|||
|
|
<literallayout class='monospaced'>
|
|||
|
|
$ bitbake libglade
|
|||
|
|
$ bitbake package-index
|
|||
|
|
</literallayout>
|
|||
|
|
</para>
|
|||
|
|
|
|||
|
|
<para>
|
|||
|
|
Next, source the cross-toolchain environment setup script found in the
|
|||
|
|
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
|
|||
|
|
Follow that by setting up the installation destination to point to your
|
|||
|
|
sysroot as <replaceable>sysroot_dir</replaceable>.
|
|||
|
|
Finally, have an OPKG configuration file <replaceable>conf_file</replaceable>
|
|||
|
|
that corresponds to the <filename>opkg</filename> repository you have just created.
|
|||
|
|
The following command forms should now work:
|
|||
|
|
<literallayout class='monospaced'>
|
|||
|
|
$ opkg-cl –f <replaceable>conf_file</replaceable> -o <replaceable>sysroot_dir</replaceable> update
|
|||
|
|
$ opkg-cl –f <replaceable>cconf_file</replaceable> -o <replaceable>sysroot_dir</replaceable> \
|
|||
|
|
--force-overwrite install libglade
|
|||
|
|
$ opkg-cl –f <replaceable>cconf_file</replaceable> -o <replaceable>sysroot_dir</replaceable> \
|
|||
|
|
--force-overwrite install libglade-dbg
|
|||
|
|
$ opkg-cl –f <replaceable>conf_file> -o </replaceable>sysroot_dir> \
|
|||
|
|
--force-overwrite install libglade-dev
|
|||
|
|
</literallayout>
|
|||
|
|
</para>
|
|||
|
|
</section>
|
|||
|
|
</chapter>
|
|||
|
|
<!--
|
|||
|
|
vim: expandtab tw=80 ts=4
|
|||
|
|
-->
|