Adding a New Package
Here's how you add a new package to Chromium OS:
- Create an ebuild file for your package
src/third_party/chromiumos-overlay/. See the ebuild(5) man page (from within your development chroot) and the other ebuilds insrc/third_party/portageandsrc/third_party/chromiumos-overlay- for example, the ebuild file of systemtap is placed in
src/third_party/chromiumos-overlay/dev-util/systemtap.
- for example, the ebuild file of systemtap is placed in
- Upload the package to Localmirror of Google (require Google account).
- Create a README.chromiumos file that describes the purpose of the package. If your package is a third-party package, document any custom patches that have been applied
- Add a dependency to your new package in one of:
src/third_party/chromiumos-overlay/virtual/target-chromium-os- Includes the package in all images (base/release, developer, test)
src/third_party/chromiumos-overlay/virtual/target-chromium-os-dev- Includes the package in developer and test images
src/third_party/chromiumos-overlay/virtual/target-chromium-os-test- Includes the package in test images
src/third_party/chromiumos-overlay/virtual/target-chromium-os-sdk- Includes the package in the SDK itself
- Increment the revision number of the ebuild that you modified so that incremental builds recognize the changes.
The source code of the package shouldn't be placed in the src/. emerge will
download the package and store it in /var/lib/portage/distfiles-target/, and
the code is compiled in /build/tegra2_seaboard/tmp/portage/. When porting a
new package, we can put the package in /var/lib/portage/distfiles-target/.
Once you're done, make sure your changes to do not break the build system. Then create a changelist and get it reviewed (see Contributing Code for details).
Adding a package to a running Chromium OS system
The easiest way to add a new package, or update a package is to start
devserver on the build host, and use gmerge to build the package and install
the results on the target device.
See Using the dev server.
Adding a package to the manifest
TODO(b/326073657): Add information on how to add a package to a manifest.