pdf

  
Thư viện để thêm tính năng xem 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 4 tháng 9 năm 2024 - - - 1.0.0-alpha02

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-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

  • Chúng tôi đã khắc phục sự cố ảnh PDF bị mờ khi xoay từ dọc sang ngang và ứng dụng chuyển sang chế độ ngủ.
  • Giờ đây, trình đơn tìm kiếm trong tệp sẽ 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ó trên tệp PDF một trang.
  • Chúng tôi đã khắc phục vấn đề trùng lặp giữa thanh tìm kiếm trong tệp và FloatingActionButton.
  • Giờ đây, chú thích dạng văn bản và chú thích đánh dấu có thể kết xuất trong trình xem.
  • Tính năng Tìm trong thanh tệp đã được cải tiến về khả năng hỗ trợ tiếp cận.
  • Chúng tôi đã triển khai các bản sửa lỗi cho giao diện người dùng để xoay vòng, bao gồm cả việc duy trì số lượng tìm kiếm, xử lý trình đơn lựa chọn văn bản biến mất và giải quyết vấn đề trùng lặp FAB.
  • Đã khắc phục lỗi tìm thấy trong trình đơn 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 hiển thị trong trình xem.
  • PdfViewerFragment có 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 hoạt động triển khai bản xem trước sớm cho phép các tình huống đọ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ũ hơn trong các bản phát hành sắp tới.

  • Ra mắt PdfViewerFragment mà ứng dụng của bạn có thể dùng để kết xuất 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 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 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: Cuộn ở trạng thái mặc định/đã thu phóng. PdfViewerFragment cung cấp thanh tua nhanh để di chuyển nhanh giữa các trang.
    • Thao tác đối với văn bản: Thao tác nhấn và giữ văn bản sẽ 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 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 web hoặc dấu trang bằng cách nhấn vào các siêu liên kết trong tệp PDF.
    • Lối tắt đến chế độ chú thích: PdfViewerFragment chưa hỗ trợ chế độ chỉnh sửa. Thay vào đó, PdfViewerFragment hiển thị một FloatingActionButton sẽ 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 để thiết lập tệp hoặc URI nội dung cho tài liệu và bắt đầu tải tài liệu. PdfViewerFragment hiển thị 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 thành phần tìm kiếm trong trình đơn tệp. PdfViewerFragment xử lý toàn bộ luồng – cho phép nhập dữ liệu, 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 kết quả đó.
  • Thêm các lệnh gọi lại onDocumentLoadSuccess và onDocumentLoadError được gọi sau khi kết xuất tài liệu thành công hoặc sau khi xảy ra lỗi trước khi kết xuất.

Lỗi đã biết

  • Tìm trong thanh tệp trùng lặp 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ữ nguyên khi thay đổi cấu hình trong trình đơn tìm kiếm trong tệp.
  • Bạn sẽ thấy hiện tượng nhấp nháy khi đóng trình đơn tìm kiếm trong tệp
  • Hình ảnh 3D trong tài liệu PDF không được hiển thị trong trình xem.
  • Bộ 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ừ dọc sang ngang.
  • Không hỗ trợ chú thích dạng văn bản/đánh dấu.
  • PdfViewerFragment có 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 lên 35 5dc41be