12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788 |
- // -*- mode:doc; -*-
- // vim: set syntax=asciidoc:
- Daily use
- ---------
- Understanding when a full rebuild is necessary
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- OpenADK tries to detect what part of the system should be rebuilt when the
- system configuration is changed through +make menuconfig+. In some cases it
- automatically rebuilt packages, but sometimes just a warning is printed to the
- terminal, that a rebuild is necessary to make the changes an effect. If strange
- things are happening, the autodetection might have not worked correctly, then
- you should consider to rebuild everything. If you are following development you
- should always do a full rebuild after fetching updates via +git pull+. It is
- not always required, but if anything fails, you are on your own.
- Use following to do a full rebuild without refetching distfiles:
- --------------------
- $ make cleandir && make
- --------------------
- Understanding how to rebuild packages
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- In OpenADK you can rebuild a single package with:
- --------------------
- $ make package=<pkgname> clean package
- --------------------
- It will automatically remove all files added to the staging target directory
- +target_*+. If you just want to restart compilation process, after making
- some fixes in +build_*/w-<pkgname>-<pkgversion>/+, just do:
- --------------------
- $ make package=<pkgname> package
- --------------------
- If you are happy with your changes to the package sources, you can automatically
- generate a patch, which will be saved in +package/<pkgname>/patches+ and automatically
- applied on the next clean rebuild:
- --------------------
- $ make package=<pkgname> update-patches
- --------------------
- The newly created patches will be opened in $EDITOR, so you can add some comments to
- the top of the file, before the diff.
- Offline builds
- ~~~~~~~~~~~~~~
- If you intend to do an offline build and just want to download
- all sources that you previously selected in the configurator
- then issue:
- --------------------
- $ make download
- --------------------
- You can now disconnect or copy the content of your +dl+
- directory to the build-host.
- [[env-vars]]
- Environment variables
- ~~~~~~~~~~~~~~~~~~~~~
- OpenADK also honors some environment variables, when they are passed
- to +make+.
- * +ADK_APPLIANCE+, the appliance task you want to build
- * +ADK_CUSTOM_TASKS_DIR+, extra directory to fetch tasks from
- * +ADK_TARGET_ARCH+, the architecture of the target system
- * +ADK_TARGET_SYSTEM+, the embedded target system name
- * +ADK_TARGET_LIBC+, the C library for the target system
- * +ADK_VERBOSE+, verbose build, when set to 1
- An example that creates a configuration file for Raspberry PI with all
- software packages enabled, but not included in the resulting firmware image:
- --------------------
- $ make ADK_APPLIANCE=new ADK_TARGET_ARCH=arm ADK_TARGET_SYSTEM=raspberry-pi ADK_TARGET_LIBC=musl allmodconfig
- --------------------
- This is often used in the development process of a target system, to verify that
- all packages are compilable.
|