Difference between revisions of "Buildiso with AUR packages: Using buildpkg"

This tutorial is about creating your own online repository and building a custom package(set) with the help of ''buildpkg''. Later, you can install those packages to your customized Manjaro ISO using '''buildiso'''.

The first thing you should probably do is create a directory for your online repository. The online repository is called '''online-repo''' throughout this tutorial and it is located in your home-folder. You however are free to choose name location to your liking. This'll help keep things organized. Your repository consist of only this folder:

~ >>> mkdir ~/online-repo

==Create your custom package tree==

Create a folder for the packages you want to build. The name is arbitrary decriptor - you can call it anything you think suitable.

~ >>> mkdir ~/pkgbuild

Clone the relevant package(s) from AUR or from Github. Later you might create them yourself! You can select any package to build but as example we build the package <code>kickshaw</code>. Kickshaw is modern menu editor for among others openbox. First you add it to your pkgubild repo. Do this using git

~ >>> cd ~/pkgbuild

~/pkgbuild >>> git clone https://aur.archlinux.org/kickshaw

Now you have a folder with a <code>PKGBUILD</code> file in your repo

The '''buildpkg''' has some options you need to familiarize yourself with.

    -a <arch>          Arch [default: x86_64]

    -b <branch>        Branch [default: unstable]

    -i <pkgs>          Install packages into the working copy of the chroot

Next thing to do is build the package. Please note that you must be located one level above your actual PKGBUILD. Understand this as the <code>-p</code> argument is '''the name of the folder''' holding the PKGBUILD instructionset.

For more examples how to use '''buildpkg''', look [https://wiki.manjaro.org/index.php?title=Manjaro-tools#buildpkg here].

The resulting package is created in this directory on your system:

  /var/cache/manjaro-tools/pkg/<code>$branch</code>/<code>$arch</code>

On a 64-Bit system using the stable branch the exact path is

  /var/cache/manjaro-tools/pkg/stable/x86_64

~ >>> cp -r /var/cache/manjaro-tools/pkg/stable ~/online-repo

To keep track of available packages the ''pacman'' package manager uses database files which is downloaded and kept on your computer. You need to create such a database file for your repo. It is crucial that your database filename is the same as your repo name. If your repo is named '''online-repo''' then your database name must be '''online-repo.db.tar.gz'''.

Use the command <code>repo-add</code> to build a database file

~/online-repo/x86_64 >>> repo-add online-repo.db.tar.gz *.pkg.tar.*

  ~/online-repo/x86_64 >>> ls

  kickshaw-0.5-2-x86_64.pkg.tar.xz  online-repo.db  online-repo.db.tar.gz online-repo.files  online-repo.files.tar.gz

Custom non-online repositories will be added to the resulting pacman.conf. This means AUR packages are best installed from a custom online repository (as demonstrated by <code>[online-repo]</code> in this tutorial). Packages neither available in the Manjaro repositories nor in the AUR are best installed from a custom non-online repository (see <code>[infinality-bundle]</code> as example).

You can now add <code>kickshaw</code> to your package list for your ISO profile. This means your <code>/usr/share/manjaro-tools/iso-profiles/official/xfce/Packages-Xfce</code> file should look exactly like this:

  '''kickshaw'''