pdf

  
可在應用程式中新增 PDF 檢視功能的程式庫。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
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-alpha05"
}

Kotlin

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 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 版包含這些修訂項目。

修正錯誤

  • 這個程式庫現在使用 JSpecify 空值註解，這是類型用法。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 版包含這些修訂版本。

擴充相容性

  • PDFViewer 程式庫現在支援 Android 版本 S、T、U 和 V。這項強化的相容性與 SDK 擴充功能 13 的更新相關。

API 變更

  • 已將最小 SdkExtension 限制條件新增至 PdfViewerFragment。(I922af)
  • 為 PDF 檢視器程式庫公開新的 API。(I0af57)。

修正錯誤

  • 修正程序終止問題的當機問題。
  • 修正與密碼對話方塊相關的 UI 問題。
  • 修正 findInFileView 和 FastscrollView 的無障礙功能問題。

持續開發

  • 我們正積極將 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 版包含這些修訂版本。

修正錯誤

  • 解決首次開啟搜尋功能時鍵盤不會顯示的問題
  • 修正與 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 版包含這些修訂項目。

修正錯誤

  • 修正從直向轉為橫向時，應用程式進入休眠狀態，導致 PDF 圖片模糊的問題。
  • 即使設定有所變更，「在檔案中尋找」選單現在仍會保留結果計數。
  • FloatingActionButton 圖示現已可用於單頁 PDF 檔案。
  • 已修正「在檔案中尋找」列和 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 版包含這些修訂版本。

新功能

PDFViewer 的初始 Alpha 版本包含早期預覽版實作，可支援核心 PDF 閱讀情境。請注意，PdfViewerFragment 目前僅支援 Android V (SDK 35) 版本。日後推出的版本將支援舊版 Android。

  • 推出 PdfViewerFragment，讓您的應用程式可以用來算繪 PDF 文件。PdfViewerFragment 可簡化在活動中整合 PDF 檢視器的程序，並讓使用者透過下列方式進行互動：
    • 縮放：雙指撥動可調整縮放等級，提供舒適的閱讀體驗，輕觸兩下即可快速縮放至預設狀態。
    • 導覽：在預設/縮放狀態下捲動。PdfViewerFragment 提供快速瀏覽器，可快速捲動頁面。
    • 文字操作：長按文字即可選取，讓使用者可以使用「複製」和「全選」等選項。
    • 受密碼保護的文件：PdfViewerFragment 會提供對話方塊，讓使用者輸入密碼並開啟文件。
    • 可導覽的超連結：使用者只要輕觸 PDF 中的超連結，即可前往網址或書籤。
    • 註解模式的捷徑：PdfViewerFragment 尚未支援編輯模式。PdfViewerFragment 會改為顯示 FloatingActionButton，以便透過文件 URI 觸發隱含的 android.intent.action.ANNOTATE 意圖。

API 變更

  • 新增 PdfViewerFragment.documentUri 屬性，可設定文件的檔案或內容 URI，並啟動文件載入作業。設定 URI 時，PdfViewerFragment 會顯示載入旋轉圖示，表示文件的背景處理作業。
  • 新增 PdfViewerFragment.isTextSearchActive 可切換「在檔案中尋找」選單的顯示設定。PdfViewerFragment 會處理整個流程，包括允許輸入、顯示相符項目總數、在結果之間導覽及退出。
  • 新增 onDocumentLoadSuccess 和 onDocumentLoadError 回呼，會在成功轉譯文件後，或在轉譯前發生錯誤後叫用。

已知問題

  • 在某些情況下，「在檔案中尋找」列會與 FloatingActionButton 重疊。
  • FloatingActionButton 圖示不會顯示在單頁 PDF 中。
  • 在「在檔案中尋找」選單中，設定變更時不會保留結果計數。
  • 關閉「在檔案中搜尋」選單時，畫面會出現閃爍現象
  • 瀏覽器不會算繪 PDF 文件中的 3D 圖片。
  • 無障礙功能將在後續版本中啟用。
  • 從直向轉為橫向時，PDF 圖片會變得模糊。
  • 不支援文字/醒目註解。
  • PdfViewerFragment 在處理非常大的 PDF 文件 (超過 250 MB) 時，會發生一些效能問題

附註

  • 將 compileSdk 更新為 35 5dc41be