0
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【第3回】Ubuntu対応とWSL2での検証――22.04でdebが動かなかった理由

0
Last updated at Posted at 2026-11-18

シリーズ:Folimeld開発記録(全9回)

この記事は、ChatGPTと壁打ちしながら作成しました。開発時の会話、Gitの変更履歴、ソースコードを調査した結果を含みます。

Windows版とmacOS版を作ったら、次はやはりUbuntu版でしょう。筆者はWSL2でUbuntu-24.04 LTSを使っていたので、そのUbuntuでVS Codeを準備してから、リポジトリをクローンして開発を始めてみました。しかし、Windows側のVS CodeからWSL拡張機能でUbuntuへ接続する構成を、この時点では理解していませんでした。また、WSL2で作業を続けるとVMイメージが大きくなるので、一度リセットしてから環境の準備も含めてCodexに任せてみようと思いました。

PC WatchでUbuntuの記事を読んでいる筆者は、とりあえずUbuntu-24.04 LTSに対応しておけばいいと思っていたのですが、すぐに最新のLTS(26.04)にも対応する方がよいと考え直しました。それからしばらくして、まだサポートが続いているUbuntu-22.04 LTSも対応しておいた方がいいと考えを変えました。

FolimeldのPDF編集本体はPython、PySide6、PyMuPDFです。しかし、ソースを共通化できても、配布した実行ファイルが各環境で動くとは限りませんでした。

今回は、2026年8月31日のLinux初対応と、9月7日のWSL2での検証を振り返ります。Qtの共有ライブラリ不足、WSLgでの自動操作の難しさ、Ubuntu 22.04で起動しないdebにどう対応したかが中心です。

本稿の対象期間:2026年8月31日〜9月7日。日時は日本時間です。

Ubuntu向けの配布準備

Linux版の最初の指示も短かった

8月31日17時38分、次の指示を出しました。

筆者のプロンプト(全文)

Linux版を作ってください。Ubuntu利用を想定します。

(Codex会話S04、9行。IDEの文脈を省略)

Ubuntu対応でも、まず追加したいOSを短く伝え、その後に配布・検証の条件を詰めています。

17時45分のコミット 8fe1564には、次のファイルが追加されました。

Folimeld-linux.spec
build_linux.sh
packaging/linux/control.in
packaging/linux/folimeld.desktop

このコミットでPDF操作のモデル全体を書き直したわけではありません。Linux向け実行ファイルとdebパッケージの生成、デスクトップとの連携を追加する変更が中心でした。

ビルド環境と資材の場所をOSごとに分ける工夫

初期のbuild_linux.shは、呼び出した場所ではなくスクリプト自身の場所を基準に処理し、Linux以外では停止します。9月7日の配布整備では、Linux専用の.venv-linuxへ分け、FOLIMELD_LINUX_VENVで保存先を指定できるようにしました。開発文書には、WSLではLinux側に仮想環境を置く案内もあります。環境の混在を避け、配置を選べる構成ですが、今回の調査で速度差を実測したわけではありません。

アイコンも、ソースからの実行とPyInstallerの配布実行ファイルで資材の場所が異なります。初期実装では_MEIPASSを手掛かりに同梱先を探し、通常のソース側の配置も候補にしています。配布形態が変わっても同じアイコンを使えるようにした点が、デスクトップへの登録と合わせた工夫でした。

起動するファイルを作るだけでなく、デスクトップへ登録する

初期のbuild_linux.shは、実行先がLinuxであることを判定し、仮想環境を用意してPyInstallerを実行する構成です。その後、dpkg-debでパッケージを作ります。

配置先 内容
/usr/bin/folimeld PyInstallerで作った実行ファイル
/usr/share/applications/folimeld.desktop アプリの起動情報
/usr/share/icons/hicolor/256x256/apps/folimeld.png アプリアイコン
DEBIAN/control パッケージ名、版、CPU、依存関係など

初期のdesktopファイルには次の設定があります。ほかの項目は省略しています。

[Desktop Entry]
Type=Application
Name=Folimeld
Exec=folimeld %f
Icon=folimeld
Terminal=false
MimeType=application/pdf;

起動コマンドにはPDFファイルを受け取る%fを指定し、PDFを扱うアプリであることを宣言しています。

アプリ側にもデスクトップ名とアイコンを設定する処理が追加されました。

app.setDesktopFileName("folimeld")

Windowsの「プログラムから開く」、macOSの.app、Linuxのdesktopファイルは、それぞれのOSとつながる部分です。PDF処理を共通化できても、こうした登録や配布設定まで同じにはなりませんでした。

図1。Ubuntu向けのビルド、debパッケージ、デスクトップへの登録を整理した図。配布準備と動作検証は区別する。

図1 Ubuntu向けの配布準備。2026年8月31日の実装を整理した図。配布・登録の整備と、各環境での動作確認は区別します。

WSL2での検証

Pythonの依存と、OSの依存を分ける

Ubuntu対応のREADMEには、Python環境に加えてQtの実行に必要なライブラリの導入手順が入りました。さらに8月31日18時01分の32479f4では、CJKフォントの導入案内が追加されています。

ただし、この段階の案内だけで、後の検証がすべて通ったわけではありません。

9月7日、WSLのUbuntu環境を作り直した後、動作確認を依頼しました。

筆者のプロンプト(全文)

wsl Ubuntu-24.04を作り直しました。wsl Ubuntu-26.04をインストールしました。Ubuntu版の動作確認が実行できますか?

(S06、9行。IDEの文脈を省略)

当時の回答では、Ubuntu 24.04はPython 3.12、26.04はPython 3.14と報告されています。これらはそのWSL環境の記録で、すべてのUbuntu環境のPython構成を表すものではありません。

自動テストが成功した後も、GUIの起動には問題が残りました。実行ログには次のエラーがあります。

qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.

(S06、80行のツール出力から抜粋)

同じ出力には、共有ライブラリの不足が記録されています。

libxcb-icccm.so.4 => not found
libxcb-keysyms.so.1 => not found
libxcb-shape.so.0 => not found

(同80行。繰り返し部分などを省略)

プラグインのファイルが存在しても、その依存先を読み込めなければ起動できません。18時台の検証では不足した3ライブラリを追加して開発手順へ反映し、19時台の再ビルドではdebの依存指定も補いました。

後述する9月7日19時11分のコミット23d1ff0には、packaging/linux/control.inの次の更新が含まれます。これは8月31日の初期版への変更ではありません。

変更前:

Depends: libc6 (>= @LIBC_VERSION@), libegl1, libgl1, libxkbcommon-x11-0, libxcb-cursor0

変更後:

Depends: libc6 (>= @LIBC_VERSION@), libegl1, libgl1, libxkbcommon-x11-0, libxcb-cursor0, libxcb-icccm4, libxcb-keysyms1, libxcb-shape0

Pythonのパッケージを同梱するだけで、OS側の依存まで解決したとは言えませんでした。

WSLgでの起動と、編集操作の自動試験を分ける

9月7日18時48分の回答では、24.04と26.04の自動テスト、debのインストール、GUI起動、PDF操作が成功したと報告されています。ただし、その時点ではSnap版と目視確認は未実施とも明記されていました。

そこで、次に指示しています。

筆者のプロンプト(全文)

Snap版の動作確認をしてください。

(S06、113行)

Snap版の作成自体は、検証より前の同日14時05分の2ab6177で記録されています。build_snap.shは既存のPyInstaller実行ファイルを取り込み、ランチャーやdesktopファイルなどと合わせる構成でした。ここからは、そのパッケージを18時台に検証した記録です。

Snap用ランチャーでは、GNOME側の起動処理の後にQT_QPA_PLATFORM=xcbを設定しています。コードのコメントには、UbuntuとWSLgでQt Widgetsの表示方式をX11/XWaylandへそろえる意図が示されています。既存の実行ファイルをSnapに取り込み、GUI資材と起動条件をまとめる工夫です。ただし、設定にstrictとあることと、当時のWSL環境で完全な隔離を検証できたことは別です。

検証中には、次の報告もあります。

Codexの回答(抜粋)

WSLg では自動操作のフォーカスと画面取得が安定しないため、編集・保存の検証は専用の仮想 X11 画面で進めています。

(S06、195行。前の文を省略)

以降の結果は、WSLgでPDFを指定して起動できたことと、仮想X11画面で編集・保存を自動検証したことを分けて読む必要があります。

たとえば、操作後のログには次の出力が残っています。

PASS rotate and save
PASS insert blank and save
PASS delete and save
PASS reorder and save

(S06、280行のSnap版自動検証ログ。周辺出力を省略)

この出力は、仮想X11画面で実行した試験の結果です。目視での使いやすさや全操作を確認した結果とは区別します。

図2 WSL2での検証条件。OS側の依存、WSLgでの起動、仮想X11画面での編集・保存を分けて整理します。Snapの隔離状態はpartialです。

図2。OS側の共有ライブラリ、WSLgでの起動、仮想X11画面での編集・保存検証を区別する。Snapの隔離状態はpartial。

Ubuntu 22.04向けの再ビルド

Ubuntu 22.04で、debが動かなかった

24.04と26.04の後、22.04も確認することにしました。

筆者のプロンプト(全文)

wsl Ubuntu 22.04をインストールしました。debパッケージとSnapパッケージの動作確認をしてください。

(S06、227行)

19時03分の回答では、配布済み0.3.2の結果が分かれています。

パッケージ Ubuntu 22.04での当時の結果
deb 必要なlibc6の条件を満たさず、直接起動しても失敗
Snap インストール、起動、編集・保存の自動検証が成功

debの依存条件はlibc6 >= 2.39でした。一方、22.04側は2.35です。さらに、展開した実行ファイルを直接起動しても、同梱Pythonの読み込みで失敗しています。

ログの該当部分を、ローカル一時パスを置き換えて示します。

Failed to load Python shared library '[一時展開先]/libpython3.12.so.1.0':
/lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.38' not found
(required by [一時展開先]/libpython3.12.so.1.0)

(S06、242行。プロセス番号・周辺出力を省略、改行を整形)

ここでは、debの依存指定の「2.39」と、実際の読み込みエラーにある「GLIBC_2.38」を混同しないようにします。どちらも22.04の2.35では満たせませんが、パッケージの宣言と、バイナリが読み込み時に要求したものは別の記録です。

依存条件の数字ではなく、実行ファイルを作り直す

続けて、対応範囲の変更を依頼しました。

筆者のプロンプト(全文)

debパッケージをubuntu 22.04以降対応に変更できますか?

(S06、294行)

Codexは次の方針を示しています。

Codexの回答(抜粋)

Ubuntu 22.04 上で deb をビルドし直し、22.04・24.04・26.04 で検証します。対応バージョンの表記とビルド手順も更新します。

(S06、297行)

修正は、controlファイルの数字だけを下げるものではありません。Ubuntu 22.04上で実行ファイルから作り直し、debの依存条件がlibc6 >= 2.35になったことを確認しています。

当時のパッケージ情報の出力は次のとおりです。

Version: 0.3.2
Depends: libc6 (>= 2.35), libegl1, libgl1, libxkbcommon-x11-0, libxcb-cursor0, libxcb-icccm4, libxcb-keysyms1, libxcb-shape0

(S06、316行)

23d1ff0では、開発ガイドのビルド方針も明確になりました。

変更前:

互換性を確保するため、配布先と同じか、それより古いUbuntu上でビルドしてください。

変更後:

Ubuntu 22.04以降に対応する配布用debは、Ubuntu 22.04上でビルドしてください。

(DEVELOPMENT.mdの差分。変更後の説明は冒頭1文のみ抜粋)

同じ箇所には、新しいUbuntuでビルドすると同梱Pythonや共有ライブラリが新しいglibcを要求する場合があること、依存表記だけを下げないことも追記されています。

これは今回のFolimeldの構成・対象範囲に対して採った方針です。古いOSで作れば、任意のLinux環境に無条件で対応できるという一般則としては扱いません。

作り直した後は、3環境で再確認した

再ビルド後は、22.04・24.04・26.04へインストールし、編集と保存を確認しています。S06の333行には、3環境の検証ファイル名と、回転・空白ページ挿入・削除・並べ替えについてのPASSが残っています。

22.04の自動テスト出力にも、次の記録があります。

37 passed, 32 subtests passed in 1.44s

(S06、323行のツール出力から抜粋)

README、開発手順、deb、チェックサムを更新し、19時11分に23d1ff0としてコミットしました。

注意したいのは、失敗したdebと作り直したdebが、どちらもアプリの版番号は0.3.2だったことです。版番号だけで同じ成果物だと判断せず、チェックサムで区別する必要がありました。

WSL2で確認できたことと、残ったこと

当時の検証を整理すると、次のようになります。

対象 記録された結果・条件
修正後deb 22.04・24.04・26.04でインストールと編集・保存の試験成功
Snap 3環境で起動・編集・保存を確認した記録あり
WSLg PDFを指定したGUI起動を確認
編集操作 仮想X11画面で自動検証
Snapの隔離状態 partialと記録。完全な隔離環境と同等ではない
通常のUbuntu実機 今回の記録から同等の試験完了とは判断しない

WSL2は、Windowsで開発しながらUbuntuの版を変えて調べるために使えました。一方で、自動操作のフォーカスやSnapの隔離状態など、環境固有の制約もありました。

「Ubuntu対応」と一言で書く前に、ソースのテスト、GUI起動、編集・保存、配布形式、対応OSの版を分けて確かめる必要があったというのが、この段階の経験です。

図3 Ubuntu 22.04向けの再ビルド。旧debの宣言と読み込みエラーを区別し、22.04上で作り直して3環境で確認した流れです。同じ版番号でも成果物はチェックサムで区別します。

図3。Ubuntu 22.04で旧debが動かず、22.04上で再ビルドして3環境で確認した流れ。同じ0.3.2でもチェックサムで成果物を区別する。

まとめ

Ubuntu対応では、実行ファイルを作るだけでなく、debやdesktopファイル、アイコン、OS側の共有ライブラリまで整える必要がありました。WSL2での検証では、WSLgでのGUI起動と、仮想X11画面での編集・保存の自動試験を分けて記録しています。

Ubuntu 22.04で動かなかったdebは、依存条件の数字だけを下げず、22.04上で実行ファイルから作り直しました。再ビルド後の3環境での確認も、当時の条件で得た結果です。同じ0.3.2でも配布物をチェックサムで区別し、通常の実機での全操作や任意のLinux環境への対応を保証したとは扱いません。

次回は、9月4日のMicrosoft Store公開相談にいったん戻り、9月9日までに進めたライセンスと対応ソースの整備を追います。第3回・第4回は日付が一部重なるテーマ別の構成です。

ソースコードと本稿の対象

ソースコード:tyamada/Folimeld。Codex版の基準は2026年10月25日取得のHEAD 50d0d5b4bcd6677b71ea4dd46dcef027b104717fです。10月30日に先行試作・環境の資料と筆者の振り返りを補い、当時の記録と区別しました。

第3回はLinux初対応と0.3.2配布物のWSL2検証が対象です。本文の依存関係や試験結果は当時の記録で、現在の全Ubuntu環境への対応保証ではありません。

今回、アプリのビルド・動作試験は再実行していません。成功報告・実行ログ・未確認事項を区別し、引用は原文を保って省略・整形を注記しています。

参照した履歴

会話資料:S04は8月31日のLinux初対応、S06は9月7日のWSL2検証に関するCodexの会話記録です。行番号は展開後JSONLの物理行です。エラーや試験結果も保存されたツール出力を参照し、ローカルパス・個人名を除いて掲載しています。

前の記事:第2回:PDF UtilityからFolimeldへ――改名とmacOS対応を進めた

次の記事:第4回:MITのつもりがAGPL-3.0に――Store公開前に依存ライセンスを見直した

0
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?