2 title: Downloading AGL Software
5 Once you have determined the build host can build an AGL image,
6 you need to download the AGL source files.
7 The AGL source files, which includes the Yocto Project layers, are
8 maintained on the AGL Gerrit server.
9 For information on how to create accounts for Gerrit, see the
10 [Getting Started with AGL](https://wiki.automotivelinux.org/start/getting-started)
13 **NOTE:** Further information about Download and Build AGL Source Code available at [AGL wiki](https://wiki.automotivelinux.org/agl-distro/source-code).
15 The remainder of this section provides steps on how to download the AGL source files:
17 1. **Define Your Top-Level Directory:**
18 You can define an environment variable as your top-level AGL workspace folder.
19 Following is an example that defines the `$HOME/workspace_agl` folder using
20 an environment variable named "AGL_TOP":
23 $ export AGL_TOP=$HOME/AGL
24 $ echo 'export AGL_TOP=$HOME/AGL' >> $HOME/.bashrc
28 2. **Download the `repo` Tool and Set Permissions:**
29 AGL Uses the `repo` tool for managing repositories.
30 Use the following commands to download the tool and then set its
31 permissions to allow for execution:
35 $ export PATH=$HOME/bin:$PATH
36 $ echo 'export PATH=$HOME/bin:$PATH' >> $HOME/.bashrc
37 $ curl https://storage.googleapis.com/git-repo-downloads/repo > $HOME/bin/repo
38 $ chmod a+x $HOME/bin/repo
42 "[Repo Command Reference](https://source.android.com/setup/develop/repo)"
43 for more information on the `repo` tool.
45 3. **Download the AGL Source Files:**
46 Depending on your development goals, you can either download the
47 latest stable AGL release branch, or the "cutting-edge" (i.e. "master"
51 Using the latest stable release gives you a solid snapshot of the
53 The release is static, tested, and known to work.
54 To download the latest stable release branch (i.e. lamprey), use
55 the following commands:
61 $ repo init -b lamprey -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
65 * **Cutting-Edge Files:**
66 Using the "cutting-edge" AGL files gives you a snapshot of the
68 The resulting local repository you download is dynamic and changes frequently depending on community contributions.
69 The advantage of using "cutting-edge" AGL files is that you have the
70 absolute latest features, which are often under development, for AGL.
72 To download the "cutting-edge" AGL files, use the following commands:
78 $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
82 Once you `sync` the repository, you have the AGL files in the form of
83 "layers" (e.g. `meta-*` folders).
84 You also have the `poky` repository in your AGL workspace.
86 Listing out the resulting directory structure appears as follows:
94 ├── meta-agl-cluster-demo
98 └── meta-agl-telematics-demo