aboutsummaryrefslogtreecommitdiffstats
path: root/docs/0_Getting_Started/2_Building_AGL_Image/2_Downloading_AGL_Software.md
blob: bb43d0a945dd0f90160b5c53633785f4d0825abf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
---
title: Downloading AGL Software
---

Once you have determined the build host can build an AGL image,
you need to download the AGL source files.
The AGL source files, which includes the Yocto Project layers, are
maintained on the AGL Gerrit server.
For information on how to create accounts for Gerrit, see the
[Getting Started with AGL](https://wiki.automotivelinux.org/start/getting-started)
wiki page.

The remainder of this section provides steps on how to download the AGL source files:

1. **Define Your Top-Level Directory:**
   You can define an environment variable as your top-level AGL workspace folder.
   Following is an example that defines the `$HOME/workspace_agl` folder using
   an environment variable named "AGL_TOP":

      ```sh
      $ export AGL_TOP=$HOME/AGL
      $ echo 'export AGL_TOP=$HOME/AGL' >> $HOME/.bashrc
      $ mkdir -p $AGL_TOP
      ```

2. **Download the `repo` Tool and Set Permissions:**
   AGL Uses the `repo` tool for managing repositories.
   Use the following commands to download the tool and then set its
   permissions to allow for execution:

      ```sh
      $ mkdir -p $HOME/bin
      $ export PATH=$HOME/bin:$PATH
      $ echo 'export PATH=$HOME/bin:$PATH' >> $HOME/.bashrc
      $ curl https://storage.googleapis.com/git-repo-downloads/repo > $HOME/bin/repo
      $ chmod a+x $HOME/bin/repo
      ```

   **NOTE:** See the
   "[Repo Command Reference](https://source.android.com/setup/develop/repo)"
   for more information on the `repo` tool.

3. **Download the AGL Source Files:**

   * **Stable Release:**
     Using the latest stable release gives you a solid snapshot of the
     latest know release.
     The release is static, tested, and known to work.
     To download the latest stable release branch (i.e. Jellyfish), use
     the following commands:

     ```sh
     $ cd $AGL_TOP
     $ mkdir jellyfish
     $ cd jellyfish
     $ repo init -b jellyfish -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
     $ repo sync
     ```

   Once you `sync` the repository, you have the AGL files in the form of
   "layers" (e.g. `meta-*` folders).
   You also have the `poky` repository in your AGL workspace.

   Listing out the resulting directory structure appears as follows:

   ```sh
   $ tree -L 1
    .
    ├── bsp
    ├── external
    ├── meta-agl
    ├── meta-agl-cluster-demo
    ├── meta-agl-demo
    ├── meta-agl-devel
    ├── meta-agl-extra
    └── meta-agl-telematics-demo
   ```