pdf

  
Biblioteka umożliwiająca wyświetlanie plików PDF w aplikacji.
Ostatnia aktualizacja Wersja stabilna Wersja kandydująca Wersja Beta Wersja alfa
11 grudnia 2024 r. - - - 1.0.0-alpha05

Deklarowanie zależności

Aby dodać zależność od pliku PDF, musisz dodać repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Maven firmy Google.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

Odlotowe

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

Kotlin

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli zauważysz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Nie ma informacji o wersji tego artefaktu.

Wersja 1.0

Wersja 1.0.0-alpha05

11 grudnia 2024 r.

Funkcje androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05 są dostępne. Wersja 1.0.0-alpha05 zawiera te komity.

Poprawki błędów

  • Biblioteka ta korzysta teraz z adnotacji JSpecify dotyczących nullowania, które są używane w zależności od typu. Deweloperzy Kotlina powinni używać tych argumentów kompilatora, aby wymusić prawidłowe użycie: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I38301, b/326456246)
  • Rozwiązaliśmy problem z wyświetlaniem wcześniej otwartej strony po przechyleniu ekranu w Androidzie 13. (Ib03dd)
  • Naprawiono problem z znikaniem panelu narzędzi podczas obracania. (01148f)

Wersja 1.0.0-alpha04

13 listopada 2024 r.

androidx.pdf:pdf-viewer:1.0.0-alpha04androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te komisy.

Zwiększona zgodność

  • Biblioteka PDFViewer obsługuje teraz wersje Androida S, T, U i V. Ta zwiększona kompatybilność jest powiązana z aktualizacją rozszerzenia pakietu SDK 13.

Zmiany w interfejsie API

  • Dodano ograniczenie minimalne SdkExtension do PdfViewerFragment. (I922af)
  • Udostępnianie nowych interfejsów API dla biblioteki PDF Viewer. (I0af57)

Poprawki błędów

  • Rozwiązanie problemu z awarią procesu.
  • Poprawki dotyczące interfejsu użytkownika związane z oknem dialogowym hasła.
  • Poprawki ułatwień dostępu w przypadku aplikacji findInFileViewFastscrollView.

W drodze do ukończenia

  • Aktywnie pracujemy nad wdrożeniem Jetpack Compose w bibliotece.

Wersja 1.0.0-alpha03

18 września 2024 r.

androidx.pdf:pdf-viewer:1.0.0-alpha03androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03 są dostępne. Wersja 1.0.0-alpha03 zawiera te komity.

Poprawki błędów

  • Rozwiązano problem z klawiaturą, która nie pojawia się po pierwszym otwarciu wyszukiwarki.
  • Poprawki w interfejsie związane z czcionką widoku FindInFile.
  • Poprawki w interfejsie dotyczące zaznaczania tekstu i uchwytu przeciągania.

Znane problemy

  • Obrazy 3D w dokumentach PDF nie są renderowane w przeglądarce.
  • PdfViewerFragment ma pewne problemy z wydajnością w przypadku bardzo dużych dokumentów PDF (powyżej 250 MB)

Wersja 1.0.0-alpha02

4 września 2024 r.

androidx.pdf:pdf-viewer:1.0.0-alpha02androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alpha02 zawiera te komity.

Poprawki błędów

  • Rozwiązaliśmy problem z rozmazywaniem obrazu PDF po przekręceniu orientacji z pionowej na poziomą i przejściu aplikacji w stan uśpienia.
  • Menu Znajdź w pliku zachowuje teraz liczbę wyników nawet wtedy, gdy konfiguracja ulegnie zmianie.
  • Ikona FloatingActionButton jest teraz dostępna w przypadku plików PDF jednostronicowych.
  • Rozwiązaliśmy problemy z nakładającymi się paskami Znajdź w pliku i FloatingActionButton.
  • Adnotacje tekstowe i wyróżnienia można teraz renderować w podglądzie.
  • Wprowadziliśmy ułatwienia dostępu w pasku Znajdź w pliku.
  • Wprowadziliśmy poprawki interfejsu dotyczące obracania, w tym zachowanie liczby znalezionych fragmentów, rozwiązanie problemu znikającego menu zaznaczania tekstu i rozwiązanie problemu nakładania się przycisku szybkiego dostępu.
  • Naprawiono problem z menu Znajdź w pliku, które w trybie poziomym było niewidoczne za klawiaturą.

Znane problemy

  • Obrazy 3D w dokumentach PDF nie są renderowane w przeglądarce.
  • PdfViewerFragment ma pewne problemy z wydajnością w przypadku bardzo dużych dokumentów PDF (powyżej 250 MB)

Wersja 1.0.0-alpha01

7 sierpnia 2024 r.

androidx.pdf:pdf-viewer:1.0.0-alpha01androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01 są dostępne. Wersja 1.0.0-alpha01 zawiera te komity.

Nowe funkcje

Pierwsza wersja alfa PDFViewer zawiera wczesne implementacje wersji podglądu, które umożliwiają podstawowe scenariusze czytania plików PDF. Pamiętaj, że PdfViewerFragment jest obecnie obsługiwana tylko w przypadku wersji Androida V (pakiet SDK 35). Obsługa starszych wersji Androida zostanie dodana w przyszłych wersjach.

  • Wprowadziliśmy PdfViewerFragment, którego Twoja aplikacja może używać do renderowania dokumentu PDF. PdfViewerFragment upraszcza integrację przeglądarki PDF w Twojej aktywności i umożliwia użytkownikom interakcję na te sposoby:
    • Powiększanie: rozsuń i ściągnij palce, aby dostosować poziomy powiększenia, które ułatwią czytanie. Możesz też dwukrotnie dotknąć ekranu, aby szybko powiększyć lub pomniejszyć obraz do stanu domyślnego.
    • Nawigacja: przewijanie w stanie domyślnym lub powiększonym. PdfViewerFragment umożliwia szybkie przewijanie między stronami.
    • Działanie związane z tekstem: długie dotknięcie tekstu powoduje jego zaznaczenie, co pozwala użytkownikom na korzystanie z opcji takich jak Kopiuj i Zaznacz wszystko na bieżącej stronie.
    • Dokumenty chronione hasłem: PdfViewerFragment wyświetla okno, w którym użytkownik może wpisać hasło i otworzyć dokument.
    • Nawigacyjne hiperlinki: użytkownicy mogą przechodzić do adresów URL lub zakładek w internecie, klikając hiperlinki w pliku PDF.
    • Skrót do trybu adnotacji: tryb edycji nie jest jeszcze obsługiwany w PdfViewerFragment. Zamiast tego PdfViewerFragment wyświetla FloatingActionButton, który uruchamia ukrytą intencję android.intent.action.ANNOTATE z identyfikatorem URI dokumentu.

Zmiany w interfejsie API

  • Dodaliśmy właściwość PdfViewerFragment.documentUri, która umożliwia ustawienie identyfikatora URI pliku lub treści dokumentu i rozpoczęcie wczytywania dokumentu. PdfViewerFragment wyświetla się wskaźnik wczytywania, gdy ustawiony jest identyfikator URI, co wskazuje na przetwarzanie dokumentu w tle.
  • Dodaliśmy opcję PdfViewerFragment.isTextSearchActive, która umożliwia przełączanie widoczności menu „Znajdź w pliku”. PdfViewerFragment obsługuje cały proces: umożliwia wprowadzanie danych, wyświetla łączną liczbę dopasowań, umożliwia nawigację między wynikami i ich zamykanie.
  • Dodano funkcje zwracające wartości onDocumentLoadSuccessonDocumentLoadError, które są wywoływane po pomyślnym wyrenderowaniu dokumentu lub po wystąpieniu błędu przed wyrenderowaniem.

Znane problemy

  • W niektórych przypadkach pasek „Znajdź w pliku” nakłada się na FloatingActionButton.
  • Ikona FloatingActionButton nie jest widoczna w przypadku plików PDF z jedną stroną.
  • Liczba wyników nie jest zachowywana po zmianie konfiguracji w menu „Znajdź w pliku”.
  • Podczas zamykania menu „Znajdź w pliku” występuje migotanie
  • Obrazy 3D w dokumentach PDF nie są renderowane w przeglądarce.
  • Funkcje ułatwień dostępu zostaną włączone w kolejnych wersjach.
  • Obraz PDF staje się niewyraźny po przekręceniu z orientacji pionowej na poziomą.
  • Nieobsługiwane są adnotacje tekstowe ani adnotacje z wyróżnieniem.
  • PdfViewerFragment ma pewne problemy z wydajnością w przypadku bardzo dużych dokumentów PDF (> 250 MB)

Uwaga

  • Zaktualizuj compileSdk do wersji 35 5dc41be