pdf

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

依存関係の宣言

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-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 画像がぼやける問題を修正しました。
  • [ファイル内を検索] メニューで、構成が変更されても結果の数が保持されるようになりました。
  • 単一ページの 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 ビューアの統合が簡単になり、ユーザーは以下の方法で操作できるようになります。 <ph type="x-smartling-placeholder">
      </ph>
    • ズーム: ピンチインとピンチアウトでズームレベルを調整したり、ダブルタップしてデフォルトの状態にすばやくズームイン/ズームアウトしたりできます。
    • ナビゲーション: デフォルト状態またはズーム状態でスクロールします。PdfViewerFragment は、ページ間をすばやくスクロールするためのクイック シークバーです。
    • テキストの操作: テキストを長押しするとそのテキストが選択され、現在のページで [コピー] や [すべて選択] などのオプションを使用できるようになります。
    • パスワードで保護されたドキュメント: PdfViewerFragment に、パスワードを入力してドキュメントを開くためのダイアログ ボックスが表示されます。
    • 操作可能なハイパーリンク: ユーザーは PDF 内のハイパーリンクをタップすることで、Web URL やブックマークに移動できます。
    • アノテーション モードへのショートカット: PdfViewerFragment では、編集モードはまだサポートされていません。代わりに、PdfViewerFragment は、ドキュメント URI を指定して暗黙的な android.intent.action.ANNOTATE インテントを起動する FloatingActionButton を表示します。

API の変更

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

既知の問題

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

注

  • compileSdk を 35 5dc41be に更新します。