レシピの作り方入門

1. レシピの作り方入門岩松信洋メール: iwamatsu@nigauri.org Twitter: @iwamatsu

2. アジェンダ 1.自己紹介 2. Yoctoのビルド概要 3.レシピの作り方 4.まとめ

3. 自己紹介

4. 自己紹介 ● 名前: 岩松信洋（いわまつのぶひろ） ● 大抵のアカウントは iwamatsu ● kuma dasu さんの紹介で発表することになりました。 ● 普段は Linux kernel、UBoot 、BSPの開発 ● UBoot SH/rmobile Maintainer ● Debian Project Official Developer

5. Debian からの刺客！？　　　　　　　　　　　　　　　　　　　　　　　ｸﾙｯ .　　　　　　　　　　　　　　　　　　　　　ﾊ,,ﾊ　　　ミ　＿　ドスッ　　　 /1べ:;:;:r─‐-!　　　　　　　　（ﾟωﾟ）彡―─┴┴─― .　　 /iｨ.:.:.:.:ヾ|断だ!＼　　　　　　　/　　　つ　お断りし／　　　　　　ﾊ,,ﾊ　　 /ﾍレj_.:.:.lるが!　　＼　　　　～′　/´　└―─┬／　　　　　　（ﾟωﾟ）　お断りします .　 /.:`ｿ　=三_`ｙ‐i:!　　　＼　　　　∪ ∪　　　　　／　　　　　　　／　　　＼　/.:::i゛:.. ｀ヾﾆﾉ　 j!　　　　 .＼　　　　　　　　　　／　　　　　　((⊂ 　）　ﾉ＼つ)) ./;;i::rミ､　　 ;:'　 '!　　　　　　 . ＼∧∧∧∧∧D／　　　　　　　　　　（＿⌒ヽ丶iゝ｀`' 　 ,:'　 ,t'!　　　　　　＜　　　　　お　e＞　　　　　　　　　　ヽ　ﾍ　} 　　｀丶､　／rj!　　　　　　　　＜　のし断　ｂ＞　　　　　 ε≡Ξ　ﾉノ｀J ────────────＜　予まわ　 i＞──────────── 　　　　　　　　　ﾊ,,ﾊ　　お断り＜.　感すり　 a＞　　　　　　　　　＿＿＿＿＿_ 　　　　　　　　（ﾟωﾟ )　　します＜.　!!　　　　 n ＞　　　　　　　　/　　 ./おだ ,! 　　　　　　 __〃｀ヽ〈＿　　　　　／∨∨∨∨＼　　　　　　　 /　　　! 断が,! 　　　γ´⌒´-－ヾｖーヽ⌒ヽ　／お断りします　＼　　　　　/ ,ﾊ,,ﾊ ! り　　,! 　　／⌒　ｨ　　　｀ｉ´　　）; ／.　　　　　ﾊ,,ﾊ　　　＼　　　/（ﾟωﾟ )｀ー‐,! 　 /　　　ﾉ＾､＿__￥＿_ ／　　　　　　　( ﾟωﾟ ) 　　　＼　　｀ヽ､　　　＼_,! 　 !　　,,,ノ爻＼_　_人　／　　　　　　　　.(|　y |) 　　　　　＼　　　｀ヽ､ﾉ＼,!

6. Yocto なんてぶっ潰してやるぜ！

7. というわけではありませんので、安心してください。 Yocto なんてぶっ潰してやるぜ！

8. Yoctoのビルド概要

9. ビルド概要レシピ bitbake イメージ

10. ビルド概要/レシピとは？ ● ソフトウェアのビルド、インストール方法が書かれたテキストファイル ● シェルスクリプト + Python を混ぜて記述 ● ソース取得からパッケージ化までの動作を記述 ● 料理のレシピと同じようなもの

11. ビルド概要レシピ coreimageminimal bitbake イメージ

12. ビルド概要レシピ bitbake coreimageminimal 依存 busybox eglibc …… イメージ

13. ビルド概要レシピ bitbake coreimageminimal 依存 busybox eglibc 依存 gcccross binutilscross …… …… イメージ

14. ビルド概要レシピ bitbake coreimageminimal 依存 busybox eglibc 依存 gcccross binutilscross …… …… 依存 gettextnative zlibnative …… イメージ

15. ビルド概要レシピ bitbake イメージ coreimageminimal 依存 busybox eglibc 依存 gcccross binutilscross …… …… 依存 gettextnative zlibnative …… ビルド gettextnative zlibnative ……

16. ビルド概要レシピ bitbake イメージ coreimageminimal 依存 busybox eglibc 依存 gcccross binutilscross …… …… ビルド gcccross 依存 gettextnative zlibnative binutilscross …… ビルド依存 …… ビルド gettextnative zlibnative ……

17. ビルド概要レシピ bitbake イメージ coreimageminimal 依存 busybox eglibc 依存 gcccross binutilscross …… …… ビルドビルド busybox gcccross 依存 gettextnative zlibnative eglibc …… ビルド依存 binutilscross …… ビルド依存 …… ビルド gettextnative zlibnative ……

18. ビルド概要レシピ bitbake インストール coreimageminimal イメージ coreimageminimal.bz2 zImage 依存 busybox eglibc 依存 gcccross binutilscross …… …… ビルドビルド busybox gcccross 依存 gettextnative zlibnative eglibc …… ビルド依存 binutilscross …… ビルド依存 …… ビルド gettextnative zlibnative ……

19. ビルド概要 *.conf レシピ bitbake インストール coreimageminimal イメージ coreimageminimal.bz2 zImage 依存 busybox eglibc 依存 gcccross binutilscross …… …… ビルドビルド busybox gcccross 依存 gettextnative zlibnative eglibc …… ビルド依存 binutilscross …… ビルド依存 …… ビルド gettextnative zlibnative ……

20. ビルド概要/レイヤー

21. ビルド概要/レイヤー poky/meta busybox linuxyocto

22. ビルド概要/レイヤー poky/metayocto busybox poky/meta busybox linuxyocto

23. ビルド概要/レイヤー linuxyocto metafoo poky/metayocto busybox poky/meta busybox linuxyocto myprogram

24. ビルド概要/レイヤー linuxyocto metafoo poky/metayocto busybox poky/meta busybox myprogram linuxyocto ビルドディレクトリ/conf/bblayers.conf で定義

25. ビルド概要/レイヤー linuxyocto metafoo poky/metayocto busybox poky/meta busybox myprogram linuxyocto ビルドディレクトリ/conf/bblayers.conf で定義

26. ビルド概要/レイヤー linuxyocto metafoo poky/metayocto myprogram busybox 機能上書き poky/meta busybox linuxyocto ビルドディレクトリ/conf/bblayers.conf で定義

27. ビルド概要/レイヤー linuxyocto metafoo poky/metayocto busybox myprogram 機能追加機能上書き poky/meta busybox linuxyocto ビルドディレクトリ/conf/bblayers.conf で定義

28. ビルド概要/レイヤー linuxyocto metafoo poky/metayocto busybox myprogram 機能追加機能上書き poky/meta busybox linuxyocto ビルドディレクトリ/conf/bblayers.conf で定義最終的なレシピ busybox linuxyocto myprogram

29. ビルド概要/レイヤー linuxyocto metafoo poky/metayocto busybox myprogram 機能追加機能上書き poky/meta busybox linuxyocto ビルドディレクトリ/conf/bblayers.conf で定義最終的なレシピ busybox linuxyocto myprogram

32. レシピの作り方

33. レシピの作り方 ● レシピのひな形を作成 ● レシピ説明、セクション名の定義 ● ライセンス定義 ● ソースファイル定義 ● タスク定義 ● その他変数

34. レシピの作り方 ● yoctolayer create でひな形作成 $ ./poky/scripts/yoctolayer create myrecipes

35. レシピの作り方 ● yoctolayer create でひな形作成 $ ./poky/scripts/yoctolayer create myrecipes Please enter the layer priority you'd like to use for the layer: [default: 6] 6 Would you like to have an example recipe created? (y/n) [default: n] y Please enter the name you'd like to use for your example recipe: [default: example] Would you like to have an example bbappend file created? (y/n) [default: n] n New layer created in metamyrecipes. Don't forget to add it to your BBLAYERS (for details see metamyrecipesREADME). カレントディレクトリにmetamyrecipes ディレクトリが作成され、そこにひな形が作成される

37. example_0.1.bb レシピ名: example バージョン: 0.1 として処理される。レシピ名とバージョンは _ （アンダースコア）で区切る。

38. example_0.1.bb DESCRIPTION = "Simple helloworld application" SECTION = "examples" LICENSE = "MIT" LIC_FILES_CHKSUM = "file://$ {COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302" PR = "r0" SRC_URI = "file://helloworld.c" S = "${WORKDIR}" do_compile() { ${CC} helloworld.c o helloworld } do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} }

39. レシピ説明、セクション名の定義 DESCRIPTION = "Simple helloworld application" SECTION = "examples" LICENSE = "MIT" LIC_FILES_CHKSUM = "file://$ {COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302" PR = "r0" SRC_URI = "file://helloworld.c" S = "${WORKDIR}" do_compile() { ${CC} helloworld.c o helloworld } do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} }

40. レシピ説明、セクション名の定義 ● DESCRIPTION: レシピの説明簡単な説明は SUMMARY を使う ● SECTION: レシピが所属するセクション一応ビルド時にチェックされる（meta/classes/oelint.bbclass）

41. ライセンス定義 DESCRIPTION = "Simple helloworld application" SECTION = "examples" LICENSE = "MIT" LIC_FILES_CHKSUM = "file://$ {COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302" PR = "r0" SRC_URI = "file://helloworld.c" S = "${WORKDIR}" do_compile() { ${CC} helloworld.c o helloworld } do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} }

42. ライセンス定義 ● LICENSE: ライセンス名 ● LIC_FILES_CHKSUM: ファイル名とmd5 COPYING 、LICENSE ファイルのパスファイルのライセンスヘッダ部を参照する場合もある file://ファイル名;beginline=5;endline=20;md5=チェックサム値（指　定されたファイルの5行目から20行目にあるライセンスヘッダのmd5　　チェックサムを確認する。） COMMON_LICENSE_DIRはmeta/files/commonlicenses/ がデフォルト値

43. ソースファイル定義 DESCRIPTION = "Simple helloworld application" SECTION = "examples" LICENSE = "MIT" LIC_FILES_CHKSUM = "file://$ {COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302" PR = "r0" SRC_URI = "file://helloworld.c" S = "${WORKDIR}" do_compile() { ${CC} helloworld.c o helloworld } do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} }

44. ソースファイル定義 ● SRC_URI: ソースファイルの一覧ソースファイルはビルドに必要なパッチや設定ファイルを含むスペースで区切る ● 様々なプロトコルをサポート file、git、svn、http、etc...

45. タスク定義 DESCRIPTION = "Simple helloworld application" SECTION = "examples" LICENSE = "MIT" LIC_FILES_CHKSUM = "file://$ {COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302" PR = "r0" SRC_URI = "file://helloworld.c" S = "${WORKDIR}" do_compile() { ${CC} helloworld.c o helloworld } do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} }

46. タスク定義 ● Bitbake によってビルド時に実行される処理 ● 基本タスクと実行される順番が決まっている 1. do_fetch: SRC_URI で指定された場所からソースコードをダウンロード 2. do_unpack: ソースコードを展開 3. do_patch: ローカルパッチを適用 4. do_configure: configureを実行 5. do_compile: makeを実行 6. do_install: make install を実行 7. do_populate_sysroot: sysroot にインストール 8. do_package: パッケージ化用のディレクトリにインストール 9. do_package_write: パッケージの作成（ipk, deb, rpm） 10. do_build: ビルド終了用のタスク

47. タスク定義 ● Bitbake によってビルド時に実行される処理 ● 基本タスクと実行される順番が決まっている 1. do_fetch: SRC_URI で指定された場所からソースコードをダウンロード 2. do_unpack: ソースコードを展開 3. do_patch: ローカルパッチを適用 4. do_configure: configureを実行 5. do_compile: makeを実行実際に実行されるタスクは bitbake c listtasks レシピ名で確認できる 6. do_install: make install を実行 7. do_populate_sysroot: sysroot にインストール 8. do_package: パッケージ化用のディレクトリにインストール 9. do_package_write: パッケージの作成（ipk, deb, rpm） 10. do_build: ビルド終了用のタスク

48. タスク定義 $ bitbake c listtasks busybox do_fetchall do_devshell do_package_write_ipk do_cleansstate do_build do_configure do_cleanall do_populate_lic do_package_write do_populate_sysroot do_package_setscene do_menuconfig do_populate_lic_setscene do_packagedata_setscene do_patch do_packagedata do_listtasks do_checkuriall do_compile do_fetch do_checkuri do_clean do_package_write_ipk_setscene do_package do_unpack do_install do_populate_sysroot_setscene

49. タスク定義 1. do_fetch: SRC_URI で指定された場所からソースコードをダウンロード 2. do_unpack: ソースコードを展開 3. do_patch: ローカルパッチを適用 4. do_configure: configureを実行 5. do_compile: makeを実行 6. do_install: make install を実行 7. do_populate_sysroot: sysroot にインストール 8. do_package: パッケージ化用のディレクトリにインストール 9. do_package_write: パッケージの作成（ipk, deb, rpm） 10. do_build: ビルド終了用のタスク

50. タスク定義 1. do_fetch: SRC_URI で指定された場所からソースコードをダウンロード 2. do_unpack: ソースコードを展開 3. do_patch: ローカルパッチを適用 4. do_configure: configureを実行 ● 5. do_compile: makeを実行 ● ● 6. do_install: make install を実行タスクは上書き、追加ができるタスク間には依存関係がある自作のタスクを定義可能できる 7. do_populate_sysroot: sysroot にインストール 8. do_package: パッケージ化用のディレクトリにインストール 9. do_package_write: パッケージの作成（ipk, deb, rpm） 10. do_build: ビルド終了用のタスク

51. タスク定義の上書き、追加 ● タスクの上書き do_configure() { echo ''Override do_configure'' } ● タスクの追加 do_compile_append() { touch ${S}/test } _append はタスクの処理後に追加する。タスク処理前は_prependをつける

52. タスク定義の依存関係と作成 ● タスク間には依存関係がある addtask package before do_build after do_install package タスクをbuildの前、installの後に実行する ● 自作のタスクを定義できる addtask mytask before do_patch after do_unpack do_mytask() { ...... } mytask タスクをpatchの前、unpackの後に実行する用設定

53. その他変数 DESCRIPTION = "Simple helloworld application" SECTION = "examples" LICENSE = "MIT" LIC_FILES_CHKSUM = "file://$ {COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302" PR = "r0" SRC_URI = "file://helloworld.c" S = "${WORKDIR}" do_compile() { ${CC} helloworld.c o helloworld } do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} }

54. その他変数 PR: レシピのリビジョン。レシピを更新した時にインクリメントする。初めて作った時は必要ない。 ● S: ソースディレクトリ。展開済みのソースディレクトリ ● WORKDIR: レシピの作業が行われるディレクトリ。 ● D: インストール先ディレクトリ ● bindir: /usr/bin ●

55. その他変数 PN: レシピ（パッケージ）名 ● PV: レシピ（パッケージ）のバージョン ● DEPENDS: ビルドに必要なレシピ ● DEPENDS = ''zlib openssl'' RDEPENDS: 実行に必要なパッケージ(or レシピ） ● EXTRA_OECONF: configure実行時に渡すオプション ● EXTRA_OEMAKE: make実行時に渡すオプション ● その他たくさん... ●

56. その他 ● autotools や pkg-config を使った手順は？基本機能をまとめたクラスが提供されている。 inherit 命令を使って機能を継承する。 inherit autotools pkg-config ● レシピ共通の項目をまとめたい include命令が使える。項目をまとめたファイルを指定。 include boost.inc

57. その他変数 PN: レシピ（パッケージ）名 ● PV: レシピのバージョン ● DEPENDS: ビルドに必要なレシピ ● DEPENDS = ''zlib openssl'' RDEPENDS: 実行に必要なパッケージ（or レシピ） ● EXTRA_OECON: configure 実行時に渡すオプション ●

58. レシピのビルド ● metamyrecipesのパスを conf/bblayers.conf の BBLAYERS に追加する BBLAYERS ?= " /home/iwamatsu/yocto/test/poky/meta /home/iwamatsu/yocto/test/poky/metayocto /home/iwamatsu/yocto/test/poky/metayoctobsp /home/iwamatsu/yocto/test/metamyrecipes "

59. レシピのビルド ● bitbakelayers showlayers でビルド環境のレイヤーのをチェックする $ bitbakelayers showlayers layer path priority ========================================== …… metayoctobsp /home/iwamatsu/yocto/test/poky/metayoctobsp 5 metamyrecipes /home/iwamatsu/yocto/test/metamyrecipes 6

60. レシピのビルド ● bitbakelayers showrecipes でビルド環境のレイヤーのをチェックする $ bitbakelayers showrecipes | grep A 1 ^example Parsing recipes..done. example: metamyrecipes 0.1

61. レシピのビルド ● bitbake example を実行する $ bitbake example Build Configuration: BB_VERSION = "1.18.0" BUILD_SYS = "x86_64linux" NATIVELSBSTRING = "Unknown" TARGET_SYS = "i586pokylinuxuclibc" MACHINE = "hoge" DISTRO = "hogefoo" DISTRO_VERSION = "1.4.2" TUNE_FEATURES = "m32 i586" TARGET_FPU = "" meta metayocto metayoctobsp = "dylan:d734ab491a30078d43dee5440c03acce" metamyrecipes = "<unknown>:<unknown>" ……

62. 既存のレシピの変更方法 .bbを直接変更しない ● .bbappendファイルを作成して上書き（オーバーライド）する ● .bbappendファイルで上書きするときは、レシピ名(PN)とレシピのバージョン(PV)が同じである必要がある。 ●

63. 既存のレシピの変更方法 ● metamyrecipes/recipesexample/example 以下にexample_0.1.bbappend を作成する install タスクに ${S}/test ファイルを作成する処理を追加 do_install_append() { touch ${S}/test }

64. 既存のレシピの変更方法 ● bitbakelayers showappends でレシピの変更状態を確認する $ bitbakelayers showappends | grep ^example A 1 Parsing recipes..done. example_0.1.bb: /home/iwamatsu/yocto/test/metamyrecipes/recipes example/example/example_0.1.bbappend

65. 既存のレシピの変更方法 ● bitbake example を再度実行

66. 既存のレシピの変更方法 ● bitbake example を再度実行 do_install_append() { touch ${S}/test } example_0.1.bbappendの install タスク example_0.1.bbの install タスク do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} }

67. 既存のレシピの変更方法 ● bitbake example を再度実行 do_install_append() { touch ${S}/test } example_0.1.bbappendの install タスク example_0.1.bbの install タスク do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} } do_install() { install d ${D}${bindir} install m 0755 helloworld ${D}${bindir} touch ${S}/test }

68. まとめ

69. まとめ ● レシピはソフトウェアのビルド、インストール方法が書かれたテキストファイル ● シェルスクリプト + Python を混ぜて記述 ● ソース取得からパッケージ化までの動作を記述 ● 各レシピは依存関係を持つ ● 変数とタスクが定義されている ● 変数とタスクは変更可能 ● yoctolayer create でひな形が作成できる ● bitbakelayers でビルド環境の確認ができる ● レシピを変更するときは .bbappend を使って上書きする

70. 質問ありますか？

レシピの作り方入門

レシピの作り方入門

Recommended

More Related Content

What's hot

What's hot(20)

Recently uploaded

Recently uploaded(13)

レシピの作り方入門