シリーズ:Folimeld開発記録(全9回)
この記事は、ChatGPTと壁打ちしながら作成しました。開発時の会話、Gitの変更履歴、ソースコードを調査した結果を含みます。
Windows 11向けに作り始めた「PDF Utility」は、2026年8月30日に「Folimeld」へ改名し、同じ日にmacOS対応を進めました。
第1回では、8月23〜24日のCline・Gemmaによる先行試作と、8月28〜29日のCodex版のGUI実装、APIエラーや言語判定の修正を紹介しました。今回は、名前を決め直すやり取りと、Windowsで動くアプリをMacへ持っていったときの変更を振り返ります。
本稿の対象期間:2026年8月30日(後続作業は8月31日・9月5日)。日時は日本時間です。
Folimeldへの改名
新しい名前を相談し、いったんPageCraftを選んだ
8月30日9時46分、Codexに名前の候補を依頼しました。
筆者のプロンプト(全文)
このアプリの新しい名前の候補を考えて。
(Codex会話S03、9行。IDEの文脈を省略)
最初の提案には、PageWeave、PDFolio、PageCraft、LeafPDF、PDF Atelierがありました。ページを並べたり、足したり、回したりする機能から名前を考えています。ただし、この回答には、商標などの重複はまだ確認していないという留保もありました。
このときはPageCraftを選んでいます。この段階では、語感の良さで選んだだけでした。
筆者のプロンプト(全文)
このアプリの名前をPageCraft に変更して。
(S03、49行。IDEの文脈を省略)
Codexは表示名、EXE名、Windowsの「プログラムから開く」の登録、翻訳、READMEなどを変更しました。最初はPythonパッケージ名のpdfutilityを維持する提案でしたが、その後、内部ディレクトリーも改名する指示を追加しています。
つまり、アプリ名の変更は画面のタイトルだけでは済みませんでした。表示名と内部識別子のどこまでを変えるかも、追加のやり取りになっています。
Folimeldを選び直した
10時03分、名前についてもう一度条件を出しました。当時のPCで試用し、エクスプローラーの「プログラムから開く」で、Pから始まる名前が一覧の下の方に並ぶことが気になったためです。目立ちやすく使いやすいよう、Aに近い名前を選びたいと考えました。ただし、その意図を直接依頼せず、次の質問を挟んでいます。
筆者のプロンプト(全文)
既存の有名なアプリ名と重ならない名前を考えて。
(S03、249行)
Codexは当時の検索結果を踏まえ、PageCraftの再検討を提案しました。次に挙がった候補はFolimeld、Folimora、Pagivra、FolioNestです。
Folimeldについては、次の意味づけが示されています。
Codexの回答(抜粋)
第一候補は Folimeld(フォリメルド) です。
Folio(ページ・冊子)+Meld(組み合わせる)
- PDFの挿入、削除、並べ替えという機能に合う
(S03、274行の一部抜粋。後続の説明・候補を省略)
そして、最終的に次の指示を出しました。
筆者のプロンプト(全文)
アプリ名やディレクトリー名をFolimeldに変更して。小文字が適切な場合は、小文字名に変更して。
(S03、280行)
表示名と実行ファイルはFolimeld、Pythonパッケージはfolimeldという形になりました。
これは当時の命名の記録で、現在の名称利用や商標の確認結果ではありません。
Gitだけでは見えなかった途中の名前
改名コミット 6e7fbf9は10時08分です。Gitの最終差分では、主にPDFUtilityからFolimeldへの変更として見えます。
| 対象 | 変更前 | 変更後 |
|---|---|---|
| Pythonパッケージ | pdfutility |
folimeld |
| PyInstaller設定 | PDFUtility.spec |
Folimeld.spec |
| Windows実行ファイル名 | PDFUtility.exe |
Folimeld.exe |
| 翻訳・画面のアプリ名 | PDF Utility | Folimeld |
| 起動入口・テスト | 旧パッケージの参照 | 新パッケージの参照 |
一方、会話を見るとPageCraftを一度選び、変更作業を進めたことが分かります。最終的なコミット差分と、名前を決めるまでの試行錯誤は別の資料でした。
また、プロジェクトルートの改名について、Codexは最後にWindowsから拒否されたと報告しています。IDEなどで使用中だったことを理由として挙げ、閉じてから変更する手順を案内していました。内部の名前変更が完了したという回答と、ルートフォルダーまで変更できたという回答を同じ意味では扱えません。
改名は8月30日です。9月4日のライセンス変更より先の出来事であり、その経緯は第4回で扱います。
図1 名前の変遷と改名で変更した範囲
macOS対応の実装
macOS対応の前に、Windows固有処理を囲む
このアプリはPythonで書かれているのでMacでも少ない変更で動くだろうと思っていたので、試してみることにしました。
まず、午後にはmacOS対応の準備が入ります。be590f4は14時02分のコミットです。
Windows向けの「プログラムから開く」登録にはwinregとctypes.windll.shell32を使っていました。この関数には、準備前から次の条件があります。
if sys.platform != "win32" or not getattr(sys, "frozen", False):
return False
macOS対応で初めてOS判定を追加した、という変更ではありません。すでにあった条件に加えて、Windows APIを取得する箇所も保護しています。
変更前:
import winreg
変更後:
try:
import winreg
except ImportError:
return False
try:
shell32 = ctypes.windll.shell32
except AttributeError:
return False
後続の通知処理も、直接ctypes.windll.shell32を参照する形から、取得したshell32を使う形へ変わりました。
この差分は、Windows固有の連携をPDF編集本体から切り離して扱う変更として読めます。ただし、Macで実際にこの箇所の例外が起きた記録を見つけたわけではありません。予防的な実装変更と、発生を確認できた不具合は分けます。同じ変更には、Windowsとして動く条件でもwinregが使えない場合に処理を行わずFalseを返す回帰テストが加わりました。OS固有の連携が使えない条件を、PDF編集本体の処理と切り分けて確かめる構成です。
Mac側の指示は短かった
いよいよMacへの移植を始めることにしました。MacのVS Codeでリポジトリをクローンしてから作業開始です。
Mac側の資料には、8月30日の次の入力が残っています。
筆者のプロンプト(全文)
macOSで動くように変更して。
(GitHub Copilot「macOS対応の変更」、元記録4行、14時05分28秒)
Codex版で必要最低限と考えた仕様を渡し、その後は短い指示で進めた流れは、macOS対応の依頼にも見られます。このセッションでは「続けてください。」という指示も繰り返されています。
ただし、Mac資料の提供元はGitHub Copilotです。筆者はVS CodeにCodexの拡張機能を追加してサインインも済ませていたのですが、エージェントのチャットの開き方を間違えていたようです。当時は間違いに気づいていませんでした。
言語コードのCを、英語へのフォールバックに変える
Mac側の回答には、言語取得処理が汎用ロケールのCやPOSIXを扱う際の問題が記録されています。これらをmacOS固有の値とみなす説明ではありません。
GitHub Copilotの回答(抜粋)
原因は macOS でシステム言語が
C/POSIXのようなデフォルト値を返すと、アプリがcを言語コードとして扱ってしまうことでした。そこだけ安全に英語へ落とす修正を入れます。
(Copilot会話、元記録24行の回答断片から抜粋。後続を省略)
c3163fcでは、folimeld/i18n.pyの処理が変わっています。
変更前:
return QLocale.system().name().split("_")[0].lower() or "en"
変更後:
code = QLocale.system().name().split("_")[0].lower()
if code and code not in {"c", "posix"}:
return code
return "en"
元の式でも空文字ならenになります。しかし、Cを小文字にしたcは空文字ではないため、そのまま返っていました。修正後は汎用的なロケール値を明示的に除外しています。
テストにも、QLocale.system().name()がCを返す条件が追加されました。
with unittest.mock.patch("folimeld.i18n.QLocale.system") as system:
system.return_value.name.return_value = "C"
self.assertEqual(I18n._system_language(), "en")
ここで確認できるのは、言語コードを返す関数と回帰テストが修正されたことです。呼び出し側にも未対応言語を英語へ戻す処理があったため、これだけを根拠に「修正前は必ずアプリ全体が落ちた」とまでは断定しません。
.venvがないと、ビルドスクリプトが止まる
Mac側の回答には、仮想環境がない場合にビルドが止まったという報告もあります。初期のbuild_exe.shは、.venv/bin/pythonが見つからなければ作成方法を表示して終了する構成でした。
変更前の該当部分:
if [ ! -x "$PYTHON_EXE" ]; then
echo "Python virtual environment was not found: $PYTHON_EXE"
echo "Create it with: python3 -m venv .venv"
exit 1
fi
変更後は自動作成へ進みます。
if [ ! -x "$PYTHON_EXE" ]; then
echo "Python virtual environment was not found: $PYTHON_EXE"
echo "Creating it automatically..."
python3 -m venv "$SCRIPT_DIR/.venv"
fi
ビルド手順では、起動したターミナルの現在位置ではなく、スクリプト自身の場所をSCRIPT_DIRとして求め、その場所へ移動してから処理します。そこを基準に.venv/bin/pythonを選び、仮想環境がなければ自動作成し、作成後もPythonの存在を再確認して、失敗していれば終了します。その後にpip、依存パッケージ、PyInstallerを準備し、アイコン生成からビルドへ進みます。実行場所への依存と、準備漏れによる手作業を減らす工夫です。ただし、依存の導入・更新を含むため、これだけで当時と同じ依存環境を再現できるとはしません。
「ソースが動くこと」と「ビルド手順をそのまま使えること」は別でした。macOS対応には、Pythonコードの修正だけでなく、環境を用意する手順の修正も含まれています。
図2 8月30日の初期移植で見直したコードとビルド手順
動作確認と配布
EXEから.appへ、配布用の形を整える
Macでは、ターミナルからアプリを起動することもできますが、アプリケーションとして使う方が便利です。そこで、アプリバンドルをビルドすることにしました。この時点では、FolimeldをApp Storeで公開する計画はありませんでした。
WindowsではEXEを生成していましたが、MacではFolimeld-mac.specでアプリバンドルを作っています。c3163fc時点の設定は次のとおりです。
app = BUNDLE(
exe,
name="Folimeld.app",
icon="assets/Folimeld.icns",
bundle_identifier="com.folimeld.Folimeld",
)
途中で、次の追加指示を出しています。
筆者のプロンプト(全文)
配布用のアイコン追加や署名設定まで続けてください。
(Copilot会話、元記録56行のプロンプト)
8月30日の初期対応では、アイコン生成ツールで16・32・64・128・256・512・1024pxの7サイズを同じ描画処理から作り、iconsetへ保存しました。ビルド時にiconutilでICNSへ変換し、Folimeld-mac.specのBUNDLE設定から.appへ組み込みます。サイズごとの画像を手で作り直す手間を減らし、アイコンの生成もビルドの工程に含めた点が工夫でした。スクリプトには、codesignが見つかる場合にビルド後のad-hoc署名を行う分岐も加わっています。
codesign --force --deep --sign - "$SCRIPT_DIR/dist/Folimeld.app"
これは当時追加した処理の抜粋であり、この一行で正式配布に必要な確認が完了するという意味ではありません。提供資料からは、Apple証明書を使う署名、公証、Gatekeeperでの挙動、App Store審査の成否までは確認できませんでした。
また、当時のスクリプトは依存をインストールし、pipも更新する構成です。過去版を試す場合、このスクリプトを実行するだけで当時の依存関係が復元されるわけではありません。
どこまで動作確認できたのか
Mac側の回答には、次の結果が報告されています。オフスクリーンとは、画面を通常表示せずにウィンドウ生成などを確認した条件です。
| 確認内容 | 会話に残る報告 | 今回確認できた範囲 |
|---|---|---|
| 自動テスト | 12テスト成功 | 回答断片とテストコード。独立した実行ログは非収録 |
| ウィンドウ生成 | オフスクリーンでMAIN_WINDOW_OK
|
回答内の報告。通常画面での目視操作とは区別 |
| PyInstaller | ビルド完了 | spec・スクリプト・コミットと、回答内の完了報告 |
| アイコンと署名 | ICNS追加とad-hoc署名 | ファイル変更と回答断片 |
今回の調査では、Mac上でテストやビルドを再実行していません。当時のmacOS、Python、依存の正確な実インストール版やCPUアーキテクチャも、今回の選別資料だけでは確定していません。
初期対応後も作業は続き、8月31日には「Build .app file.」というコミットがあります。9月5日のStore向け整備では、アプリ用とインストーラー用の署名情報、プロビジョニングプロファイルを引数で指定する専用スクリプトを追加しました。必要な引数・工具・ファイルの不足を検出し、バンドル識別子、PDF文書タイプ、App Sandboxとユーザーが選んだファイルへの読み書き権限、表示版とビルド番号の区別を検査して、不備があれば停止する構成です。署名の検査やインストーラーパッケージの生成手順も含まれます。ここで確認したのはコードと検査項目の存在であり、この後続手順の実行成功やStore審査・配信の完了を確認したわけではありません。8月30日の初期移植と、9月5日のStore向け整備を同じ実績としてまとめません。
名前と配布の形を整えた1日
午前は候補を選び直し、アプリ内外の名称をFolimeldへそろえました。午後のmacOS対応では、OS固有処理に加え、言語判定、仮想環境、アイコン、署名、READMEまで変更しています。表示名を変えることも、別OSへ持っていくことも、一つのファイルだけでは完結しませんでした。
次回は、Ubuntu向け配布とWSL2での検証を扱います。
図3 初期移植・Store向けの後続整備と検証の限界
まとめ
PDF UtilityからFolimeldへの改名では、表示名だけでなく、内部パッケージ、実行ファイル、設定、翻訳や文書まで名前をそろえました。macOSへの初期移植では、Windows固有処理の保護、言語のフォールバック、実行場所に依存しにくいビルド手順、複数サイズのアイコン生成を組み合わせています。
8月30日の初期移植と、9月5日のStore向けの署名・権限・文書タイプなどの整備は別の段階です。当時の回答に残るテスト・起動・ビルドの成功報告と、コードから確認した実装、今回の資料では確認できない通常画面の全操作や審査・配信の結果を区別しました。次のUbuntu対応でも、OSごとの実装と配布手順、検証の範囲を分けて追っていきます。
ソースコードと本稿の対象
ソースコード:tyamada/Folimeld。Codex版の基準は2026年10月25日取得のHEAD 50d0d5b4bcd6677b71ea4dd46dcef027b104717fです。10月30日に先行試作・環境の資料と筆者の振り返りを補い、当時の記録と区別しました。
第2回は改名とmacOS初期対応が中心です。8月31日・9月5日の後続作業は補足として区別しました。Mac資料は選別・置換済みで、元Mac上の生ログとは直接照合していません。
PageCraftを語感で選んだことと、アプリ一覧での表示順を意識して名前を再検討したことは、10月30日の筆者による原稿追記を反映しています。当時のプロンプトに直接書かれていた条件とは区別しています。
今回、アプリのビルド・動作試験は再実行していません。成功報告・実行ログ・未確認事項を区別し、引用は原文を保って省略・整形を注記しています。
参照した履歴
会話資料:S03はCodexの改名に関する会話です。行番号は展開後JSONLの物理行です。Mac側はGitHub Copilotの選別資料を使用し、移行資料のsource_lineで元記録の位置を示しています。複数の回答断片を一つの発言に連結して引用していません。


