連載ストックリスト:Android版「見開きPDFビューア」開発記録
この記事は、ChatGPTと壁打ちしながら、Android Studio内のGeminiの会話履歴、Gitの変更履歴・ソースコード、手元に保存された実行ログを調べて作成しました。
端末を増やすと、実際に試せる条件が増えます。同時に、各端末でどの版を動かし、何を確認したかを残す作業も増えていきました。この補足記事では、ビューアの2026年10月16〜17日の作業を中心に、実行・ログ保存・確認一覧の更新をまとめていった経緯を振り返ります。プロンプトは原文全文、回答は抜粋、日付・時刻は日本時間です。
図1 実機追加で増えた検証・記録の負担から、Macでの実行、テスト範囲の確認、一覧更新、Chromebookの別運用、別アプリへの展開、結果の読み方へ。番号は記事の節の順であり、すべての作業の時系列を示すものではありません。
第2回で紹介した実機追加の後も、機材を増やしながら検証を続けました。ここで更新を省力化したのが、機種・OS・アプリ版・結果を記録するVERIFICATION_LIST.mdです。カタログやヘルプの改善と並行して、検証と記録の仕組みも整えていました。
Macから実機テストと記録をまとめて実行したい
手動で実機のアプリを更新して、アプリが動くことを確認して、VERIFICATION_LISTを更新するのは、最初は苦痛ではありませんでしたが、バージョンアップを繰り返したり、実機が増えると、だんだん手間を感じるようになりました。
そこで、10月16日、Android StudioのGeminiには、まず次のように依頼しています。
筆者のプロンプト(全文)
実機を接続してテストを実施し、記録を保存する機能を追加してください。
Geminiはこれを、設定画面へ結果保存ボタンを追加する依頼と解釈しました。その変更を取り消した後、実行する場所を明示し直しています。
筆者のプロンプト(全文)
開発環境(Android StudioまたはTerminal)から実機を接続して可能な限り多くのテストを実施し、それらの結果を開発環境のlog/以下に保存する機能を追加する計画を立ててください。
続けて、保存先をlogs/へ変更し、Gitの管理対象外にするよう指定しました。実装後の回答には、次の説明があります。
Geminiの回答(抜粋)
接続された実機を検出し、デバイス診断情報 (device_info.txt)、Logcat (logcat.log)、単体・結合テストの実行ログ、およびHTMLレポートをタイムスタンプ付きのセッションフォルダ (logs/_/) に自動保存します。
こうして作ったのが、scripts/run_device_tests_and_save.pyです。最初の依頼だけで意図どおりになったのではなく、「どこから実行し、どこへ結果を残すのか」を具体化していました。
図2に、依頼の解釈の違いと、開発PCから検証・記録をまとめる解決方法を示します。一覧更新は後続の依頼で加えたもので、最初の実装ですべてが揃ったわけではありません。
図2 開発PCで実行するスクリプトから、接続端末のテスト・ログ保存・一覧更新へ進む流れ。ファイル例は10月17日の公開一覧の一部を省略して示しています。No issuesは全テスト合格の保証ではなく、コミット・プッシュも別途の作業です。
インストールと、既存テストの実行範囲を確認する
別の端末で実行したときに、アプリの更新に必要な時間が増えていないことに気が付きました。
そこで、実行後に、含まれる処理を確認しました。
筆者のプロンプト(全文)
run_device_tests_and_save.pyの実行時に、アプリのインストールが含まれているように見えません。確認してください。
回答では、ビルド済みのデバッグAPKを検出して実機へインストールする処理を追加・強化したと報告されています。その後、クリーン再インストールや起動確認、既存の負荷・パフォーマンステストを含む端末テストの実行と、ログ収集へ広げています。
筆者のプロンプト(全文)
run_device_tests_and_save.pyに以下の機能が含まれているかを確認してください。
負荷テスト、パフォーマンステスト
さらに、含められる実装済みテストを確認しています。
筆者のプロンプト(全文)
run_device_tests_and_save.pyに追加できる実装済みのテストが残っているかを確認してください。
Geminiは、単体テスト、負荷・性能、アクセシビリティ、メタデータ、画面遷移、スクリーンショットに関するテストとPython QAを実行・収集対象として列挙しました。これは統合した対象の説明であり、この回答だけで、すべての実機ですべてが合格したとは扱いません。
図3に、インストール処理と既存テストの範囲を確認した課題・解決方法を整理しました。実行対象を増やしたことと、個別テストが合格したことは区別して読みます。
図3 実機への導入・起動確認と、実装済みテストの統合を進めた流れ。Geminiの回答と後続の変更を整理したもので、全端末での成功を示す図ではありません。実行内容と個別ログを照合し、一覧の判定に残る限界は後の節で説明します。
「VERIFIED」の表示から、一覧の更新へ
スクリプトの報告にVERIFIEDと出ていても、目的は一覧の更新まで行うことでした。そこで、変更すべき列を指定し直しています。綴りも当時の原文です。
筆者のプロンプト(全文)
run_device_tests_and_save.pyの
検証リスト & バージョン照合 ( VERIFICATION_LIST.md, versionCode = 32): VERIFIED
の機能は、VERIFICATION_LISTの更新をしたか確認してください。
正しい修正結果は、対応するDevice Name行のOS VersionとApp Versionが正しいことです。App Versioinは、VersionName(VersionCode)の形式です。成功したらResultがNo Issuesになり、失敗したらエラー数を書きます。
回答には、次の具体例が残っています。
Geminiの回答(抜粋)
接続中の実機 (SM-T510) が検出され、VERIFICATION_LIST.md 内の該当行の App Version が 2.0.0(31) から 2.0.0(32) へ正確に自動更新されました。
保存ログでも、この端末の行更新を確認できます。一方、aiwa tab AG10では、端末が返したモデル名JA3-TBA1003が表の名前と一致せず、最初は更新できなかった記録がありました。表へ型番を併記した後には更新成功の記録があります。機材を増やすだけでなく、自動処理が同じ端末を特定できる形に記録を整える必要もありました。
図4に、VERIFIEDの表示と、一覧の該当行を更新する処理の違いを示します。更新する行・列を指定し、保存したファイルの内容まで確認することが必要でした。
図4 報告の表示だけでなく、VERIFICATION_LIST.mdの該当行を実際に更新する違い。SM-T510のアプリ版更新と、AG10のモデル名照合の修正を例にしています。ファイル更新の成功とテスト結果の判定は別です。
10月16日には、一覧とスクリプトなどをtesting・mainの両ブランチへプッシュした実行記録と、公開コミットを確認できます。コミット・プッシュは、スクリプトの中の自動処理ではなく、別途Geminiへ依頼した作業です。
10月17日には、SM-T510、SH-41A、AG10、XQ-ES44、Pixel 8a、SC-53D、XQ-GH44の7機種で、2.0.0(33)として実行・行更新したログが残っています。当時の表に掲載した8機種すべてで、このスクリプトを実行したことを示すものではありません。たとえば、この更新時点のChromebookの行は2.0.0(32)のままで、スマートフォン・タブレット7機種の記録と区別できます。ここでのアプリ版はスクリプトがビルド設定から読み取った値で、各実機のインストール済みAPKとの一致まで、この記録だけで確定したわけではありません。
Chromebookは配布と記録の手順を別に整える
図5に、10月17日の公開一覧を抜粋しました。前節で触れたアプリ版の違いが、実際の記録でどう見えるかを示しています。
図5 10月17日の公開一覧8機種から5機種を抜粋・再配置した例。Chromebookのアプリ版がほかと異なる点に注目してください。OS・アプリ版・結果・備考は当時の記録で、現在の結果を示すものではありません。
Chromebookだけ版が異なっていた理由は、最初は検証の準備が足りなかったからです。このスクリプトは、Play Consoleへ登録する前のアプリをUSB接続した実機へインストールし、テストを実行してからVERIFICATION_LIST.mdを更新する運用でした。一方、ChromebookではUSB接続でAndroidアプリをインストールする機能を実現できず、当時は一覧の更新が遅れていました。
現在は、最新のアプリをPlay Consoleの内部テストで公開し、ChromebookのPlayストアから内部テスト版をインストール、または更新して動作を確認しています。その結果をVERIFICATION_LIST.mdへ手作業で反映することで、以前より早く更新できるようになりました。これは10月16〜17日のスクリプト開発後に整えた現在の運用として、当時の自動処理とは区別して記録します。開始日は今回の説明だけでは特定していません。
図6に、Chromebookで一覧更新が遅れた課題と、後に整えた配布・確認・記録の手順をまとめました。
図6 当時実現できなかったUSB導入経路に代え、内部テスト版をPlayストアから更新し、動作確認後に一覧を手作業で更新する運用。切替開始日は未確認です。Chromebook全般でUSB導入が不可能という説明ではありません。
同じ仕組みを、見開きPDFユーティリティへ展開する
この仕組みは、10月18日に「見開きPDFユーティリティ」へも移植しました。ユーティリティでは編集機能の試験など、ビューアとは異なるテストが必要です。共通化したのは実行・ログ保存・一覧更新の流れで、両アプリで同じ機能を同じ内容で検証したわけではありません。本稿では、別アプリへ展開した点までの補足にとどめます。
一覧の表示と、個別テストの結果を分けて読む
省力化はできましたが、一覧のNo issuesを全テスト合格の証明にはできません。当時のスクリプトは、一覧のResultをPython QAの成否だけで決めており、単体・端末テストのビルド失敗が残っていてもNo issuesと記入した例があります。失敗時も1を記入する実装で、依頼したエラー数の正確な集計にはなっていませんでした。
既存の負荷・パフォーマンステストを実行対象へ加えること、実際のインストールを確認すること、表の更新対象を特定し直すことは、それぞれ検証の抜けを減らすための変更でした。ただし、テスト内容を増やす工夫と、集約した結果の判定が十分かどうかは別に確認する必要があります。
この時点で確認できる成果は、端末を替えながら検証を実行し、結果を保存し、一覧更新を省力化する仕組みを作って利用したことです。信頼性を上げるためには、実際に動かした対象・画面・個別ログと、一覧の表示を対応付けて確認し続ける必要がありました。
図7に、ここまでの検証・記録の流れと、実機で見つけた不足をテストへ戻す関係をまとめました。
図7 検証を実行する仕組みと、実機で気づいた不足をテストへ反映する流れ。詳細ログは手元のlogs/に残し、確認一覧・スクリプト・説明文書をGitHubへ公開しました。コミット・プッシュは別途の作業です。図の具体例はビューアの作業から選んでいます。
今回の教訓:先日Geminiに聞いてみたら、個人開発者は2〜4台の端末を手元に用意することが多いそうだ。あと、Geminiはどのモデル(機種)を用意するといいのかも教えてくれた。そういえば、昔の人が確かこんなことを言っていた。「楽をするために手間を惜しまない」この言葉はアプリ開発にも通じるだろうと思った。
本編の第4回では、同じ時期に進めたサンプルPDFカタログとヘルプの改善を扱います。実機を増やした理由と到着記録は、第2回で紹介しています。
前の記事(本編):【第4回】公開したPDFビューアの「使い始め」を整える――サンプルPDFの入口・取得・表示とヘルプの改善
次の記事(本編):【第5回】PDFビューアの顔と公開用画像を作る――アイコン、フィーチャーグラフィック、チップ画像の制作