Posted inFedora

Linuxアプリのパッケージング：Fedoraでのflatpak-builder完全ガイド (A to Z)

Fedora tutorial - IT technology blog
Fedora tutorial - IT technology blog

なぜLinux開発者はflatpak-builderを無視できないのか？

自分の環境では完璧に動くのに、ユーザーの環境ではライブラリ不足で「動かない」という状況は、Linux開発者にとって珍しいことではありません。FedoraをメインPCとして2年間使用して気づいたのは、Flatpakが最も効果的な解決策であるということです。Ubuntu (.deb)、Arch (.pkg.tar.zst)、Fedora (.rpm) 用に個別にビルドする手間を省き、一度パッケージングするだけで済みます。

flatpak-builderを「自動シェフ」と考えてみてください。「レシピ」（マニフェストファイル）を渡せば、独立したキッチン（サンドボックス）で材料を集め、調理し、完成した料理を出してくれます。その結果、Steam DeckのSteamOSを含む、ほぼすべての主要なLinuxディストリビューションで動作するインストールパッケージが完成します。

現在、Flathubは毎月数百万件のダウンロードを提供しています。アプリをここに公開することで、ユーザーに素早くリーチできるだけでなく、システムライブラリのバージョン競合という悩みからも完全に解放されます。

Fedoraでのビルド環境構築

FedoraはFlatpakの「本家」とも言える存在なので、インストールは非常にスムーズです。ただし、SDKはサイズが大きいため、2〜3GB程度のディスク空き容量を確保しておいてください。

1. コアツールのインストール

ターミナルを開き、以下のコマンドでビルドツールをインストールします：

sudo dnf install flatpak-builder

2. SDKとランタイム（開発フレームワーク）のダウンロード

アプリを動作させるためのベース環境が必要です。ここでは、GNOMEやKDEに依存しすぎないアプリの標準規格であるFreedesktop SDK 23.08を選択します：

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub org.freedesktop.Sdk//23.08 org.freedesktop.Platform//23.08

マニフェストファイルの作成：Flatpakパッケージの魂

マニフェストファイル（.ymlまたは.json形式）は、システムに指示を出す場所です。コードの行数に惑わされず、識別子、権限、ソースコードの3つの主要部分に集中しましょう。

以下は、itfromzero-appという名前のPythonアプリの例です。org.itfromzero.App.ymlとして保存します。

app-id: org.itfromzero.App
runtime: org.freedesktop.Platform
runtime-version: '23.08'
sdk: org.freedesktop.Sdk
command: itfromzero-app
finish-args:
  - --socket=x11 # 画面にインターフェースを表示する
  - --share=network # インターネットからのデータ取得を許可する
  - --filesystem=home:ro # ホームディレクトリ内のファイルの読み取りのみを許可する

modules:
  - name: itfromzero-app
    buildsystem: simple
    build-commands:
      - install -D app.py /app/bin/itfromzero-app
    sources:
      - type: file
        path: app.py

注意すべき重要ポイント：

  • app-id: 一意である必要があります。myapp.comというドメインを所有している場合は、com.myapp.Appのように設定します。
  • finish-args: これはセキュリティの「障壁」です。過剰な権限を与えないようにしましょう。例えば、アプリに印刷機能が必要ないなら、--socket=cupsは追加しないでください。
  • modules: アプリがサードパーティ製ライブラリ（NumPyやRequestsなど）を使用する場合、ビルダーが自動的にダウンロードできるようにここで宣言する必要があります。

ビルドとクイックテストの手順

マニフェストファイルとapp.pyの準備ができたら、パッケージングを開始します。毎回クリーンな状態でビルドし、前回のゴミが残らないように--force-cleanパラメータを使用することをお勧めします。

flatpak-builder --force-clean build-dir org.itfromzero.App.yml

コマンドが完了しても、すぐに公開しないでください。以下のコマンドを使用して、ビルドフォルダから直接アプリを実行します。ここで、ボタンが動作するか、ファイルアクセス権限不足でクラッシュしないかを確認します：

flatpak-builder --run build-dir org.itfromzero.App.yml itfromzero-app

ヒント：アプリが「Permission denied」エラーを出す場合は、マニフェストのfinish-argsセクションを再確認してください。初心者のミスの90%はそこにあります。

Flathubへのアプリ公開

Flathubはコードを保存せず、マニフェストのみを保存します。このプロセスは、編集者に記事を提出してレビューを受けるのと似ています：

  1. Fork & Branch: flathub/flathubリポジトリをフォークし、アプリIDの名前で新しいブランチを作成します。
  2. Submit PR: マニフェストファイルを含むプルリクエスト（PR）を送信します。Flathubチームが、アプリが安全でコミュニティ標準に準拠しているかを確認します。
  3. Botによるチェック: ボットシステムが、x86_64やARM（Raspberry Piなど）のアーキテクチャ上でアプリを自動的にテストビルドします。

特に、AppDataファイル（XML）を用意する必要があります。これがないと、アプリストアでスクリーンショットや説明文が表示されず、非常に寂しい見た目になってしまいます。

ビルドエラー時のデバッグテクニック

Flatpakのビルドが一発で成功することは稀です。トラブルシューティングによく使う3つのテクニックを紹介します：

1. 見つからないライブラリの追跡

コンパイル時にNo such file or directoryエラーが発生した場合は、そのライブラリがmodulesセクションに追加されているか確認してください。メインアプリをビルドする前に、3〜4つの依存ライブラリを先にビルドする必要がある場合もあります。

2. システムログの確認

flatpak run -vvコマンドを使用して詳細モードを有効にします。サンドボックス内でのアプリの動作がすべて表示されるため、データベースに接続できない理由やウェブカメラが認識されない理由を正確に特定できます。

3. 環境のリセット

状況が混乱しすぎた場合は、以下のコマンドでビルドキャッシュを完全に削除してください：

rm -rf .flatpak-builder build-dir

flatpak-builderをマスターすることは、単にツールを学ぶだけでなく、Linuxでのソフトウェア配布をプロフェッショナル化することでもあります。あなたの最初のアプリがFlathubのトップページに掲載されることを願っています！

Share:
Tags: