pdf

  
可在應用程式中新增 PDF 檢視功能的程式庫。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2025 年 5 月 7 日 - - - 1.0.0-alpha09

宣告依附元件

如要為 PDF 新增依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

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

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

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

1.0 版本

1.0.0-alpha09 版本

2025 年 5 月 7 日

發布 androidx.pdf:pdf-*:1.0.0-alpha09。1.0.0-alpha09 版包含這些修訂版本。

重大異動

  • 程式碼庫已經過重大重構，現在完全以 Kotlin 編寫，並利用協同程式和 ViewModel。這包括重新實作 PdfViewerFragment。此版本不包含任何新 API 或功能。

已知問題：

  • 快速捲動器和頁面指標缺少陰影效果。
  • 單頁 PDF 文件不一定會居中顯示，且可能會縮放至視圖的寬度。

API 變更

  • 使用 @StyleRes 為 containerStyleResId 加上註解。(I88d85)。

1.0.0-alpha08 版本

2025 年 3 月 12 日

發布 androidx.pdf:pdf-document-service:1.0.0-alpha08、androidx.pdf:pdf-viewer:1.0.0-alpha08 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha08。1.0.0-alpha08 版包含這些修訂項目。

修正錯誤

  • 解決不同 Android 裝置之間因縮放差異而導致的選取選單位置不一致問題。選單位置現在在所有裝置上都一致。
  • 在設定變更等情況下，對齊片段重建的快速捲動器和網頁指標位置。

1.0.0-alpha07 版本

2025 年 2 月 26 日

發布 androidx.pdf:pdf-document-service:1.0.0-alpha07、androidx.pdf:pdf-viewer:1.0.0-alpha07 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha07。1.0.0-alpha07 版包含這些修訂項目。

新功能

  • PdfViewerFragment 現在支援 StylingOptions (一組樣式資源 ID)，可透過 newInstance 或 XML (FragmentContainerView) 啟用自訂樣式。子類別可利用受保護的建構函式提供類似功能。
  • StylingOptions 目前會接收 containerStyle，後者提供以下資訊：
    • 快速捲動手把和頁面指標的自訂可繪項目支援。
    • marginEnd 屬性可精確定位快速捲動手把和頁面指標。

API 變更

  • 新增 PdfView 的公開屬性 (I30fc5)
  • 新增了用於 PDF 檢視的 API StylingOptions。(Id2993)。

修正錯誤

  • 修正快速捲動手柄與頁面指標可見度狀態之間的同步差異。

1.0.0-alpha06 版本

2025 年 1 月 29 日

發布 androidx.pdf:pdf-document-service:1.0.0-alpha06、androidx.pdf:pdf-viewer:1.0.0-alpha06 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha06。1.0.0-alpha06 版包含這些修訂項目。

修正錯誤

  • 修正：當解除繫結未註冊的服務時，IllegalArgumentException 會導致當機 (eb4e85)
  • 修正：由於 mMaxPages 和 numPages 有差異，導致 IllegalArgumentException 當機。(75d763)

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 (這是 Kotlin 編譯器 2.1.0 版起的預設值)。(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