【図解】Yoctoレイヤーの作成と追加方法｜meta-xxxの仕組みを理解する

meta-mylayer/
├── conf/
│   └── layer.conf          # レイヤーの設定ファイル（必須）
├── COPYING.MIT             # ライセンスファイル
├── README                  # レイヤーの説明
├── recipes-bsp/            # BSP関連レシピ
├── recipes-core/           # コア機能のレシピ
├── recipes-example/        # サンプルレシピ
│   └── myapp/
│       ├── myapp_1.0.bb
│       └── files/
├── recipes-kernel/         # カーネル関連
├── recipes-graphics/       # グラフィック関連
└── classes/                # 共通クラス（.bbclass）

# conf/layer.conf

# レイヤーのパスをBBPATHに追加
BBPATH .= ":${LAYERDIR}"

# レシピを検索するパス（*は任意の階層）
BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
            ${LAYERDIR}/recipes-*/*/*.bbappend"

# このレイヤーのコレクション名（一意である必要がある）
BBFILE_COLLECTIONS += "meta-mylayer"
BBFILE_PATTERN_meta-mylayer = "^${LAYERDIR}/"

# レイヤーの優先度（高いほど優先される。6〜10が一般的）
BBFILE_PRIORITY_meta-mylayer = "6"

# レイヤーの互換性（対応するYoctoバージョン）
LAYERSERIES_COMPAT_meta-mylayer = "scarthgap styhead"

# 依存レイヤー（このレイヤーが必要とする他のレイヤー）
LAYERDEPENDS_meta-mylayer = "core"

# ビルド環境に入る
$ cd ~/yocto/poky
$ source oe-init-build-env build

# Pokyの親ディレクトリに移動してレイヤーを作成
$ cd ..
$ bitbake-layers create-layer meta-myproject

# 作成されたファイルを確認
$ ls meta-myproject/
conf  COPYING.MIT  README  recipes-example

$ cat meta-myproject/conf/layer.conf
# layer.confの内容が表示される

# ディレクトリ構造を作成
$ mkdir -p meta-myproject/conf
$ mkdir -p meta-myproject/recipes-example/myapp

# layer.confを作成
$ cat > meta-myproject/conf/layer.conf << 'EOF'
BBPATH .= ":${LAYERDIR}"
BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
            ${LAYERDIR}/recipes-*/*/*.bbappend"
BBFILE_COLLECTIONS += "meta-myproject"
BBFILE_PATTERN_meta-myproject = "^${LAYERDIR}/"
BBFILE_PRIORITY_meta-myproject = "6"
LAYERSERIES_COMPAT_meta-myproject = "scarthgap styhead"
EOF

# 方法1: コマンドで追加（推奨）
$ cd ~/yocto/poky
$ source oe-init-build-env build
$ bitbake-layers add-layer ../meta-myproject

# 方法2: 直接編集
$ nano conf/bblayers.conf

# conf/bblayers.conf

BBLAYERS ?= " \
  /home/user/yocto/poky/meta \
  /home/user/yocto/poky/meta-poky \
  /home/user/yocto/poky/meta-yocto-bsp \
  /home/user/yocto/meta-myproject \
  "

# 現在のレイヤー一覧を確認
$ bitbake-layers show-layers

layer                 path                                      priority
==========================================================================
meta                  /home/user/yocto/poky/meta                 5
meta-poky             /home/user/yocto/poky/meta-poky            5
meta-yocto-bsp        /home/user/yocto/poky/meta-yocto-bsp       5
meta-myproject        /home/user/yocto/meta-myproject            6

# レイヤーをビルドから削除（ファイル自体は削除しない）
$ bitbake-layers remove-layer meta-myproject

# Pokyと同じディレクトリにクローン
$ cd ~/yocto
$ git clone -b styhead git://git.yoctoproject.org/meta-raspberrypi

# meta-openembeddedも必要（meta-raspberrypiが依存）
$ git clone -b styhead git://git.openembedded.org/meta-openembedded

$ cd ~/yocto/poky
$ source oe-init-build-env build

# meta-oe（meta-openembeddedの基本レイヤー）を追加
$ bitbake-layers add-layer ../meta-openembedded/meta-oe

# meta-raspberrypiを追加
$ bitbake-layers add-layer ../meta-raspberrypi

# 追加されたか確認
$ bitbake-layers show-layers

# conf/local.confを編集
$ nano conf/local.conf

# MACHINEをRaspberry Pi向けに変更
MACHINE = "raspberrypi4-64"

# 利用可能なマシン一覧
# raspberrypi      - Raspberry Pi 1
# raspberrypi2     - Raspberry Pi 2
# raspberrypi3     - Raspberry Pi 3
# raspberrypi3-64  - Raspberry Pi 3 (64bit)
# raspberrypi4     - Raspberry Pi 4
# raspberrypi4-64  - Raspberry Pi 4 (64bit)
# raspberrypi5     - Raspberry Pi 5

# 例：busyboxにパッチを当てる
# meta-mylayer/recipes-core/busybox/busybox_%.bbappend

# パッチファイルを追加
FILESEXTRAPATHS:prepend := "${THISDIR}/files:"
SRC_URI += "file://my-fix.patch"

# 設定を追加
EXTRA_OECONF += "--enable-feature-x"

ERROR: Layer xxx is not compatible with the current version

LAYERSERIES_COMPAT_meta-mylayer = "scarthgap styhead"

ERROR: Layer xxx depends on layer xxx