pdf

pdf

  

Tài liệu tham khảo API
androidx.pdf.viewer.fragment

Thư viện để thêm các tính năng xem tệp PDF bên trong ứng dụng.

Bản cập nhật mới nhất	Bản phát hành ổn định	Bản phát hành dùng thử	Bản phát hành beta	Bản phát hành alpha
Ngày 13 tháng 11 năm 2024	-	-	-	1.0.0-alpha04

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:

Groovy

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

Kotlin

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

Để 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-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.

Mở rộng khả năng tương thích

• 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 SdkExtension tối thiểu vào PdfViewerFragment. (I922af)
• Hiển thị các API mới cho thư viện Trình xem PDF. (I0af57)

Sửa lỗi

• Khắc phục sự cố cho 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.
• Sửa lỗi 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 thành phần hiển thị FindInFile.
• Sửa lỗi giao diện người dùng cho lựa 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 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

• Khắc phục vấn đề hình ảnh PDF bị mờ khi xoay từ hướng dọc sang hướng 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ó sẵn cho tệp PDF một trang.
• Khắc phục các vấn đề chồng chéo giữa thanh Tìm trong tệp và FloatingActionButton.
• Giờ đây, bạn có thể hiển thị văn bản và chú thích làm nổi bật trong trình xem.
• Chúng tôi đã cải tiến khả năng hỗ trợ tiếp cận cho thanh Tìm trong tệp.
• Các bản sửa lỗi giao diện người dùng đã được triển khai cho tính năng xoay, bao gồm việc giữ nguyên số lượt tìm, giải quyết trình đơn lựa chọn văn bản biến mất và giải quyết vấn đề FAB chồng chéo.
• Khắc phục lỗi trình đơn tìm trong tệp ẩ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 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 bản xem trước sớm 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ị tài liệu PDF. PdfViewerFragment đơn giản hoá việc tích hợp trình xem PDF vào Hoạt động và cho phép người dùng tương tác theo những cách sau:
  • Phóng to: Chụm vào và ra để điều chỉnh mức thu phóng nhằm mang lại trải nghiệm đọc thoải mái, cũng như nhấn đúp để phóng to/thu nhỏ nhanh về trạng thái mặc định.
  • Điều hướng: Di chuyển ở trạng thái mặc định/thu phóng. PdfViewerFragment cung cấp một bộ lọc nhanh để cuộn nhanh giữa các trang.
  • Thao tác với văn bản: Nhấn và giữ văn bản để chọn văn bản đó, cho phép người dùng sử dụng các tuỳ 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ể điều hướng đến URL 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 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 tệp hoặc nội dung cho tài liệu và bắt đầu tải tài liệu. PdfViewerFragment hiển thị một vòng quay đang 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ộ luồng – 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 luồng.
• Thêm lệnh gọi lại onDocumentLoadSuccess và onDocumentLoadError được gọi sau khi hiển thị thành công tài liệu hoặc sau khi lỗi được gửi trước khi hiển thị.

Lỗi đã biết

• Thanh Tìm trong tệp chồng chéo với FloatingActionButton trong một số trường hợp.
• Biểu tượng FloatingActionButton không hiển thị đối với tệp PDF một trang.
• Số lượng kết quả không được giữ nguyên khi thay đổi cấu hình trong trình đơn tìm trong tệp.
• Hiện tượng nhấp nháy được quan sát thấy trong 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 các 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ú giải văn bản/nhấn mạnh.
• PdfViewerFragment gặp một số vấn đề về hiệu suất trên các tài liệu PDF rất lớn (> 250 MB)

Lưu ý

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