meta-agl-demo.md

   1 ## Introduction
   2
   3 The `meta-agl-demo` layer is the IVI demo layer that uses the core
   4 AGL infrastructure provided through profiles.
   5 The layer sits on top of the profiles as follows:
   6
   7 profile-core <- profile-gfx <- profile-gfx-qt5
   8
   9 The layer provides a reference platform and applications.
  10 The BitBake target name for the demo platform is `agl-demo-platform`,
  11 which is the full demo platform image.
  12
  13 ## Layer Dependencies
  14
  15 This section describes dependencies for the `meta-agl-demo` layer.
  16 Dependencies are grouped into base, hardware, and feature dependencies.
  17
  18 ### Base Dependencies
  19
  20 The `meta-agl-demo` layer has the following base dependencies:
  21
  22 * Yocto Project Release:
  23
  24   - URI: git://git.yoctoproject.org/poky
  25   - Branch: "thud"
  26   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
  27     manifest file for the `AGL-repo` repository for revision
  28     information.
  29
  30 * AGL `meta-agl` Layer:
  31
  32   - URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-agl
  33   - Branch: "flounder"
  34
  35 * OpenEmbedded `meta-openembedded` Layer:
  36
  37   - Branch: "thud"
  38   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
  39     manifest file for the `AGL-repo` repository for revision
  40     information.
  41
  42   Specifically, out of `meta-openembedded`, these sub-layers are used:
  43
  44   - `meta-oe`
  45   - `meta-multimedia`
  46   - `meta-efl`
  47   - `meta-networking`
  48   - `meta-python`
  49   - `meta-ruby`
  50
  51 * Yocto Project `meta-qt5` Layer from the
  52   [OpenEmbedded Layer Index](https://layers.openembedded.org/layerindex/branch/master/layers/):
  53
  54   - URI: https://github.com/meta-qt5/meta-qt5.git
  55   - Branch:   "thud"
  56   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
  57     manifest file for the `AGL-repo` repository for revision
  58     information.
  59
  60 ### Feature Dependencies
  61
  62 The `meta-agl-demo` layer has the following AGL
  63 [feature](../../../../getting_started/en/dev/reference/image-workflow-initialize-build-environment.html#agl-features)
  64 dependencies:
  65
  66 **The `agl-appfw-smack` Feature:**
  67
  68 <!--
  69 * Yocto Project `meta-intel-iot-security` Layer from the OpenEmbedded Layer Index:
  70
  71   - URI: https://github.com/01org/meta-intel-iot-security
  72   - Branch: "thud"
  73   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
  74     manifest file for the `AGL-repo` repository for revision
  75     information.
  76 -->
  77
  78 * Yocto Project `meta-security` Layer:
  79
  80   - URI: https://git.yoctoproject.org/cgit/cgit.cgi/meta-security
  81   - Branch: "master"
  82   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
  83     manifest file for the `AGL-repo` repository for revision
  84     information.
  85
  86 * AGL's `meta-app-framework` Layer Within the `meta-agl-extra` Layer:
  87
  88   - URI: https://gerrit.automotivelinux.org/gerrit/gitweb?p=AGL/meta-agl-extra.git
  89   - Branch: "master"
  90
  91 **The `agl-sota` Feature:**
  92
  93 * AGL's `meta-sota` Layer Within the `meta-agl-extra` Layer:
  94
  95   - URI: https://gerrit.automotivelinux.org/gerrit/gitweb?p=AGL/meta-agl-extra.git
  96   - Branch: "master"
  97
  98 * OpenEmbedded's `meta-openembedded` Layer:
  99
 100   - URI: https://github.com/openembedded/meta-openembedded
 101   - Branch: "thud"
 102   - Tested Revision: See the [`default.xml`](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)
 103     manifest file for the `AGL-repo` repository for revision
 104     information.
 105
 106     In particular, the `meta-openembedded` layer depends on the following
 107     sub-layers:
 108
 109       - `meta-filesystems`
 110       - `meta-ruby`
 111
 112 <!--
 113 * OpenEmbedded's `meta-rust` Layer:
 114
 115   - URI: https://github.com/meta-rust/meta-rust
 116   - Branch: "thud"
 117   - Tested Revision: See the `[default.xml](https://github.com/leon-anavi/AGL-repo/blob/master/default.xml)`
 118     manifest file for the `AGL-repo` repository for revision
 119     information.
 120 -->
 121
 122 **The `agl-netboot` Feature:**
 123
 124 * AGL's `meta-netboot` Layer Within the `meta-agl` Layer:
 125
 126   - URI: https://gerrit.automotivelinux.org/gerrit/gitweb?p=AGL/meta-agl.git
 127   - Branch: "master"
 128
 129
 130 ## Packagegroups
 131
 132 AGL DEMO Platform's
 133 [packagegroups](https://www.yoctoproject.org/docs/2.4.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
 134 consist of the following:
 135
 136 ### packagegroup-agl-demo-platform
 137
 138 This packagegroup is used for generating the `agl-demo-platform` image,
 139 which is the full image for the AGL distributions IVI profile.
 140 You can see the recipe (i.e. `agl-demo-platform.bb`) that installs
 141 the `packagegroup-agl-demo-platform` packagegroup
 142 [here](https://git.automotivelinux.org/AGL/meta-agl-demo/tree/recipes-platform/images/agl-demo-platform.bb).
 143
 144 As meta-agl's design of packagegroups, the `agl-demo-platform.bb` recipe installs
 145 the `packagegroup-agl-demo-platform` packagegroup, which pulls in the following
 146 packages of the DEMO applications:
 147
 148   * `agl-demo-platform`
 149   * `packagegroup-agl-image-minimal`
 150   * `packagegroup-agl-image-ivi`
 151   * `packagegroup-ivi-common-core`
 152   * `packagegroup-agl-demo-platform`
 153
 154 <!--
 155 ### packagegroup-agl-appfw*
 156
 157 These packagegroups contain packages for the AGL distribution's
 158 Application Framework.
 159 Subsystem should maintain `packagegroup-agl-appfw-[subsystem].bb`, which
 160 should hold sufficient packages for the Application Framework.
 161
 162 Subsystems also can maintain their own packagegroups using appropriate
 163 `recipes-*/`.
 164 For example, Qt5 has two packagegroups in `meta-agl-demo`:
 165 `packagegroup-agl-appfw-native-qt5` and `packagegroup-agl-demo-qt-examples`,
 166 which are under `recipes-qt/`.
 167
 168 The `packagegroup-agl-appfw-native-qt5` is included by
 169 `packagegroup-agl-appfw-native` because Qt5 belongs to native application
 170 framework of AGL Distro.
 171
 172 Because the `packagegroup-agl-demo-qt-examples` is not mandatory for
 173 the AGL Application Framework and the AGL DEMO, the packagegroup is added
 174 to the layer's `local.conf` file only when needed.
 175 -->