Include:Abuild: Difference between revisions

From Alpine Linux
(24 intermediate revisions by 7 users not shown)
Line 1: Line 1:
To build a package, <tt>abuild</tt> is used. Besides the package building functionality, options for other package maintainance tasks are also provided.


If you just want to build a package from an [[APKBUILD Reference|APKBUILD]] file, only those two command are needed.


== Package build helpers ==
{{Cmd|abuild checksum && abuild -r}}


=== abuild-keygen ===
To use the command above, you have to be in the <code>abuild</code> group.


=== abuild-sign ===


=== abuild-tar ===
Below all options and commands for <tt>abuild</tt> are listed.


=== abuild ===
{{Cmd|<nowiki>abuild [options] [-P REPODEST] [-s SRCDEST] [-D DESCRIPTION] [cmd] ...</nowiki>}}


=== abump ===
'''abuild options'''
* '''-A'''  Print CARCH and exit                                                                                                                                                 
* '''-c'''  Enable colored output
* '''-d'''  Disable dependency checking
* '''-D'''  Set APKINDEX description (default: $repo $(git describe))
* '''-f'''  Force specified cmd (skip checks: apk up to date, arch, libc)
* '''-F'''  Force run as root
* '''-h'''  Show this help
* '''-i'''  Install PKG after successful build
* '''-k'''  Keep built packages, even if APKBUILD or sources are newer
* '''-K'''  Keep buildtime temp dirs and files (srcdir/pkgdir/deps)
* '''-m'''  Disable colors (monochrome)
* '''-P'''  Set REPODEST as the repository location for created packages
* '''-q'''  Quiet
* '''-r'''  Install missing dependencies from system repository (using sudo)
* '''-R'''  Recursively build and install missing dependencies (using sudo)
* '''-s'''  Set source package destination directory
* '''-u'''  Recursively build and upgrade all dependencies (using sudo)
* '''-v'''  Verbose: show every command as it is run (very noisy)


== APKBUILD generation ==
'''abuild commands'''
* '''build'''      Compile and install package into $pkgdir
* '''check'''      Run any defined tests concerning the package
* '''checksum'''    Generate checksum to be included in APKBUILD
* '''clean'''      Remove temp build and install dirs
* '''cleancache'''  Remove downloaded files from $SRCDEST
* '''cleanoldpkg''' Remove binary packages except current version
* '''cleanpkg'''    Remove already built binary and source package
* '''deps'''        Install packages listed in makedepends and depends
* '''fetch'''      Fetch sources to $SRCDEST and verify checksums
* '''index'''      Regenerate indexes in $REPODEST
* '''listpkg'''    List target packages
* '''package'''    Create package in $PKGDEST
* '''prepare'''    Apply patches
* '''rootbld'''    Build package in clean chroot
* '''rootpkg'''    Run 'package', the split functions and create apks as fakeroot
* '''sanitycheck''' Basic sanity check of APKBUILD
* '''snapshot'''    Create a $giturl or $svnurl snapshot and upload to $disturl
* '''sourcecheck''' Check if remote source package exists upstream
* '''srcpkg'''      Make a source package
* '''undeps'''      Uninstall packages listed in makedepends and depends
* '''unpack'''      Unpack sources to $srcdir
* '''up2date'''    Compare target and sources dates
* '''verify'''      Verify checksums


=== newapkbuild ===
= See also =
To create the actual APKBUILD file <tt>newapkbuild</tt> can serve you a template to start with. It will create a directory with the given package name, place an example/template APKBUILD file to the given directory, and fill some variables if those are provided.
* [[Abuild and Helpers]]


{{:Newapkbuild}}
[[category: Package Manager]]
 
=== apkbuild-cpan ===
 
=== apkbuild-pypi ===
 
 
 
 
=== apkgrel ===
 
=== buildlab ===
More details can be found at the [[Buildlab|buildlab]] page.
 
 
=== buildrepo ===
 
== Misc tools ==
 
=== cmp-apks-iso ===
 
=== devbuild ===
 
=== initramfs-init ===

Revision as of 07:18, 18 October 2019

To build a package, abuild is used. Besides the package building functionality, options for other package maintainance tasks are also provided.

If you just want to build a package from an APKBUILD file, only those two command are needed.

abuild checksum && abuild -r

To use the command above, you have to be in the abuild group.


Below all options and commands for abuild are listed.

abuild [options] [-P REPODEST] [-s SRCDEST] [-D DESCRIPTION] [cmd] ...

abuild options

  • -A Print CARCH and exit
  • -c Enable colored output
  • -d Disable dependency checking
  • -D Set APKINDEX description (default: $repo $(git describe))
  • -f Force specified cmd (skip checks: apk up to date, arch, libc)
  • -F Force run as root
  • -h Show this help
  • -i Install PKG after successful build
  • -k Keep built packages, even if APKBUILD or sources are newer
  • -K Keep buildtime temp dirs and files (srcdir/pkgdir/deps)
  • -m Disable colors (monochrome)
  • -P Set REPODEST as the repository location for created packages
  • -q Quiet
  • -r Install missing dependencies from system repository (using sudo)
  • -R Recursively build and install missing dependencies (using sudo)
  • -s Set source package destination directory
  • -u Recursively build and upgrade all dependencies (using sudo)
  • -v Verbose: show every command as it is run (very noisy)


abuild commands

  • build Compile and install package into $pkgdir
  • check Run any defined tests concerning the package
  • checksum Generate checksum to be included in APKBUILD
  • clean Remove temp build and install dirs
  • cleancache Remove downloaded files from $SRCDEST
  • cleanoldpkg Remove binary packages except current version
  • cleanpkg Remove already built binary and source package
  • deps Install packages listed in makedepends and depends
  • fetch Fetch sources to $SRCDEST and verify checksums
  • index Regenerate indexes in $REPODEST
  • listpkg List target packages
  • package Create package in $PKGDEST
  • prepare Apply patches
  • rootbld Build package in clean chroot
  • rootpkg Run 'package', the split functions and create apks as fakeroot
  • sanitycheck Basic sanity check of APKBUILD
  • snapshot Create a $giturl or $svnurl snapshot and upload to $disturl
  • sourcecheck Check if remote source package exists upstream
  • srcpkg Make a source package
  • undeps Uninstall packages listed in makedepends and depends
  • unpack Unpack sources to $srcdir
  • up2date Compare target and sources dates
  • verify Verify checksums

See also