メインコンテンツへスキップ
見出し画像

PDFのページを編集するソフトを作りました

    もともと、PDFエディタを作ろうと思ったきっかけは、本業で発生した既存システムのマニュアル改修という作業からでした。
    システム開発での作業の中には、ユーザが参照するマニュアル作成は欠かせません。現在のマニュアルは機能ごとにWordファイルとして細かく管理されており、それをWEB上でマニュアルとして参照できるようにそれらを一本化してPDFにする必要があったのです。

    当初は単純に「Word上で全部のファイルを結合してから、最後にPDF化すればいいよね」と漠然と考えていました。しかし、やってみて愕然とします。ファイルをマージした途端、ファイルサイズが肥大化し、Wordの挙動は重くなり、編集どころではなくなってしまったのです。

    結局、以下の方針転換をすることにしました。

    それぞれのWordファイルを個別にPDF化し、最後にPDFデータとしてガッチャンコ(結合)する

    です。

    さて、ここで問題になったのが「どうやってPDFを結合するか」なのです。 結局は、フリーソフトを使ってPDFを結合することとなりました。


    この時フリーソフトをわざわざインストールして実施したのだけど、実は今では簡単に作れるんではないだろうか?と、ふとそんなことを思い立ち、さっそくGEMINIに訊いた結果、簡単に作れるような雰囲気があったので作ってみることにしました。

    個人の趣味としての軽いノリと技術的な興味が、まさかこれほど大変になるとはこの時はまだわかっていませんでした。
    今回は、この思いつきから始まり、アプリ完成までの流れを記事にしたいと思います。

    最初のバージョン 1.0.0

    開発のスタートライン(Ver 1.0.0)。 個人開発とはいえ、スパゲッティコード(整理されていないコード)は恥ずかしい(#^^#)ので、AIという優秀なコーダーがいるからこそ、個人では敬遠しがちな「堅牢でモダンな設計」にあえて挑戦しました。

    Feature Slicing Design (FSD): 

    「機能Aを直したら機能Bが壊れた」なんて週末の貴重な時間を浪費したくありません。すべての機能をCore層とFeatures層に分離し、依存関係を極限まで減らしたアーキテクチャをAIに提案させ、実装しました。

    Zustandによる状態管理:

    単一のStoreが肥大化するのを防ぐため、ロジックを3つのスライスへ分割しました。

    • pdfDocumentSlice: ドキュメントの心臓部。

    • selectionSlice: ユーザー操作の追跡。

    • fileOperationSlice: ファイルの保存や読み込み。

    AIに指示を出し、コードを書かせ、私がレビューして統合する。 このサイクルは順調でした。きれいに整列されたコードを眺めながら、「うん良い感じ(^^♪」なんて思っていた時期がありました。 しかし、本当の敵はコードの外、「PDF」という規格そのものに潜んでいたのです。

    最初の危機:AIも沈黙する「白紙化」問題(Ver 1.0.3)

    リリース後、順調に見えた開発に暗雲が立ち込めました。 使用していたライブラリpdf-libの便利な機能であるcopyPagesメソッドが、特定のPDFファイルを処理しようとすると、エラーが発生してしまうケースがあることに気づいてしまったのです。

    それらのPDFを編集して保存すると、ブラウザだろうが、本家Adobe Acrobat Readerだろうが、開いた瞬間にページが「白紙」になる現象が発生。 どこで開いても真っ白。データとして完全に破綻していました。

    後少しで公開できると思っていたのが一瞬のうちに絶望に変わりました。

    AIにログを解析させても、解決できません。「なんとかしてくれ」という状況に対し、私とAIがひねり出したVer 1.0.3の解決策は、ある意味で「敗北」に近いものでした。 それが、「完全画像化」戦略です。

    • PDF.jsを使って、ページを300 DPIの高解像度画像としてレンダリングする。

    • その画像をPNGとして新しいPDFに貼り付ける。

    これしか方法が無いと AIに依頼して実装しました。これにより白紙化は100%防げましたが、「うーん、これで良いのかー?」。
    テキスト情報は失われ、ファイルサイズは肥大化する。
    苦肉の策なのですが、後味が悪くてもどうしようも無かったのです。

    「動くけど、なんか、、、なんとか改善できないだろうか、、、、」

    品質の奪還:ベクター優先の「ハイブリッド戦略」(Ver 1.0.7)

    このまま公開してもなんかもやもやして、片手落ちしてる感が否めなかったので 失われたテキスト情報と品質を取り戻すため、再びAIに相談しました。すると安全性と品質を両立させるハイブリッドな保存ロジックを提案してくれました。

    • Plan A(理想): まずはベクターデータをそのままコピーする処理を試行する。

    • Plan B(現実): 万が一エラーが発生した場合のみ、安全策である「画像化」へフォールバックする。

    AIに複雑な条件分岐処理を実装させ、私はその挙動を入念にテストしました。 この戦略が功を奏し、多くのファイルでテキスト検索・選択が可能になり、ファイルサイズも従来の1/3〜1/10に圧縮。Ver 1.0.7ではこのロジックを全機能に適用しました。

    これで完成にしよう!!、と思いました。

    pdf-libでは無理なラスボス登場(Ver 1.0.10)

    色々なPDFを開いては保存していくうちに、どうしてもベクターデータでコピーができず、画像化されるファイルが見つかりました。
    それは、Adobe InDesignやIllustratorで生成された、特殊な構造を持つPDFたちです。
    これらはPdfLibというライブラリでは解析できず、どうしてもエラーを吐いて「画像化(Plan B)」されてしまう。「また画像か...」という徒労感。 ここまできたら、すべてのPDFを美しく扱いたい。その思いで、再度AIに相談いたしました。そうすると、別のライブラリも併用使用するアプローチとして、「MuPDF (v1.26.4)ライブラリ」にたどり着きました。

    ただ、MuPDFは、9.8MBものWebAssembly (WASM) を含みます。Webアプリでこれを無条件に読み込むのは重すぎる。 そこで、AIと相談しながら「3段階の防衛ライン」と「遅延ロード」を組み合わせた実装を行いました。

    1. Strategy 1: 標準処理(最高品質・最速)。

    2. Strategy 2: 簡易サニタイズ処理。

    3. Strategy 3(最終奥義): それでもダメなら、MuPDFを動的にインポート(Dynamic Import)し、PDF構造を完全に正規化してから処理を実行。

    「必要な時だけ重い武器を取り出す」実装です。 これにより、もっとも厄介だった特殊なPDFでさえも、ベクター形式を維持したまま保存することに成功しました。これが、Ver 1.0.10の到達点です。

    さぁ、いよいよ!、公開したい!

    リリース直前の冷や汗、セキュリティ問題(Ver 1.1.0)

    互換性の問題も解決し、いよいよ記事を公開しようと思った矢先、React Server Componentsの脆弱性(CVE-2025-55182)という記事を読み、私の作成したアプリが問題にならないのだろうかと、心配になりました。

    Geminiに訊いた所、今回の件は、「Reactアプリ」と認識していても、フレームワークの機能として裏側で「React Server」の技術が使われている場合があるとのことで、まずは、Next.js (App Router) を使用しているか、その他のRSC対応フレームワークを使用しているかがポイントとのことでした。

    個人開発だからこそ、セキュリティには気を付けたいと思い、急遽AI(Gemini)にコードのセキュリティ監査(脆弱性診断)を依頼しました。

    結果は「総合評価: 良好 (B+)」。 致命的な穴はないものの、「セキュリティ最重視」を掲げるには、いくつかのガードが甘いという指摘でした。

    • Content Security Policy (CSP) の未設定: 「ローカル完結」をブラウザに強制させる設定がありませんでした。もし悪意のあるPDFにスクリプトが仕込まれていたら、外部へ通信されるリスクがあります。

    • ファイル検証の甘さ: 拡張子が.pdfならなんでも受け入れてしまう状態でした。中身が.exeでも通ってしまう可能性がありました。

    指摘された内容を即座に修正。 index.htmlに厳格なCSPタグを埋め込み、外部通信を完全に遮断。ファイル読み込み時には「マジックナンバー(バイナリヘッダー)」をチェックし、本物のPDF以外は弾くロジックを追加しました。また、DoS (Denial of Service) 攻撃への耐性として、読み込み前にファイルサイズの制限を設けることにしました。

    これが最新の Ver 1.1.0 です。

    せっかく作成できたので、これで公開したいと思います。

    と早速、公開したのですが、すぐに公開停止しました。( ノД`)シクシク…

    iPhoneという「魔境」。消えたファイルとWeb Share API(Ver 1.1.1)

    「今度こそ完璧だ」。そう確信してNoteに公開して、かみさんに 「アプリ作ってみたからみてみて!」と、かみさんのiPhoneでアプリを開き、動作確認をしてもらいました。「おー、iPhoneでも動くね!」と話をして、PDFを編集し「保存」ボタンをタップすると、画面上では保存しましたと出るのに、 どこを探してもファイルが見つかりません。

    「あれ? ファイルはどこ?」

    アプリで探しても、ダウンロードフォルダを見ても、どこにもファイルがみあたりません。まるでデジタル空間の彼方に消滅したかのようです。
    原因がわからないため、すぐにNoteの記事公開を中止しました。

    Geminiにいろいろと、尋ねたところ、iOSのPWA環境では、PCと同じ「ダウンロード処理(<a download>タグ)」がセキュリティ制約により無視されるということでした。 

    ひとまず、iPhoneでは動かなくても良いことにしようか、とも考えました。が、やっぱり、iPhoneでも動くようにしたい!とAIに相談した結果、導き出した答えが「Web Share API」でした。

    今回の事象を簡単に説明すると、 勝手に保存しようとしたからiOSに拒絶されたということ。この解決方法としては、iPhoneおなじみの「共有シート(下から出てくるメニュー)」を呼び出し、ユーザー自身の意思で「ファイルに保存」や「AirDrop」を選んでもらう。この対応をとることで、iPhoneでもファイルを保存できるようになりました。

    PCの場合は従来通りダウンロード、スマホ(iOS/Android)の場合は共有シート。 この分岐処理(isMobile())を実装することでiPhoneでも直感的にファイルを保存できるようになりました。
    これが、今、最新の Ver 1.1.1 です。

    やっと、アプリ(Ver 1.1.1) を公開

    まだまだ、バージョンアップが続くと思いますが、ひとまず公開できるレベルになりました。

    画像
    画像
    画像
    ベクター形式で保存できたかは保存完了で確認できます。(「OK」ボタンで表示が消えます)

    お約束として、ご使用にあたっては以下の通りとさせてください。
    本ツールは個人利用・商用利用が可能です。
    本ツールは現状のまま提供されており、いかなる保証もありません。 使用によって生じた損害について、開発者は一切の責任を負いません。

    ※上記サイトにアクセスすると、少し応答が返らない状態になりますが、アプリが開きますので、少しそのままお待ちください。
    ※
    PWAの実装もしているため、インストールのダイアログが出ると思います。しばらく無視して使っても問題ありません。もし気に入っていただければ、インストールしていただければと思います。
    ※このツールについてのガイドに「オフラインで動作します。機内モードでも安心してご利用いただけます。」と記述しておりますが、これはこのアプリを起動した後からの話です。PWAでも最初に私の公開サイトにアクセスしないと動きません。

    おわりに

    ようやく公開できる形までもってこれました。
    「フリーソフトじゃなく自分で作れるかも!」という些細な動機から始まり、AIと構築したPDF編集ソフトは、互換性の壁への敗北と妥協、MuPDFによるベクター対応、セキュリティの心配、最後にiOSへの対応をもって完成しました。ほんと、いつでもすぐに声をかけられるGeminiがいなければ、短時間に解決はできなかったと思います。

    最近になってGeminiが、本当に使えるようになったなと思います。

    そして、完成出来てホットしております。


    (追記)公開後のバージョンアップ

    本サイトで公開後、随時バージョンアップを行っております。
    本アプリをインストール済の場合は、リロード処理を行うことで、
    バージョンの表示が変わりますので、お手数ですがご対応をお願いいたします。

    Ver 1.1.2 対応
    React脆弱性対応(CVE-2025-55182)

    本アプリはクライアントサイドで動作するアプリなので問題は起こらないのですが、使用していたReact 19.2.0 が脆弱性の問題を抱えるバージョンであったことから、 19.2.1 に更新しました。

    脆弱性の問題は、サーバサイドでの問題なため、念のための対応です。

    画像
    画像

    Ver 1.1.3対応

    一部フォントを正しく表示できない不具合があったので対応いたしました。

    日本語フォント完全対応(99%以上)

    CJK(中国語・日本語・韓国語)フォントマッピングを完全搭載。MS明朝、MSゴシック、ヒラギノ、游明朝など、一般的な日本語フォントは全て正しく表示されます。

    この結果、PDFの読込に少し時間がとられるようになりましたが、PDFを正しく表示できるようになりました。

    Ver 1.1.4対応

    テキスト選択・コピー機能

    プレビュー画面でPDF内のテキストを選択してコピーできます。Canvas描画とテキストレイヤーの2層構造により、鮮明な表示と高い操作性を実現した。

    Ver 1.1.5対応

    処理が重たくなり、応答が返らない事象が発生した為、Ver 1.1.4の対応を中止した版です。(Ver 1.1.4は、改めて検討しなおすことにします)

    Ver 1.2.0対応

    調査の結果、v1.1.4におけるフリーズの根本原因は、「メインの一覧表示において、全ページに対して一斉にテキストレイヤー(DOM要素)を生成しようとしたこと」による、ブラウザのメインスレッドのブロッキングであると特定できました。例えば50頁のPDFを読み込んだ際に、メインの一覧表示では、50頁分×数千要素=数万~数十万のDOM要素が短期間に生成・配置する処理が行われた結果、その処理を完了させるために画面の表示やユーザの操作を受け付けない「フリーズ状態」が発生していたのです。
    この為、処理をPDFファイル全体で行うのではなく、プレビュー画面表示時のみに絞ってTEXTを選択可能にする処理を実装することで選択が可能となりました。(但し、編集可能な入力エリアは選択不可です)
    このテキストが選択できる機能は、このアプリを別の目的で使うことができるようになるためのどうしても必要な機能なので実装できて良かったです。

    画像

    Ver1.2.1

    ページ複製時のベクター形式保持を改善しました。
    回転されたページを複製した際に、画像形式に保存される問題をできるだけベクター形式で保存できるようになりました。

    Ver1.2.2

    React 19.2.2, React 19.2.3 へ
    セキュリティ脆弱性(特にReact Server Components関連のDoS攻撃やソースコード漏洩の可能性)に対応するためのアップデート

    Ver1.2.3

    PDFの複数選択機能と、PDF保存時の白紙化に関する改善対応

    バージョンアップの方法

    ※リフレッシュ(CTRL+SHIFT+R,画面の再描画指で、画面を上から下になぞって離す) 等でバージョンが最新に切り替わることを確認してください。


     
     
    2026年現在、.NET系のSE兼PG(PHPも担当)。 本noteは業務とは無関係な個人活動として運営しており、守秘義務に配慮し、記事には業務上の情報は一切含んでいません。 Artist name: nonkiyone

    あなたへのおすすめ