pdf

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên pdf, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

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

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

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Không có ghi chú phát hành cho cấu phần phần mềm này.

Phiên bản 1.0

Phiên bản 1.0.0-alpha10

Ngày 16 tháng 7 năm 2025

Phát hành androidx.pdf:pdf-*:1.0.0-alpha10. Phiên bản 1.0.0-alpha10 bao gồm các thay đổi sau.

Tính năng mới

• Tính năng chọn nâng cao cho phép người dùng chọn văn bản trên nhiều trang bằng cách kéo các ô điều khiển lựa chọn ra ngoài ranh giới trang.
• Giờ đây, các ứng dụng có thể chặn và tuỳ chỉnh cách xử lý các lượt nhấp vào siêu liên kết trong tài liệu PDF.

Thay đổi về API

• Hiển thị một thành phần kết hợp để trình bày nội dung PDF (I8e7ee)
• Di chuyển PdfPoint và PdfRect sang gói androidx.pdf.models (I26cf4)
• Hiển thị một thành phần View để trình bày nội dung PDF (I9fe27)
• Hiển thị API để khởi động trước các tài nguyên PDF và giảm độ trễ khi khởi động nguội (a18fa89)
• Hiển thị API để ghi đè việc xử lý lượt nhấp vào siêu liên kết trên nội dung PDF(6330a8b)
• Hiển thị một cấu phần phần mềm mới là pdf-document-service và các API tương ứng – PdfLoader, PdfDocument và SandboxedPdfLoader. Bạn có thể dùng các giao diện này để triển khai thành phần phân tích cú pháp và xử lý của tài liệu PDF (Ide70d)
• Hiển thị một API để đặt PdfDocument trên PdfView nhằm khởi tạo quá trình kết xuất tài liệu (If8738)

Phiên bản 1.0.0-alpha09

Ngày 7 tháng 5 năm 2025

Phát hành androidx.pdf:pdf-*:1.0.0-alpha09. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.

Các thay đổi lớn

• Cơ sở mã đã được tái cấu trúc đáng kể và hiện được viết hoàn toàn bằng Kotlin, sử dụng Coroutine và ViewModel. Điều này bao gồm việc triển khai lại PdfViewerFragment. Bản phát hành này không có API hoặc tính năng mới.

Vấn đề đã biết:

• Thanh cuộn nhanh và chỉ báo trang bị thiếu hiệu ứng đổ bóng.
• Tài liệu PDF một trang có thể không phải lúc nào cũng được căn giữa và điều chỉnh tỷ lệ theo chiều rộng của khung hiển thị.

Thay đổi về API

• Chú giải containerStyleResId bằng @StyleRes. (I88d85)

Phiên bản 1.0.0-alpha08

Ngày 12 tháng 3 năm 2025

Phát hành androidx.pdf:pdf-document-service:1.0.0-alpha08, androidx.pdf:pdf-viewer:1.0.0-alpha08 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha08. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.

Sửa lỗi

• Đã khắc phục vị trí không nhất quán của trình đơn lựa chọn giữa các thiết bị Android do sự khác biệt về tỷ lệ. Vị trí của trình đơn lựa chọn hiện nhất quán trên các thiết bị.
• Căn chỉnh vị trí của chỉ báo trang và thanh cuộn nhanh khi tạo lại mảnh trong các trường hợp như thay đổi cấu hình, v.v.

Phiên bản 1.0.0-alpha07

Ngày 26 tháng 2 năm 2025

Phát hành androidx.pdf:pdf-document-service:1.0.0-alpha07, androidx.pdf:pdf-viewer:1.0.0-alpha07 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha07. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.

Tính năng mới

• PdfViewerFragment hiện hỗ trợ StylingOptions (một tập hợp các mã nhận dạng tài nguyên kiểu) cho phép tạo kiểu tuỳ chỉnh thông qua newInstance hoặc XML (FragmentContainerView). Các lớp con có thể sử dụng hàm khởi tạo được bảo vệ cho chức năng tương tự.
• StylingOptions hiện có containerStyle cung cấp:
  • Hỗ trợ đối tượng có thể vẽ tuỳ chỉnh cho chỉ báo trang và tay cầm cuộn nhanh.
  • Thuộc tính marginEnd để định vị chính xác chỉ báo trang và tay cầm cuộn nhanh.

Thay đổi về API

• Đã thêm các thuộc tính công khai từ PdfView (I30fc5)
• Thêm các API StylingOptions mới cho chế độ xem pdf. (Id2993)

Sửa lỗi

• Đã khắc phục sự khác biệt về việc đồng bộ hoá giữa trạng thái hiển thị của chỉ báo trang và tay cầm cuộn nhanh.

Phiên bản 1.0.0-alpha06

Ngày 29 tháng 1 năm 2025

Phát hành androidx.pdf:pdf-document-service:1.0.0-alpha06, androidx.pdf:pdf-viewer:1.0.0-alpha06 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha06. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.

Sửa lỗi

• Khắc phục: Sự cố do IllegalArgumentException gây ra khi huỷ liên kết một dịch vụ chưa đăng ký (eb4e85)
• Khắc phục: Sự cố IllegalArgumentException do sự khác biệt giữa mMaxPages và numPages. (75d763)

Phiên bản 1.0.0-alpha05

Ngày 11 tháng 12 năm 2024

Phát hành androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Sửa lỗi

• Thư viện này hiện sử dụng chú giải về giá trị rỗng JSpecify, là loại sử dụng. Nhà phát triển Kotlin nên sử dụng đối số trình biên dịch sau đây để thực thi việc sử dụng chính xác: -Xjspecify-annotations=strict (đây là đối số mặc định bắt đầu từ phiên bản 2.1.0 của trình biên dịch Kotlin). (I38301, b/326456246)
• Khắc phục lỗi trang đã mở trước đó xuất hiện sau khi xoay màn hình trên Android 13. (Ib03dd)
• Khắc phục lỗi Hộp công cụ biến mất khi xoay. (01148f)

Phiên bản 1.0.0-alpha04

Ngày 13 tháng 11 năm 2024

Phát hành androidx.pdf:pdf-viewer:1.0.0-alpha04 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Khả năng tương thích mở rộng

• Thư viện PDFViewer hiện hỗ trợ các phiên bản Android S, T, U và V. Khả năng tương thích nâng cao này được liên kết với bản cập nhật tiện ích SDK 13.

Thay đổi về API

• Đã thêm điều kiện ràng buộc tối thiểu SdkExtension vào PdfViewerFragment. (I922af)
• Khai báo các API mới cho thư viện Trình xem PDF. (I0af57)

Sửa lỗi

• Khắc phục sự cố liên quan đến vấn đề bị buộc tắt.
• Các bản sửa lỗi giao diện người dùng liên quan đến hộp thoại mật khẩu.
• Các bản sửa lỗi về khả năng hỗ trợ tiếp cận cho findInFileView và FastscrollView.

Đang phát triển

• Chúng tôi đang tích cực nỗ lực để tích hợp Jetpack Compose vào thư viện.

Phiên bản 1.0.0-alpha03

Ngày 18 tháng 9 năm 2024

Phát hành androidx.pdf:pdf-viewer:1.0.0-alpha03 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Sửa lỗi

• Đã khắc phục lỗi bàn phím không xuất hiện khi mở tính năng tìm kiếm lần đầu tiên
• Các bản sửa lỗi giao diện người dùng liên quan đến phông chữ của chế độ xem FindInFile.
• Bản sửa lỗi giao diện người dùng cho tính năng chọn văn bản và ô điều khiển kéo.

Lỗi đã biết

• Hình ảnh 3D trong tài liệu PDF không được kết xuất trong trình xem.
• PdfViewerFragment gặp một số vấn đề về hiệu suất trên các tài liệu PDF có kích thước rất lớn (> 250 MB)

Phiên bản 1.0.0-alpha02

Ngày 4 tháng 9 năm 2024

Phát hành androidx.pdf:pdf-viewer:1.0.0-alpha02 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Sửa lỗi

• Đã giải quyết vấn đề hình ảnh PDF bị mờ khi xoay từ chế độ dọc sang chế độ ngang và ứng dụng chuyển sang chế độ ngủ.
• Trình đơn tìm trong tệp hiện duy trì số lượng kết quả ngay cả khi cấu hình thay đổi.
• Biểu tượng FloatingActionButton hiện có cho tệp PDF một trang.
• Đã khắc phục các vấn đề trùng lặp giữa thanh Tìm trong tệp và FloatingActionButton.
• Giờ đây, bạn có thể hiển thị chú thích văn bản và chú thích đánh dấu trong trình xem.
• Chúng tôi đã cải thiện khả năng hỗ trợ tiếp cận cho thanh Tìm trong tệp.
• Chúng tôi đã triển khai các bản sửa lỗi về giao diện người dùng cho chế độ xoay, bao gồm cả việc giữ nguyên số lượng kết quả tìm kiếm, giải quyết vấn đề trình đơn chọn văn bản biến mất và giải quyết vấn đề FAB bị chồng chéo.
• Đã khắc phục lỗi trình đơn tìm trong tệp bị ẩn sau bàn phím ở chế độ ngang.

Lỗi đã biết

• Hình ảnh 3D trong tài liệu PDF không được kết xuất trong trình xem.
• PdfViewerFragment gặp một số vấn đề về hiệu suất trên các tài liệu PDF có kích thước rất lớn (> 250 MB)

Phiên bản 1.0.0-alpha01

Ngày 7 tháng 8 năm 2024

Phát hành androidx.pdf:pdf-viewer:1.0.0-alpha01 và androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Bản phát hành alpha ban đầu của PDFViewer bao gồm các phương thức triển khai xem trước ban đầu cho phép các trường hợp đọc PDF cốt lõi. Xin lưu ý rằng PdfViewerFragment hiện chỉ được hỗ trợ trên các phiên bản Android V (SDK 35). Chúng tôi sẽ hỗ trợ các phiên bản Android cũ trong các bản phát hành sắp tới.

• Giới thiệu PdfViewerFragment mà ứng dụng của bạn có thể dùng để hiển thị một tài liệu PDF. PdfViewerFragment giúp đơn giản hoá việc tích hợp trình xem PDF vào Hoạt động của bạn và cho phép người dùng tương tác theo những cách sau:
  • Thu phóng: Chụm hai ngón tay để điều chỉnh mức thu phóng cho trải nghiệm đọc thoải mái, cũng như nhấn đúp để nhanh chóng phóng to/thu nhỏ về trạng thái mặc định.
  • Thao tác di chuyển: Di chuyển ở trạng thái mặc định/thu phóng. PdfViewerFragment cung cấp một thanh tua nhanh để di chuyển nhanh giữa các trang.
  • Thao tác với văn bản: Khi người dùng nhấn và giữ văn bản, văn bản đó sẽ được chọn, cho phép người dùng sử dụng các lựa chọn như Sao chép và Chọn tất cả trên trang hiện tại.
  • Tài liệu được bảo vệ bằng mật khẩu: PdfViewerFragment cung cấp một hộp thoại để người dùng nhập mật khẩu và mở tài liệu.
  • Siêu liên kết có thể điều hướng: Người dùng có thể chuyển đến URL trên web hoặc dấu trang bằng cách nhấn vào siêu liên kết trong tệp PDF.
  • Lối tắt đến chế độ chú thích: Chế độ chỉnh sửa chưa được hỗ trợ trong PdfViewerFragment. Thay vào đó, PdfViewerFragment sẽ hiển thị một FloatingActionButton kích hoạt ý định android.intent.action.ANNOTATE ngầm ẩn bằng URI tài liệu.

Thay đổi về API

• Thêm thuộc tính PdfViewerFragment.documentUri để đặt URI của tệp hoặc nội dung cho tài liệu và bắt đầu tải tài liệu. PdfViewerFragment sẽ hiển thị một vòng quay tải khi URI được đặt, cho biết quá trình xử lý tài liệu ở chế độ nền.
• Đã thêm PdfViewerFragment.isTextSearchActive để bật/tắt chế độ hiển thị của trình đơn tìm trong tệp. PdfViewerFragment xử lý toàn bộ quy trình – cho phép nhập, hiển thị tổng số kết quả trùng khớp, cho phép di chuyển giữa các kết quả và thoát khỏi quy trình.
• Đã thêm các lệnh gọi lại onDocumentLoadSuccess và onDocumentLoadError được gọi sau khi tài liệu hiển thị thành công hoặc sau khi xảy ra lỗi trước khi hiển thị.

Lỗi đã biết

• Thanh tìm trong tệp trùng với FloatingActionButton trong một số trường hợp.
• Biểu tượng FloatingActionButton không xuất hiện đối với tệp PDF một trang.
• Số lượng kết quả không được giữ lại khi thay đổi cấu hình trong trình đơn tìm trong tệp.
• Hiện tượng nhấp nháy xảy ra khi đóng trình đơn tìm trong tệp
• Hình ảnh 3D trong tài liệu PDF không được kết xuất trong trình xem.
• Các tính năng hỗ trợ tiếp cận sẽ được bật trong những bản phát hành sau.
• Hình ảnh PDF bị mờ khi xoay từ hướng dọc sang hướng ngang.
• Không hỗ trợ chú thích văn bản/văn bản đánh dấu.
• PdfViewerFragment gặp một số vấn đề về hiệu suất trên các tài liệu PDF có kích thước rất lớn (> 250 MB)

Lưu ý

• Cập nhật compileSdk thành 35 5dc41be