pdf

  
這個程式庫可在應用程式中加入 PDF 檢視功能。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
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 版包含這些修訂版本。

修正錯誤

  • 從直向轉為橫向，且應用程式進入休眠模式後，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 重疊。
  • 單一頁面的 PDF 不會顯示 FloatingActionButton 圖示。
  • 「在檔案尋找」選單中的設定變更時，結果計數不會保留。
  • 關閉檔案選單中的尋找功能時，會出現畫面閃爍情形
  • 檢視器中不會顯示 PDF 文件中的 3D 圖片，
  • 我們將在後續版本中啟用無障礙功能。
  • PDF 圖片從直向轉成橫向時會模糊不清。
  • 不支援文字/醒目顯示註解。
  • PdfViewerFragment 在處理超大型 PDF 文件 (超過 250 MB) 時有一些效能問題

附註

  • 將 compileSdk 更新為 35 5dc41be