pdf

  
アプリ内に PDF 表示機能を追加するライブラリ。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2024 年 12 月 11 日 - - - 1.0.0-alpha05

依存関係の宣言

pdf への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02"
}

Kotlin

dependencies {
    implementation("androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

このアーティファクトのリリースノートはありません。

バージョン 1.0

バージョン 1.0.0-alpha05

2024 年 12 月 11 日

androidx.pdf:pdf-document-service:1.0.0-alpha05、androidx.pdf:pdf-viewer:1.0.0-alpha05、androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 には、これらの commit が含まれています。

バグの修正

  • このライブラリは、型使用である JSpecify nullness アノテーションを使用するようになりました。Kotlin デベロッパーは、次のコンパイラ オプションを使用して、正しい使用を強制する必要があります。-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode（I38301、b/326456246）
  • Android 13 で、以前に開いたページが回転後に表示されてしまう問題を修正しました。（Ib03dd）
  • 回転時にツールボックスが表示されなくなる問題を修正しました。（01148f）

バージョン 1.0.0-alpha04

2024 年 11 月 13 日

androidx.pdf:pdf-viewer:1.0.0-alpha04 と androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit はこちらをご覧ください。

対応範囲の拡大

  • PDFViewer ライブラリが Android バージョン S、T、U、V に対応するようになりました。この互換性の向上は、SDK 拡張機能 13 のアップデートに関連しています。

API の変更

  • PdfViewerFragment に最小 SdkExtension 制約を追加しました。（I922af）
  • PDF ビューア ライブラリの新しい API を公開。（I0af57）

バグの修正

  • プロセスの終了に関する問題の不具合を修正。
  • パスワード ダイアログに関連する UI を修正しました。
  • findInFileView と FastscrollView のユーザー補助機能を修正しました。

継続的な開発

  • Google では、Jetpack Compose をライブラリに組み込む作業を積極的に進めています。

バージョン 1.0.0-alpha03

2024 年 9 月 18 日

androidx.pdf:pdf-viewer:1.0.0-alpha03 と androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 には、これらの commit が含まれています。

バグの修正

  • 検索を初めて開いたときにキーボードが表示されない問題を解決
  • FindInFile ビューのフォントに関する UI を修正しました。
  • テキスト選択とドラッグハンドルの UI を修正しました。

既知の問題

  • PDF ドキュメント内の 3D 画像はビューアでレンダリングされません。
  • PdfViewerFragment で、非常に大きな PDF ドキュメント（250 MB 超）でパフォーマンスの問題が発生する

バージョン 1.0.0-alpha02

2024 年 9 月 4 日

androidx.pdf:pdf-viewer:1.0.0-alpha02 と androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit はこちらをご覧ください。

バグの修正

  • 縦向きから横向きに回転したときに PDF 画像がぼやける問題と、アプリがスリープ状態になる問題を解決しました。
  • ファイル内検索メニューで、構成が変更されても結果数を維持できるようになりました。
  • 1 ページの PDF で FloatingActionButton アイコンを使用できるようになりました。
  • [ファイル内を検索] バーと FloatingActionButton の重複の問題を修正しました。
  • テキスト アノテーションとハイライト アノテーションをビューアでレンダリングできるようになりました。
  • ファイル内検索バーのユーザー補助機能を改善しました。
  • 回転時の UI の修正が実装されました。検索結果の保持、テキスト選択メニューの消失の問題、FAB の重複の問題の解決などが含まれます。
  • 横向きモードでキーボードの背後に隠れる [ファイル内検索] メニューを修正しました。

既知の問題

  • PDF ドキュメント内の 3D 画像はビューアでレンダリングされません。
  • PdfViewerFragment で、非常に大きな PDF ドキュメント（250 MB 超）でパフォーマンスの問題が発生する

バージョン 1.0.0-alpha01

2024 年 8 月 7 日

androidx.pdf:pdf-viewer:1.0.0-alpha01 と androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 には、これらの commit が含まれています。

新機能

PDFViewer の最初のアルファ版リリースには、コアな PDF 読み取りシナリオを可能にする初期プレビュー実装が含まれています。PdfViewerFragment は現在、Android V（SDK 35）バージョンでのみサポートされています。古い Android バージョンのサポートは、今後のリリースで追加される予定です。

  • アプリで PDF ドキュメントのレンダリングに使用できる PdfViewerFragment を導入しました。PdfViewerFragment を使用すると、アクティビティに PDF ビューアを簡単に統合でき、ユーザーは次の方法で操作できます。
    • ズーム: ピンチ操作でズームレベルを調整して快適な読み上げを実現できます。また、ダブルタップすると、デフォルトの状態に素早くズームイン/ズームアウトできます。
    • ナビゲーション: デフォルト状態またはズーム状態のときにスクロールします。PdfViewerFragment は、ページ間をすばやくスクロールするためのクイック スクリューバーを提供します。
    • テキスト アクション: テキストを長押しすると、そのテキストが選択され、現在のページでコピーやすべて選択などのオプションを使用できるようになります。
    • パスワードで保護されたドキュメント: PdfViewerFragment は、ユーザーがパスワードを入力してドキュメントを開くためのダイアログ ボックスを提供します。
    • 移動可能なハイパーリンク: ユーザーは PDF 内のハイパーリンクをタップして、ウェブ URL やブックマークに移動できます。
    • アノテーション モードへのショートカット: PdfViewerFragment では編集モードはまだサポートされていません。代わりに、PdfViewerFragment は、ドキュメント URI を使用して暗黙的な android.intent.action.ANNOTATE インテントを起動する FloatingActionButton を表示します。

API の変更

  • ドキュメントのファイル URI またはコンテンツ URI を設定してドキュメントの読み込みを開始する PdfViewerFragment.documentUri プロパティを追加しました。PdfViewerFragment は、URI が設定されている場合に読み込みスピナーを表示し、ドキュメントのバックグラウンド処理を示します。
  • PdfViewerFragment.isTextSearchActive を追加して、ファイル内検索メニューの表示 / 非表示を切り替えられるようにしました。PdfViewerFragment は、入力の許可、一致の合計数の表示、結果間の移動、終了など、フロー全体を処理します。
  • ドキュメントのレンダリングが正常に完了した後、またはレンダリング前にエラーがスローされた後に呼び出される onDocumentLoadSuccess コールバックと onDocumentLoadError コールバックを追加しました。

既知の問題

  • ファイル内検索バーが FloatingActionButton と重なることがある。
  • 1 ページの PDF には FloatingActionButton アイコンが表示されません。
  • [ファイル内検索] メニューで設定を変更しても、結果の数が保持されない。
  • ファイル内検索メニューを閉じる際にちらつく
  • PDF ドキュメント内の 3D 画像はビューアでレンダリングされません。
  • ユーザー補助機能は、今後のリリースで有効になります。
  • 縦向きから横向きに回転すると、PDF 画像がぼやける。
  • テキスト/ハイライトのアノテーションはサポートされていません。
  • PdfViewerFragment で、非常に大きな PDF ドキュメント（250 MB 超）でパフォーマンスの問題が発生する

注

  • compileSdk を 35 5dc41be に更新