【実践】Yoctoでカスタムレシピを作成する方法｜.bbファイルの書き方完全ガイド

hello-world_1.0.bb      # hello-world バージョン1.0
myapp_2.3.1.bb          # myapp バージョン2.3.1
busybox_1.36.1.bb       # busybox バージョン1.36.1

# hello-world_1.0.bb

# ===== メタデータ =====
SUMMARY = "Hello World サンプル"
DESCRIPTION = "Yoctoレシピの学習用サンプルアプリケーション"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

# ===== ソースコードの取得 =====
SRC_URI = "file://hello.c"

# ===== ビルドディレクトリの設定 =====
S = "${WORKDIR}"

# ===== ビルド処理 =====
do_compile() {
    ${CC} ${CFLAGS} ${LDFLAGS} -o hello hello.c
}

# ===== インストール処理 =====
do_install() {
    install -d ${D}${bindir}
    install -m 0755 hello ${D}${bindir}
}

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

# 新しいレイヤーを作成
$ cd ..
$ bitbake-layers create-layer meta-mylayer

# レイヤーをビルドに追加
$ cd build
$ bitbake-layers add-layer ../meta-mylayer

# 確認
$ bitbake-layers show-layers
layer                 path
=========================================================
meta                  /home/user/yocto/poky/meta
meta-poky             /home/user/yocto/poky/meta-poky
meta-yocto-bsp        /home/user/yocto/poky/meta-yocto-bsp
meta-mylayer          /home/user/yocto/meta-mylayer

# レシピ用ディレクトリを作成
$ mkdir -p ../meta-mylayer/recipes-example/hello-world/files

# ディレクトリ構造
# meta-mylayer/
# ├── conf/
# │   └── layer.conf
# ├── COPYING.MIT
# ├── README
# └── recipes-example/
#     └── hello-world/
#         ├── hello-world_1.0.bb    ← レシピファイル
#         └── files/
#             └── hello.c           ← ソースコード

// files/hello.c
#include <stdio.h>

int main(void) {
    printf("Hello from Yocto!\n");
    printf("This app was built with a custom recipe.\n");
    return 0;
}

# hello-world_1.0.bb

SUMMARY = "Hello World - Yoctoレシピ学習用サンプル"
DESCRIPTION = "Yoctoでカスタムレシピを作成する方法を学ぶためのサンプルアプリケーション"
AUTHOR = "Your Name <your@email.com>"
HOMEPAGE = "https://example.com"

# ライセンス設定（MITライセンスを使用）
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

# ソースコードの取得元（filesディレクトリから）
SRC_URI = "file://hello.c"

# ソースが展開されるディレクトリ
S = "${WORKDIR}"

# コンパイル処理
do_compile() {
    ${CC} ${CFLAGS} ${LDFLAGS} -o hello hello.c
}

# インストール処理
do_install() {
    # /usr/bin ディレクトリを作成
    install -d ${D}${bindir}
    # 実行ファイルをインストール（パーミッション 0755）
    install -m 0755 hello ${D}${bindir}
}

# 個別にレシピをビルド
$ bitbake hello-world

# ビルド成功のメッセージ
NOTE: Tasks Summary: Attempted 123 tasks of which 120 didn't need to be rerun

# conf/local.conf に追加
IMAGE_INSTALL:append = " hello-world"

# イメージを再ビルド
$ bitbake core-image-minimal

# QEMUで起動
$ runqemu qemux86-64 nographic

# ログイン後、helloコマンドを実行
root@qemux86-64:~# hello
Hello from Yocto!
This app was built with a custom recipe.

# nlohmann-json_3.11.3.bb

SUMMARY = "JSON for Modern C++"
DESCRIPTION = "Header-only JSON library for C++"
HOMEPAGE = "https://github.com/nlohmann/json"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://LICENSE.MIT;md5=f5f7c71504da070bcf4f090205ce1080"

# GitHubからソースを取得
SRC_URI = "git://github.com/nlohmann/json.git;protocol=https;branch=master"

# 特定のコミットを指定（再現性のため必須！）
SRCREV = "9cca280a4d0ccf0c08f47a99aa71d1b0e52f8d03"

# ソースの展開先（gitクローン時は ${WORKDIR}/git）
S = "${WORKDIR}/git"

# CMakeを使用
inherit cmake

# ヘッダーオンリーなのでテストはスキップ
EXTRA_OECMAKE = "-DJSON_BuildTests=OFF"

# myapp-cmake_1.0.bb
SUMMARY = "My CMake App"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "git://github.com/user/myapp.git;protocol=https;branch=main"
SRCREV = "abc123def456..."
S = "${WORKDIR}/git"

# CMakeクラスを継承するだけでビルドが自動化される
inherit cmake

# CMakeオプションを指定（任意）
EXTRA_OECMAKE = "-DBUILD_TESTS=OFF -DCMAKE_BUILD_TYPE=Release"

# myapp-autotools_1.0.bb
SUMMARY = "My Autotools App"
LICENSE = "GPLv2"
LIC_FILES_CHKSUM = "file://COPYING;md5=..."

SRC_URI = "https://example.com/myapp-1.0.tar.gz"
SRC_URI[md5sum] = "abc123..."
SRC_URI[sha256sum] = "def456..."

inherit autotools

# configureオプション（任意）
EXTRA_OECONF = "--disable-docs"

# myservice_1.0.bb
SUMMARY = "My System Service"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "file://myservice.c \
           file://myservice.service"

S = "${WORKDIR}"

inherit systemd

# systemdサービスファイルの指定
SYSTEMD_SERVICE:${PN} = "myservice.service"
SYSTEMD_AUTO_ENABLE = "enable"

do_compile() {
    ${CC} ${CFLAGS} ${LDFLAGS} -o myservice myservice.c
}

do_install() {
    install -d ${D}${bindir}
    install -m 0755 myservice ${D}${bindir}

    # systemdサービスファイルをインストール
    install -d ${D}${systemd_system_unitdir}
    install -m 0644 myservice.service ${D}${systemd_system_unitdir}
}

ERROR: License checksum mismatch...

$ md5sum LICENSE

ERROR: Fetcher failure: Unable to find file...

ERROR: Nothing PROVIDES 'hello-world'

$ bitbake-layers show-layers

ERROR: SRC_URI checksum mismatch...

$ sha256sum ダウンロードしたファイル.tar.gz