連載ストックリスト:Android版「見開きPDFビューア」開発記録
この記事は、ChatGPTと壁打ちしながら、Android Studio内のGeminiの会話履歴、Gitの変更履歴・ソースコード、保存した検証記録、Play Consoleの表示を調べて作成しました。
Android版「見開きPDFビューア」のVer.2.0.0を、2026年10月19日に公開しました。第4回で紹介したサンプルPDFカタログやヘルプに続き、起動直後の案内と更新版を知らせる仕組みを整え、海外配布に向けて翻訳も見直しました。
第10回までに振り返った動画制作と並行して、アプリ側では何を変えていたのか。今回はVer.2.0.0の公開直後にさかのぼり、10月29日にUS・韓国を配布対象に加えてVer.2.1.0を公開するまでをたどります。
図1:翻訳と海外配布の準備から、Ver.2.1.0の公開まで
作業の日付と根拠
図1は本文の3つの大項目に対応し、表は主な作業の日付と根拠を示します。日付は2026年です。Gitの時刻は日本時間、Play Consoleの時刻は画面の表示値です。Consoleのタイムゾーン設定は未確認のため、両者の時刻を直接比べて前後を判断することはできません。本文と図は話題別に整理しており、たとえば公開準備で扱うサンプルPDFの追加は10月27日から始めていました。
| 日付・時刻 | 作業・節目 | 根拠 |
|---|---|---|
| 10月19日 19:10 | Ver.2.0.0(33)を製品版として公開 | Play Console |
| 10月25〜26日 | プライバシーポリシー画面を追加。言語資産の不足・英語との混在を確認して修正 | 会話・Git |
| 10月27日 | 海外配布に必要な変更を相談し、韓国語などのヘルプを補完 | 会話・Git |
| 10月28日 | 起動時チュートリアルと更新確認機能を追加 | 会話・Git |
| 10月29日 2:37 | 画面回転でチュートリアルが再表示される問題の修正をコミット | Git |
| 10月29日 6:31 | 配布対象にアメリカ合衆国を追加する変更を記録 | Consoleのログ |
| 10月29日 6:37 | 配布対象に韓国を追加する変更を記録 | Consoleのログ |
| 10月29日 7:42 | Ver.2.1.0、versionCode 38の変更をコミット | Git |
| 10月29日 10:01 | Ver.2.1.0(38)を製品版として公開 | Play Console |
翻訳と海外配布の準備
アプリの中にも、プライバシーポリシーを置く
10月25日には、アプリ内からプライバシーポリシーを読める画面の仕様を相談しました。
筆者のプロンプト(全文)
プライバシーポリシー画面を追加したいので、仕様を考えてください。
Geminiは、Webに置いていた説明をアプリ内へ組み込み、既存のヘルプやライセンス画面とそろえる案を出しました。続けて全言語への対応も依頼しています。
同日の変更では、バージョン画面から説明を開けるようにし、この画面の文字列を既存の14言語分のリソースに加えました。説明の中心は、PDFを端末内で処理すること、ログは自動で外部送信しないこと、ユーザーが選んだファイルへアクセスすることです。ここで記録しているのは、その説明画面を追加した経緯です。
図2に、バージョン画面から説明を開く経路と、画面に追加した内容を示します。
図2:アプリ内のプライバシーポリシー画面と、14言語分の説明文
「キーがそろっている」と「翻訳されている」は違った
言語を増やす経緯は、第2回と第4回で紹介しました。この時点では14言語分の文字列ファイルを持っていましたが、画面を追加するたびに、それぞれの言語で説明もそろえる必要があります。
10月25日、次のように確認しました。
筆者のプロンプト(全文)
英語と日本語だけが用意されている翻訳のリソースが残っていないか確認してください。
Geminiの回答(抜粋)
プロジェクト全体の翻訳リソース(アプリ内文字列、Webドキュメント、ストア掲載情報)を網羅的に確認いたしました。結果として、「英語と日本語だけにしか翻訳が存在しないリソース」は残っていません。
しかし、未定義のキーを調べて英語から補う作業と、各言語へ翻訳する作業は同じではありません。その後、質問を変えています。
筆者のプロンプト(全文)
各言語ファイルに英語のまま未翻訳のキーがあるか、確認してください。
Geminiの回答(抜粋)
一方で、詳細なヘルプ項目や診断機能の説明文など 32個のヘルプ文字列(例: help_open, help_navigate, help_search, help_diagnostics など)については、現在英語のテキストのままになっています(一部は translatable="false" 指定されています)。
Geminiの回答にも、英語の文章を入れたままのヘルプが出てきました。日本語や各言語への翻訳・調整を改めて依頼し、翌26日にも英語と日本語の混在や、画面へ直接書かれた日本語を直しています。
今回の原稿作成で当時のスクリプトも読み直すと、check_translations.pyは各言語のキーの有無を比較する処理でした。fix_missing_translations.pyは不足分にデフォルトの英語を追加する処理で、翻訳を生成するものではありません。
そのため、チェックが成功したことは「項目が欠けていない」ことを示します。訳文の内容と、実際に画面に出る文章も、それぞれ確認する必要がありました。図3は、この3つを確かめるときに、何を見ればよいかを整理したものです。全言語・全画面を当時検証し終えたという結果表ではありません。
図3:翻訳キーの有無、訳文の内容、実際の画面表示で確かめること
海外配布を考え、韓国語などの説明を補う
10月27日には、販売する国を広げる場合に、アプリ側で何を変える必要があるかをGeminiへ尋ねました。
筆者のプロンプト(全文)
アプリを販売する国に、米国、韓国、台湾、EUを追加する場合に、アプリの変更が必要な点がないか確認してください。
この段階で相談した候補には、米国・韓国のほか、台湾とEUも含まれていました。Geminiは、すでにある言語資産を挙げる一方、韓国語のヘルプなどに英語で残っている部分があると説明しました。
筆者のプロンプト(全文)
韓国語リソースの未翻訳部分の補完を進めてください。他の言語でも同様に進めてください。
Geminiの回答(抜粋)
ご要望の通り、韓国語リソースの未翻訳部分(設定・ヘルプ関連の文言)の補完を実施しました。さらに、米国の英語、台湾の繁体字中国語、EU各国の主要言語(ドイツ語、フランス語、スペイン語、ポルトガル語など)およびその他の対応言語についても、同様に未翻訳だったヘルプ文言の翻訳を完了させました。
10月27日のGitには、韓国語を含む各言語のヘルプや設定の文章を補った変更が残っています。ただし、回答にある「翻訳を完了」という言葉を、そのまま全画面の品質確認へ広げることはできません。後から新しい画面や文言を追加すると、また英語が残ることがありました。
公開したVer.2.1.0(38)のコードを確認すると、14言語の文字列ファイルはそれぞれ178キーを持っています。その一方で、次の「チュートリアルを表示」と「更新を確認」は、韓国語のリソースでも英語の値でした。図3でいう、キーはあっても訳文に確認が必要な例です。
| キー | 日本語ファイルの値 | 韓国語ファイルの値 |
|---|---|---|
| view_tutorial | チュートリアルを表示 | View Tutorial |
| check_for_updates | 更新を確認 | Check for Updates |
韓国語ファイルがあっても、各項目を韓国語で読めるとは限りません。アプリ名など、言語が違っても同じ表記が適切な項目もあるため、英語と同じ値の数だけで翻訳漏れを数えてはいません。
図4では、10月27日に補った説明と、公開版に残っていた英語の値を分けて示します。
図4:海外配布の相談、ヘルプ・設定の補完、公開版に残った英語の文言
初回案内と更新確認
起動直後に、使い方と紹介動画への入口を用意する
10月28日には、最初にアプリを開いたときの案内を追加しました。第4回で用意したサンプルやヘルプに加え、起動直後にも使い方が分かるようにしました。
筆者のプロンプト(全文)
アプリの起動時に開くチュートリアル画面を作る計画を立ててください。アプリの操作方法を簡単に説明する内容です。スキップするボタン/リンクと、次回から開かないのチェックボックスを追加してください。YouTubeに紹介動画を用意したので、チュートリアル画面に動画を見るボタン/リンクを追加してください。そのボタン/リンクをタップしたら、YouTubeアプリで動画を開いてください。動画のURLはhttps://youtube.com/shorts/fYch_X1KzOo
Geminiが提案した計画を確認し、「進めてください」と依頼した後、次の完了報告が返りました。
Geminiの回答(抜粋)
起動時チュートリアル画面の実装を完了しました!
追加したのは、見開き・右綴じ、目次、検索などの特徴を説明する、スクロールできる1画面のチュートリアルです。スキップして読書へ進む操作と、「次回から開かない」という設定、YouTube紹介動画へのボタンを用意しました。
この引用の動画URLは依頼時点のものです。途中では、内部テスト版で動画ボタンを押しても再生できないという指摘もしています。保存コードには、外部アプリを開けなかった場合に例外を捕捉し、メッセージを表示する処理が入りました。原因となった個々の端末条件まで、今回の記録からは特定していません。
アイコン更新に合わせた紹介動画の再作成とリンクの変更も続き、公開したVer.2.1.0(38)では参照先がhttps://youtube.com/shorts/ethgkyCJqbIになっています。この節で扱うのは、紹介動画をアプリから開くための実装です。操作説明動画4本と連続再生版の制作・確認は、第9・10回で扱います。
また、10月29日にはヘルプの先頭に「チュートリアルを表示」ボタンを追加しました。最初の案内を閉じた後にも、必要なときに見直せるようにしています。
図5に、起動時とヘルプから案内を開き、紹介動画や読書へ進む流れを示します。
図5:起動時とヘルプから開くチュートリアルと、紹介動画への入口
「いったん閉じた」と「次回から開かない」を分ける
チュートリアルを追加すると、画面回転で表示が戻る問題が出ました。
筆者のプロンプト(全文)
チュートリアルでSkipを選択してメイン画面に移動したあと、端末を回転させるとチュートリアルが表示されます。
Geminiの回答(抜粋)
- remember を rememberSaveable(tutorialDismissed)に変更しました。
「次回から開かない」にチェックを入れず、今回だけスキップした場合、次回起動時にチュートリアルを表示する設定は変わりません。しかし、画面を回転しただけで、また案内を見せるのは期待する動きではありませんでした。
修正では、設定の保存とは別に、この起動中に案内を閉じたという状態をrememberSaveableで保持しています。10月29日2:37のコミットに、その変更が残っています。図6では、スキップと次回表示設定の違いを上段に、画面回転時の動作の変化を下段に示します。
図6:スキップと次回表示設定の違い、画面回転による再表示の修正
更新版があることも、アプリから伝える
更新確認の依頼も、画面回転の修正に先立つ10月28日の会話に残っています。Google Playに更新版があることを、アプリから知らせるためです。
筆者のプロンプト(全文)
Google Playストアでアプリの更新版が公開されているか確認して、更新版がある場合はメイン画面のトップバーに今すぐ更新ボタンを表示してください。今すぐ更新ボタンをタップしたら、Playストアのこのアプリのページに移動してください。バージョン画面に、更新を確認ボタンを追加してください。更新版がある場合は、ボタンの表示を今すぐ更新に変更してください。今すぐ更新ボタンをタップしたら、Playストアのこのアプリのページに移動してください。短時間に連続で更新を確認しないように、次の更新確認まで待ち時間を設定してください。
Geminiの回答(抜粋)
- 短時間の連続チェック防止(クールダウン機能): 5分間の待ち時間(クールダウン)を設定し、短時間に連続して更新チェックが行われないようにレートリミットをかけています。
実装ではGoogle PlayのAppUpdateManagerで更新の有無を調べます。更新版があればトップバーやバージョン画面に「今すぐ更新」を表示し、利用者が押すとPlayストアのアプリページを開きます。ダウンロードとインストールはPlayストアで行います。
保存コードには5分の待ち時間があり、自動の確認へ適用されます。一方、バージョン画面の手動確認はforce = trueで呼び出し、その待ち時間を通さない実装でした。
Geminiからは、デバッグビルドと単体テスト成功の報告が返っています。履歴でもそれらのタスクの成功は確認できますが、各国のPlayストアで実際に更新が提示されるところまで網羅した証拠とは分けています。図7は、保存コードで確認した更新確認と案内の流れです。
図7:自動・手動の更新確認と、Playストアへの案内
Ver.2.1.0の公開
最適化の設定と、公開用素材もそろえる
公開に向けて、ビルドの設定と掲載用の素材も整えました。ビルドの設定では、R8とProGuardを見直すよう依頼しました。
筆者のプロンプト(全文)
リファクタリングしてください。R8 フルモードの有効化 ( gradle.properties)とProGuard / R8 ルールの最適化を実施してください。
Geminiの回答(抜粋)
ご要望に合わせて、R8 フルモードの有効化 および ProGuard / R8 ルールの最適化 のリファクタリングを実施し、リリースビルドのコンパイル成功を確認しました!
Ver.2.1.0(38)の保存設定には、android.enableR8.fullMode=true、リリースビルドのコード縮小、未使用リソースの削減が残っています。履歴にもリリースビルドの成功があります。アプリのメモリ使用量や表示速度がどの程度改善したかの実測とは区別します。
10月29日には、新しいアプリアイコンへの差し替え、紹介動画の再作成、GitHub Pagesのデザイン更新も依頼しています。Play Consoleのログでも、同日6:07に高解像度アイコンとフィーチャーグラフィックを変更した記録が確認できました。画像の制作そのものは第5回、ストア画像の撮影・登録の詳しい話は第5回補足へ分けます。
サンプルPDFも追加しました。第3話の日本語・英語は10月27日、韓国語・簡体字中国語・繁体字中国語は10月29日に登録する変更があり、Ver.2.1.0(38)の配信用フォルダには、この5言語の第3話が入っています。第3話の14言語分がそろうのは10月31日の変更なので、公開時点の内容へ含めません。
図8に、ビルド設定、掲載素材、サンプルPDFの準備を分けてまとめました。
図8:ビルド設定・公開用素材・第3話のサンプルPDFの準備
同じ2.1.0のまま、公開用ビルドを更新する
公開準備では、versionNameを変えずにversionCodeを上げる依頼を繰り返しました。例えば、次の依頼が残っています。
筆者のプロンプト(全文)
versionNameは変えないで、versionCodeを上げてください。Play Console登録用のApp Bundleをビルドしてください。リリースノートをstore_listing/changelog/以下に作成してください。GitHub ActionsのCIテストがパスできるか確認してください。
Ver.2.1.0の準備中の変更を、主なものに絞ると次のようになります。
| versionCode | 公開までに含まれた主な変更 |
|---|---|
| 34 | 起動時チュートリアル、更新確認機能などの初期実装 |
| 35 | 画面回転によるチュートリアル再表示の修正を含む更新 |
| 36 | 表示文字列の整理、ヘルプからの案内再表示、アイコン・紹介ページの更新 |
| 37 | 韓国語・中国語2種のサンプルPDF第3話を追加 |
| 38 | 作者名の英語表記をKomairo Hiyoriへ統一した最終ビルド |
これは準備中の変更の整理であり、すべてのビルドを一般公開したという表ではありません。Play Consoleの製品版履歴では、34〜37のリリース日欄は「-」で、Ver.2.1.0として公開日時を確認できたのは38でした。最後のリリースノートは作者名の修正など直前の差分が中心だったため、新機能はその前の変更も合わせてたどっています。
図9に、同じVer.2.1.0のもとでビルドを更新し、38を公開するまでを示します。
図9:versionNameを保ったまま、versionCode 34から38へ進めた流れ
US・韓国を追加し、Ver.2.1.0を公開する
実際の配布先は、Play Consoleのアクティビティログとリリース詳細から確認しました。アクティビティログには、10月29日6:31に「対象国」「追加済み アメリカ合衆国」、6:37に「対象国」「追加済み 韓国」と記録されています。
そして、同日10:01にVer.2.1.0(versionCode 38)を公開しました。リリース詳細には「すべての対象国で段階的な公開(100%)を開始しました」という履歴があり、3か国で公開されていたことも表示されています。11月1日に確認した配布対象も、日本・US・韓国の3か国/地域でした。
図1の公開欄にはPlay Console上の配布対象の追加と製品版の公開を示し、最終ビルドのコミット時刻は冒頭の表にGitの記録として載せています。
Ver.2.1.0には14言語分の文字列リソースがあり、公開時の配布先は日本・US・韓国の3か国でした。台湾とEUは、この時点では検討段階でした。図10に、アプリ内の言語リソースとGoogle Playでの配布範囲を整理しました。
図10:Ver.2.1.0公開時の言語リソース、配布先、検討先
使ってもらうための改善は、公開後も続く
Ver.2.0.0では、サンプルを見つけ、PDFを開き、ヘルプを読める入口を整えていました。Ver.2.1.0では、その入口を起動直後の案内へ広げ、更新版を知らせる導線と、海外へ配布する準備を加えました。
その一方で、公開したVer.2.1.0(versionCode 38)のチュートリアルは1画面版で、Welcome to Mihiraki PDF Viewerなどの英語が直接書かれた状態でした。「178キーがそろう」という確認だけでは、この画面を各言語で読めることまで確かめられません。今回の振り返りでも、AIの完了報告と、保存コードから分かる到達点を区別しました。
図11に、公開までに整えた入口と、次の地域別対応につながった課題をまとめました。
図11:Ver.2.0.0からVer.2.1.0へ進み、第12・13回の地域別対応へ
公開版には、韓国語のリソースに英語の文言が残るなど、海外へ配布した後にも確かめたい点がありました。第12回では、11月1日からの相談をもとに、地域ごとの表現・アプリ名・紹介文をどう見直したかを振り返ります。第13回では、訳文や実機の画面、サンプルPDFを確かめ、日米韓の応援価格の決定から他地域の初期価格の登録までを扱います。
今回の教訓:対応言語の数や「完了」という回答だけで判断せず、項目があること、説明が読めること、使い方にたどり着けること、配布先が設定されていることを、それぞれ確かめる。
関連する記事
第4回:公開したPDFビューアの「使い始め」を整える――サンプルPDFの入口・取得・表示とヘルプの改善
第5回:PDFビューアの顔と公開用画像を作る――アイコン、フィーチャーグラフィック、チップ画像の制作
ストア用スクリーンショットの撮影・登録は、第5回補足で詳しく扱います。