이 페이지는 Cloud Translation API를 통해 번역되었습니다.

pdf

앱 내에 PDF 보기 기능을 추가하는 라이브러리입니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2024년 12월 11일	-	-	-	1.0.0-alpha05

종속 항목 선언

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을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

이 아티팩트의 출시 노트는 없습니다.

버전 1.0

버전 1.0.0-alpha05

2024년 12월 11일

androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05 및 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에는 이 커밋이 포함되어 있습니다.

버그 수정

이제 이 라이브러리는 유형 사용인 JSpecify nullness 주석을 사용합니다. Kotlin 개발자는 다음 컴파일러 인수를 사용하여 올바른 사용을 적용해야 합니다. -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I38301, b/326456246)
Android 13에서 회전 후 이전에 열었던 페이지가 표시되는 문제를 수정했습니다. (Ib03dd)
회전 시 툴박스가 사라지는 문제를 수정했습니다. (01148f)

버전 1.0.0-alpha04

2024년 11월 13일

androidx.pdf:pdf-viewer:1.0.0-alpha04 및 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에는 이 커밋이 포함되어 있습니다.

확장된 호환성

이제 PDFViewer 라이브러리가 Android 버전 S, T, U, V를 지원합니다. 이 향상된 호환성은 SDK 확장 프로그램 13 업데이트와 연결됩니다.

API 변경사항

PdfViewerFragment에 최소 SdkExtension 제약 조건을 추가했습니다. (I922af)
PDF 뷰어 라이브러리의 새 API를 노출합니다. (I0af57)

버그 수정

프로세스 종료 문제의 비정상 종료 수정
비밀번호 대화상자와 관련된 UI 수정사항
findInFileView 및 FastscrollView의 접근성 수정사항이 적용되었습니다.

진행 중인 개발

Jetpack Compose를 라이브러리에 통합하기 위해 노력하고 있습니다.

버전 1.0.0-alpha03

2024년 9월 18일

androidx.pdf:pdf-viewer:1.0.0-alpha03 및 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에는 이 커밋이 포함되어 있습니다.

버그 수정

검색을 처음 열 때 키보드가 표시되지 않는 문제가 해결됨
FindInFile 뷰의 글꼴과 관련된 UI 수정사항
텍스트 선택 및 드래그 핸들의 UI가 수정되었습니다.

알려진 문제

PDF 문서의 3D 이미지가 뷰어에서 렌더링되지 않습니다.
PdfViewerFragment에서 매우 큰 PDF 문서(250MB 초과)에 성능 문제가 있음

버전 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 이미지가 흐리게 표시되는 문제가 해결되었습니다.
이제 파일에서 찾기 메뉴가 구성이 변경되더라도 결과 수를 유지합니다.
이제 단일 페이지 PDF에 FloatingActionButton 아이콘을 사용할 수 있습니다.
파일에서 찾기 막대와 FloatingActionButton의 겹치는 문제가 수정되었습니다.
이제 뷰어에서 텍스트 및 강조 표시 주석을 렌더링할 수 있습니다.
파일에서 찾기 바의 접근성이 개선되었습니다.
찾기 횟수 보존, 사라지는 텍스트 선택 메뉴 해결, FAB 겹침 문제 해결 등 회전을 위한 UI 수정사항이 구현되었습니다.
가로 모드에서 키보드 뒤에 숨겨진 파일에서 찾기 메뉴가 수정되었습니다.

알려진 문제

PDF 문서의 3D 이미지가 뷰어에서 렌더링되지 않습니다.
PdfViewerFragment에서 매우 큰 PDF 문서(250MB 초과)에 성능 문제가 있음

버전 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의 초기 알파 출시에는 핵심 PDF 읽기 시나리오를 지원하는 초기 미리보기 구현이 포함되어 있습니다. PdfViewerFragment는 현재 Android V (SDK 35) 버전에서만 지원됩니다. 향후 출시에서는 이전 Android 버전 지원이 추가될 예정입니다.

앱에서 PDF 문서를 렌더링하는 데 사용할 수 있는 PdfViewerFragment를 도입했습니다. PdfViewerFragment는 활동에 PDF 뷰어를 통합하는 과정을 간소화하고 사용자가 다음과 같은 방식으로 상호작용할 수 있도록 합니다.
- 확대/축소: 손가락을 오므리거나 펼쳐 확대/축소 수준을 조정하여 편안한 독서 환경을 조성할 수 있으며, 두 번 탭하여 기본 상태로 빠르게 확대/축소할 수 있습니다.
- 탐색: 기본/확대 상태에서 스크롤합니다. PdfViewerFragment는 페이지 간에 빠르게 스크롤할 수 있는 빠른 스크러버를 제공합니다.
- 텍스트 작업: 텍스트를 길게 탭하면 텍스트가 선택되므로 사용자가 현재 페이지에서 복사 및 모두 선택과 같은 옵션을 사용할 수 있습니다.
- 비밀번호로 보호된 문서: PdfViewerFragment는 사용자가 비밀번호를 입력하고 문서를 열 수 있는 대화상자를 제공합니다.
- 탐색 가능한 하이퍼링크: 사용자는 PDF 내의 하이퍼링크를 탭하여 웹 URL 또는 북마크로 이동할 수 있습니다.
- 주석 모드 바로가기: PdfViewerFragment에서는 아직 수정 모드가 지원되지 않습니다. 대신 PdfViewerFragment는 문서 URI로 암시적 android.intent.action.ANNOTATE 인텐트를 실행하는 FloatingActionButton를 표시합니다.

API 변경사항

문서의 파일 또는 콘텐츠 URI를 설정하고 문서 로드를 시작하는 PdfViewerFragment.documentUri 속성을 추가했습니다. PdfViewerFragment는 URI가 설정되어 문서의 백그라운드 처리를 나타내는 로드 스피너를 표시합니다.
파일에서 찾기 메뉴의 표시/숨기기를 전환하는 PdfViewerFragment.isTextSearchActive를 추가했습니다. PdfViewerFragment는 입력을 허용하고, 일치 항목의 총 개수를 표시하고, 결과 간에 탐색하고 종료하는 등 전체 흐름을 처리합니다.
문서 렌더링이 완료된 후 또는 렌더링 전에 오류가 발생한 후에 호출되는 onDocumentLoadSuccess 및 onDocumentLoadError 콜백을 추가했습니다.

알려진 문제

경우에 따라 파일에서 찾기 창이 FloatingActionButton와 겹칩니다.
단일 페이지 PDF에는 FloatingActionButton 아이콘이 표시되지 않습니다.
파일에서 찾기 메뉴의 구성 변경 시 결과 수가 보존되지 않습니다.
파일에서 찾기 메뉴를 닫는 동안 깜박임이 관찰됨
PDF 문서의 3D 이미지가 뷰어에서 렌더링되지 않습니다.
접근성 기능은 다음 버전에서 사용 설정됩니다.
세로 모드에서 가로 모드로 회전할 때 PDF 이미지가 흐리게 표시됩니다.
텍스트/강조 표시 주석은 지원되지 않습니다.
PdfViewerFragment에서 매우 큰 PDF 문서(250MB 초과)에 성능 문제가 있음

참고

compileSdk를 35 5dc41be로 업데이트