bitbakeが生成するディレクトリを徹底解説｜Yocto開発のトラブルシュートに必須

i.MXの開発環境を構築してみた (Yocto編) | 技術コラム では Yocto Project を使ってi.MXのBSPをビルドしました。

ビルドが終わったところで、ビルドツールである bitbake が作成したディレクトリを見ていこうと思います。 どのようなディレクトリが作られたのかを知っておくと開発の効率が上がり、トラブルシュートにも役立ちます。

この記事では、i.MX BSPをビルドした環境を例に、よく使うディレクトリを整理して紹介します。 たくさんのディレクトリがありますが、私が開発中によくアクセスするディレクトリに絞って説明します。

紹介するディレクトリはこちらです。なお、ディレクトリの場所はconf/local.confでディレクトリの場所を変更していないものとします。

• ${BBPATH}/tmp

  • work
  • work-shared
  • deploy

    • images
    • deb

以下、適宜Yocto Project Reference Manualの4 Source Directory Structureを引用します。

また、以降の内容はi.MX 95 Verdin 評価キット向けにNXPのBSP(L6.12.3_1.0.0)を使ってイメージimx-image-fullをビルドした環境で確認しています。

${BBPATH}/tmp

${BBPATH}はbitbakeを有効にする際に定義される環境変数で、以下のコマンドを実行した時に渡したビルドディレクトリ(以下コマンドの<build/directory>)を指しています。

$ source setup-environment 
... (出力は省略)
$ echo ${BBPATH}
=> <build/directory> が出力される    

本記事では出力でビルドディレクトリが表示される部分を ${BBPATH} で置き換えています。実際の出力ではパスが表示されますので適宜読み替えてください。

前置きを終えたのでtmpについての話を始めます。bitbakeでlinuxイメージをビルドすると${BBPATH}の直下にtmpというディレクトリができます。

tmpは「temporary=一時的」から来ています。Yocto ProjectのReference Manualから関連する箇所を引用します。

個人的な解釈になりますが、temporaryの心は「このディレクトリ内のディレクトリやファイルはbitbakeによって削除されます」だと考えています。

「gitで管理しているから大丈夫」

ではありません。 bitbakeのサブコマンドやオプションによってはgitの管理ディレクトリごと削除されます。原則としてtmpディレクトリ以下で開発しないことです。

それではさらに下の階層へ進みます。

# Switch to Debian packaging and include package-management in the image
PACKAGE_CLASSES = "package_deb"