Custom Recipe
.bb Dosyası

SUMMARY = "Minimal C uygulaması örneği"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://COPYING;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "git://github.com/example/helloworld.git;protocol=https;branch=main"
SRCREV = "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
S = "${WORKDIR}/git"

do_compile() {
    oe_runmake
}

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

  do_fetch      → Kaynak kodunu indir (DL_DIR'a)
  do_unpack     → WORKDIR'a aç
  do_patch      → Patch'leri uygula
  do_configure  → Build sistemini yapılandır (cmake, configure, ...)
  do_compile    → Derle (make, ninja, ...)
  do_install    → ${D} (destdir) içine kur
  do_package    → Dosyaları PACKAGES değişkenine göre böl
  do_packagedata→ Paket metadata'yı kaydet
  do_package_write_ipk/deb/rpm → Paket dosyasını yaz
    

# Kaynak indirilip açıldıktan sonra COPYING dosyasının MD5'ini hesapla
md5sum COPYING
# 0835ade698e0bcf8506ecda2f7b4f302  COPYING

# Recipe'de kullanımı
LIC_FILES_CHKSUM = "file://COPYING;md5=0835ade698e0bcf8506ecda2f7b4f302"

# Birden fazla lisans dosyası
LIC_FILES_CHKSUM = "file://LICENSE.md5;md5=... \
                     file://src/foo/LICENSE;md5=..."

# HTTPS tarball — en yaygın kullanım
SRC_URI = "https://ftp.gnu.org/pub/gnu/wget/wget-${PV}.tar.gz"
SRC_URI[md5sum] = "abc123..."
SRC_URI[sha256sum] = "def456..."

# Git deposu
SRC_URI = "git://github.com/user/repo.git;protocol=https;branch=main"
SRCREV = "a1b2c3d4e5f6..."    # tam commit SHA — güvenli
S = "${WORKDIR}/git"

# Git — tag ile
SRC_URI = "git://github.com/user/repo.git;protocol=https;tag=v${PV}"

# Yerel dosya (layer içindeki)
SRC_URI += "file://my-config.conf"

# Patch dosyası — do_patch aşamasında otomatik uygulanır
SRC_URI += "file://0001-fix-segfault.patch \
             file://0002-add-feature.patch"

# Birden fazla kaynak
SRC_URI = "https://example.com/myapp-${PV}.tar.gz \
            file://myapp.service \
            file://0001-fix-crash.patch"

# Kaynak dizine gir (BitBake workspace veya git clone)
cd /tmp/myapp-src

# Değişiklik yap
vim src/main.c

# git ile patch üret
git add -A
git commit -m "fix: NULL pointer dereference in init path"
git format-patch HEAD~1 -o /home/user/meta-myproduct/recipes-apps/myapp/myapp/
# Oluşur: 0001-fix-NULL-pointer-dereference-in-init-path.patch

do_compile() {
    # oe_runmake: cross-compile ortam değişkenleriyle make çalıştırır
    # CC, LD, AR, STRIP, CFLAGS, LDFLAGS otomatik ayarlıdır
    oe_runmake

    # Belirli bir target
    oe_runmake all

    # Ek parametrelerle
    oe_runmake "EXTRA_CFLAGS=-DDEBUG_BUILD"
}

do_install() {
    # Önce hedef dizinleri oluştur
    install -d ${D}${bindir}
    install -d ${D}${sysconfdir}/myapp
    install -d ${D}${localstatedir}/lib/myapp

    # Binary kur — çalıştırılabilir (0755)
    install -m 0755 ${B}/myapp ${D}${bindir}/myapp

    # Config dosyası kur — sadece okuma (0644)
    install -m 0644 ${WORKDIR}/myapp.conf ${D}${sysconfdir}/myapp/

    # Kütüphane kur
    install -d ${D}${libdir}
    install -m 0755 ${B}/libmyapp.so.1.0 ${D}${libdir}/
    ln -sf libmyapp.so.1.0 ${D}${libdir}/libmyapp.so.1
    ln -sf libmyapp.so.1   ${D}${libdir}/libmyapp.so

    # Header dosyaları kur
    install -d ${D}${includedir}/myapp
    install -m 0644 include/*.h ${D}${includedir}/myapp/
}

# RDEPENDS: Zorunlu runtime bağımlılıklar
# Paket kurulduğunda bu bağımlılıklar da kurulur
RDEPENDS:${PN} = "bash libssl3 libcurl4"

# RRECOMMENDS: Önerilen runtime bağımlılıklar
# Kurulmasa da paket çalışabilir, ama tavsiye edilir
RRECOMMENDS:${PN} = "ca-certificates"

# Sürüm kısıtlı bağımlılık
RDEPENDS:${PN} = "openssl (>= 3.0)"

# PROVIDES: Bu paketin sağladığı sanal paketler
PROVIDES += "virtual/webserver"

# RPROVIDES: Runtime'da sağlanan sanal paket adları
RPROVIDES:${PN} = "virtual/webserver"

# virtual/ ile sağlayıcı seçimi
PREFERRED_PROVIDER_virtual/webserver = "nginx"

# Üretilecek paket listesi
PACKAGES = "${PN}-staticdev ${PN}-dev ${PN}-doc ${PN}-dbg ${PN}"

# Her paketin dosya desenleri
FILES:${PN} = "${bindir}/* ${libdir}/libmyapp.so.*"
FILES:${PN}-dev = "${includedir}/* ${libdir}/libmyapp.so ${libdir}/pkgconfig/*"
FILES:${PN}-staticdev = "${libdir}/libmyapp.a"
FILES:${PN}-doc = "${docdir}/* ${mandir}/*"

# -dev paketi için runtime bağımlılık
RDEPENDS:${PN}-dev = "${PN}"

# Bazı paketleri IMAGE_INSTALL'dan çıkarmak için ALLOW_EMPTY
ALLOW_EMPTY:${PN}-doc = "1"

inherit cmake systemd pkgconfig useradd

# CMake ek argümanları
EXTRA_OECMAKE = "-DCMAKE_BUILD_TYPE=Release \
                  -DENABLE_TESTS=OFF \
                  -DINSTALL_SYSTEMD_UNIT=ON"

# systemd unit dosyaları
SYSTEMD_SERVICE:${PN} = "myapp.service myapp-watchdog.service"
SYSTEMD_AUTO_ENABLE:${PN} = "enable"

# useradd: sistem kullanıcısı oluştur
USERADD_PACKAGES = "${PN}"
USERADD_PARAM:${PN} = "-r -s /sbin/nologin -d /var/lib/myapp myapp"

inherit autotools pkgconfig

# configure ek argümanları
EXTRA_OECONF = "--disable-static \
                  --enable-shared \
                  --with-openssl=${STAGING_DIR_TARGET}"

# autotools genellikle do_configure ve do_compile'ı otomatik halleder
# Sadece do_install'ı özelleştirmen gerekirse override edebilirsin

# Aynı recipe'den üç varyant üret:
#   myapp           — hedef sistem için (cross-compiled)
#   myapp-native    — build host'ta çalışacak araç
#   nativesdk-myapp — eSDK içinde host'ta çalışacak araç
BBCLASSEXTEND = "native nativesdk"

# Kullanım: başka recipe'de native aracı bağımlılık olarak belirt
DEPENDS += "myapp-native"

# Sadece native build'de ekstra bağımlılık
DEPENDS:class-native = ""

# Native build için farklı EXTRA_OECMAKE
EXTRA_OECMAKE:class-native = "-DBUILD_TOOLS_ONLY=ON"
EXTRA_OECMAKE:class-nativesdk = "-DBUILD_TOOLS_ONLY=ON"

# Cross (hedef) build için tam özellik seti
EXTRA_OECMAKE = "-DCMAKE_BUILD_TYPE=Release"

mydaemon/
├── CMakeLists.txt
├── COPYING                ← MIT lisansı
├── include/
│   └── mydaemon.h
├── src/
│   └── main.c
└── dist/
    └── mydaemon.service.in   ← systemd template

SUMMARY = "MyProduct arka plan daemon'ı"
DESCRIPTION = "Sensör verisi toplayan ve MQTT'ye aktaran C daemon"
HOMEPAGE = "https://git.mycompany.com/mydaemon"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://COPYING;md5=5d9e6b2c1f7a3b8d4e0c2f9a1b3c7e5d"

SRC_URI = "git://git.mycompany.com/mydaemon.git;protocol=https;branch=main \
            file://mydaemon.conf \
            file://0001-fix-signal-handler.patch"
SRCREV = "d3a1f2c4b5e6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
PV = "1.2.0+git${SRCPV}"
S = "${WORKDIR}/git"

# Build-time bağımlılıklar
DEPENDS = "openssl mosquitto libgpiod"

# Runtime bağımlılıklar
RDEPENDS:${PN} = "libssl3 libmosquitto1 libgpiod2 bash"

# Class inheritance
inherit cmake systemd pkgconfig useradd

# CMake argümanları
EXTRA_OECMAKE = "\
    -DCMAKE_BUILD_TYPE=Release \
    -DENABLE_MQTT=ON \
    -DENABLE_GPIO=ON \
    -DINSTALL_SYSTEMD=ON \
    -DDAEMON_USER=mydaemon \
    "

# systemd entegrasyonu
SYSTEMD_SERVICE:${PN} = "mydaemon.service"
SYSTEMD_AUTO_ENABLE:${PN} = "enable"

# Sistem kullanıcısı: /var/lib/mydaemon home dizini, login shell yok
USERADD_PACKAGES = "${PN}"
USERADD_PARAM:${PN} = "-r -s /sbin/nologin -d /var/lib/mydaemon -m mydaemon"

# Paket bölme
PACKAGES =+ "${PN}-dev"
FILES:${PN} = "${bindir}/mydaemon \
               ${sysconfdir}/mydaemon \
               ${systemd_system_unitdir}/mydaemon.service \
               ${localstatedir}/lib/mydaemon"
FILES:${PN}-dev = "${includedir}/mydaemon.h \
                   ${libdir}/pkgconfig/mydaemon.pc"

do_install:append() {
    # Konfigürasyon dizini ve dosyası
    install -d ${D}${sysconfdir}/mydaemon
    install -m 0640 ${WORKDIR}/mydaemon.conf \
        ${D}${sysconfdir}/mydaemon/mydaemon.conf
    # Çalışma zamanı veri dizini
    install -d ${D}${localstatedir}/lib/mydaemon
    chown -R mydaemon:mydaemon ${D}${localstatedir}/lib/mydaemon || true
}

meta-myproduct/recipes-apps/mydaemon/
├── mydaemon_1.2.0.bb
└── mydaemon/
    ├── mydaemon.conf                        ← SRC_URI file://
    └── 0001-fix-signal-handler.patch        ← SRC_URI file://

# Recipe'yi derle
bitbake mydaemon

# Üretilen paket dosyalarını listele
find tmp/deploy/ipk -name "mydaemon*.ipk"
# tmp/deploy/ipk/cortexa53/mydaemon_1.2.0+git..._cortexa53.ipk
# tmp/deploy/ipk/cortexa53/mydaemon-dev_1.2.0+git..._cortexa53.ipk

# Paketin içeriğini görüntüle
bitbake -e mydaemon | grep '^FILES'

# do_install çıktısını kontrol et
find tmp/work/cortexa53-poky-linux/mydaemon/image/ -type f