docs/1_Getting_Started/2_Building_AGL_Image/2_Preparing_Your_Build_Host.md

   1 ---
   2 title: Preparing Your Build Host
   3 ---
   4
   5 Preparing your build host so that it can build an AGL image means
   6 making sure your system is set up to use the
   7 [Yocto Project](https://yoctoproject.org) OpenEmbedded build system,
   8 which is based on
   9 [BitBake](https://docs.yoctoproject.org/bitbake.html).
  10
  11 This section presents minimal information so you can prepare the build host
  12 to use the "Dunfell" version of the Yocto Project (i.e. version 3.1.2).
  13 If you want more details on how the Yocto Project works, you can reference
  14 the Yocto Project documentation
  15 [here](https://www.yoctoproject.org/docs/).
  16
  17 **NOTE:** This entire section presumes you want to build an image.
  18 You can skip the entire build process if you want to use a ready-made
  19 development image.
  20 The [supported images](https://download.automotivelinux.org/AGL/snapshots/master/latest/) exist for several boards as
  21 well as for the Quick EMUlator (QEMU).
  22 See the
  23 "[Quickstart](../1_Quickstart/Using_Ready_Made_Images.md)"
  24 section for more information on the ready-made images.
  25
  26 1. **Use a Supported Linux Distribution:** To use the AGL software, it is
  27    recommended that your build host is a native Linux machine that runs a
  28    Yocto Project supported distribution as described by the
  29    "[Supported Linux Distributions](https://docs.yoctoproject.org/ref-manual/system-requirements.html#supported-linux-distributions)"
  30    section in the Yocto Project Reference Manual.
  31    Basically, you should be running a recent version of Ubuntu, Fedora, openSUSE,
  32    CentOS, or Debian.
  33
  34 2. **Be Sure Your Build Host Has Enough Free Disk Space:**
  35    Your build host should have at least 100 Gbytes.
  36
  37 3. **Be Sure Tools are Recent:**  You need to have recent versions for the following tools:
  38
  39       - Git 1.8.3.1 or greater
  40       - Tar 1.27 or greater
  41       - Python 3.4.0 or greater
  42
  43    If your distribution does not meet these minimal requirements, see the
  44    "[Required Git, tar, and Python Versions](https://docs.yoctoproject.org/ref-manual/system-requirements.html#required-git-tar-python-and-gcc-versions)"
  45    section in the Yocto Project Reference Manual for steps that you can
  46    take to be sure you have these tools.
  47
  48 4. **Install Essential, Graphical, and Eclipse Plug-in Build Host Packages:**
  49    Your build host needs certain host packages.
  50    Depending on the Linux distribution you are using, the list of
  51    host packages differ.
  52    See
  53    "[The Build Host Packages](https://docs.yoctoproject.org/ref-manual/system-requirements.html#required-packages-for-the-build-host)"
  54    section of the Yocto Project Quick Start for information on the packages you need.
  55
  56    **NOTE:** If you are using the CentOS distribution, you need to
  57    separately install the epel-release package and run the `makecache` command as
  58    described in
  59    "[The Build Host Packages](https://docs.yoctoproject.org/ref-manual/system-requirements.html#required-packages-for-the-build-host)"
  60    section of the Yocto Project Quick Start.
  61
  62    Aside from the packages listed in the previous section, you need the following:
  63
  64    * **Ubuntu and Debian:** curl
  65    * **Fedora:** curl
  66    * **OpenSUSE:** glibc-locale curl
  67    * **CentOS:** curl