pdf

  
Uygulamalara PDF görüntüleme özellikleri eklemek için kullanılan bir kitaplık.
Son Güncelleme Kararlı sürüm Sürüm Adayı Beta Sürümü Alfa sürümü
16 Temmuz 2025 - - - 1.0.0-alpha10

Bağımlılıkları bildirme

pdf'ye bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.

Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:

Eski

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

Kotlin

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

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmeye yönelik fikirleriniz olursa lütfen bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.

Bu yapıyla ilgili sürüm notu yok.

Sürüm 1.0

Sürüm 1.0.0-alpha10

16 Temmuz 2025

androidx.pdf:pdf-*:1.0.0-alpha10 iptal edilir. 1.0.0-alpha10 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Kullanıcıların seçim tutamaçlarını sayfa sınırlarının ötesine sürükleyerek birden fazla sayfadaki metni seçmesine olanak tanıyan gelişmiş seçim.
  • Uygulamalar artık PDF dokümanlarındaki köprü tıklamalarının işlenmesini engelleyip özelleştirebilir.

API Değişiklikleri

  • PDF içeriğini sunmak için Composable'ı kullanıma sunar (I8e7ee).
  • PdfPoint ve PdfRect, androidx.pdf.models paketine taşınıyor (I26cf4)
  • PDF içeriğini sunmak için bir View bileşeni kullanıma sunuluyor (I9fe27).
  • PDF kaynaklarını önceden başlatmak ve soğuk başlatma gecikmesini azaltmak için API'yi kullanıma sunar (a18fa89)
  • Pdf içeriğinde köprü tıklama işleme özelliğini geçersiz kılmak için API'yi kullanıma sunar(6330a8b).
  • Yeni bir yapay nesne olan pdf-document-service ve ilgili API'ler (PdfLoader, PdfDocument ve SandboxedPdfLoader) kullanıma sunulur. Arayüzler, PDF dokümanının ayrıştırma ve işleme bileşenini (Ide70d) uygulamak için kullanılabilir.
  • Belgenin oluşturulmasını başlatmak için PdfView üzerinde PdfDocument ayarlamak üzere bir API kullanıma sunar (If8738).

Sürüm 1.0.0-alpha09

7 Mayıs 2025

androidx.pdf:pdf-*:1.0.0-alpha09 iptal edilir. 1.0.0-alpha09 sürümü bu commit'leri içerir.

Önemli Değişiklikler

  • Kod tabanı büyük bir yeniden düzenleme işleminden geçti ve artık tamamen Kotlin ile yazılıyor. Bu süreçte Coroutines ve ViewModel kullanılıyor. Bu, PdfViewerFragment'nın yeniden uygulanmasını içerir. Bu sürümde yeni API'ler veya özellikler yer almıyor.

Bilinen Sorunlar:

  • Hızlı kaydırma çubuğu ve sayfa göstergesinde gölge efektleri eksik.
  • Tek sayfalık PDF belgeler her zaman ortalanmayabilir ve görünümün genişliğine göre ölçeklenmeyebilir.

API Değişiklikleri

  • containerStyleResId öğesine @StyleRes ile not ekleyin. (I88d85)

Sürüm 1.0.0-alpha08

12 Mart 2025

androidx.pdf:pdf-document-service:1.0.0-alpha08, androidx.pdf:pdf-viewer:1.0.0-alpha08 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Ölçeklendirme farklılıkları nedeniyle farklı Android cihazlar arasındaki tutarsız seçim menüsü yerleşimi sorunu düzeltildi. Seçim menüsünün yerleşimi artık cihazlar arasında tutarlı.
  • Yapılandırma değişikliği gibi senaryolarda parça yeniden oluşturulurken hızlı kaydırma çubuğu ve sayfa göstergesi konumu hizalandı.

Sürüm 1.0.0-alpha07

26 Şubat 2025

androidx.pdf:pdf-document-service:1.0.0-alpha07, androidx.pdf:pdf-viewer:1.0.0-alpha07 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü şu commit'leri içerir.

Yeni Özellikler

  • PdfViewerFragment artık StylingOptions (stil kaynağı kimlikleri kümesi) öğesini destekliyor. Bu sayede newInstance veya XML (FragmentContainerView) üzerinden özel stil oluşturulabiliyor. Alt sınıflar, benzer işlevler için korumalı oluşturucuyu kullanabilir.
  • StylingOptions şu anda containerStyle'ı kullanıyor. containerStyle'ın sağladığı özellikler:
    • Hızlı kaydırma tutacağı ve sayfa göstergesi için özel çizilebilir öğe desteği.
    • Hızlı kaydırma tutamacının ve sayfa göstergesinin hassas bir şekilde konumlandırılması için marginEnd özelliği.

API Değişiklikleri

  • PdfView (I30fc5) kaynağından herkese açık özellikler eklendi.
  • PDF görünümü için yeni API'ler StylingOptions eklendi. (Id2993)

Hata Düzeltmeleri

  • Hızlı kaydırma tutacağı ile sayfa göstergesi görünürlük durumu arasındaki senkronizasyon tutarsızlığı düzeltildi.

Sürüm 1.0.0-alpha06

29 Ocak 2025

androidx.pdf:pdf-document-service:1.0.0-alpha06, androidx.pdf:pdf-viewer:1.0.0-alpha06 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Düzeltme: Kayıtlı olmayan bir hizmetin bağlantısı kaldırılırken IllegalArgumentException nedeniyle oluşan kilitlenme sorunu düzeltildi (eb4e85).
  • Düzeltme: mMaxPages ve numPages arasındaki fark nedeniyle IllegalArgumentException kilitleniyordu. (75d763)

Sürüm 1.0.0-alpha05

11 Aralık 2024

androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Bu kitaplık artık tür kullanımı olan JSpecify nullness ek açıklamalarını kullanıyor. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için aşağıdaki derleyici bağımsız değişkenini kullanmalıdır: -Xjspecify-annotations=strict (bu, Kotlin derleyicisinin 2.1.0 sürümünden itibaren varsayılan değerdir). (I38301, b/326456246)
  • Android 13'te döndürme işleminden sonra daha önce açılan sayfanın gösterilmesi sorunu düzeltildi. (Ib03dd)
  • Döndürme sırasında araç kutusunun kaybolması sorunu düzeltildi. (01148f)

Sürüm 1.0.0-alpha04

13 Kasım 2024

androidx.pdf:pdf-viewer:1.0.0-alpha04 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu commit'leri içerir.

Genişletilmiş Uyumluluk

  • PDFViewer kitaplığı artık Android'in S, T, U ve V sürümlerini destekliyor. Bu gelişmiş uyumluluk, SDK uzantısı 13 güncellemesine bağlıdır.

API Değişiklikleri

  • PdfViewerFragment için minimum SdkExtension kısıtlaması eklendi. (I922af)
  • PDF Görüntüleyici kitaplığı için yeni API'ler kullanıma sunuldu. (I0af57)

Hata Düzeltmeleri

  • İşlem sonlandırma sorunu için kilitlenme düzeltmesi.
  • Şifre iletişim kutusuyla ilgili kullanıcı arayüzü düzeltmeleri.
  • findInFileView ve FastscrollView için erişilebilirlik düzeltmeleri.

Devam Eden Geliştirme

  • Jetpack Compose'u kitaplığa dahil etmek için yoğun şekilde çalışıyoruz.

Sürüm 1.0.0-alpha03

18 Eylül 2024

androidx.pdf:pdf-viewer:1.0.0-alpha03 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03 yayınlandı. Sürüm 1.0.0-alpha03, bu commit'leri içerir.

Hata Düzeltmeleri

  • Arama ilk kez açıldığında klavyenin görünmemesi sorunu düzeltildi.
  • FindInFile görünümünün yazı tipiyle ilgili kullanıcı arayüzü düzeltmeleri.
  • Metin seçimi ve sürükleme tutma yeriyle ilgili kullanıcı arayüzü düzeltmeleri yapıldı.

Bilinen Sorunlar

  • PDF belgelerindeki 3D görüntüler, görüntüleyicide oluşturulmaz.
  • PdfViewerFragment çok büyük PDF belgelerinde (> 250 MB) bazı performans sorunları yaşıyor.

Sürüm 1.0.0-alpha02

4 Eylül 2024

androidx.pdf:pdf-viewer:1.0.0-alpha02 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Dikeyden yataya döndürüldüğünde PDF görüntüsünün bulanıklaşması ve uygulamanın uyku moduna geçmesi sorunu düzeltildi.
  • Dosyada bul menüsü, yapılandırma değiştiğinde bile sonuç sayısını korur.
  • FloatingActionButton simgesi artık tek sayfalık PDF'lerde kullanılabilir.
  • Dosyada bul çubuğu ile FloatingActionButton arasındaki çakışma sorunları düzeltildi.
  • Metin ve vurgulama ek açıklamaları artık görüntüleyicide oluşturulabilir.
  • Dosyada bul çubuğunda erişilebilirlik iyileştirmeleri yapıldı.
  • Döndürme işlemiyle ilgili kullanıcı arayüzü düzeltmeleri yapıldı. Örneğin, bulma sayısının korunması, kaybolan metin seçimi menüsünün ele alınması ve kayan işlem düğmesinin çakışma sorununun çözülmesi gibi düzeltmeler yapıldı.
  • Yatay modda klavyenin arkasında kalan dosyada bul menüsü düzeltildi.

Bilinen Sorunlar

  • PDF belgelerindeki 3D görüntüler, görüntüleyicide oluşturulmaz.
  • PdfViewerFragment çok büyük PDF belgelerinde (> 250 MB) bazı performans sorunları yaşıyor.

Sürüm 1.0.0-alpha01

7 Ağustos 2024

androidx.pdf:pdf-viewer:1.0.0-alpha01 ve androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü bu commit'leri içerir.

Yeni Özellikler

PDFViewer'nın ilk alfa sürümünde, temel PDF okuma senaryolarını etkinleştiren erken önizleme uygulamaları yer alır. PdfViewerFragment şu anda yalnızca Android V (SDK 35) sürümlerinde desteklenmektedir. Eski Android sürümleri için destek, sonraki sürümlerde eklenecektir.

  • Uygulamanızın PDF dokümanı oluşturmak için kullanabileceği PdfViewerFragment tanıtıldı. PdfViewerFragment, Etkinliğinize PDF görüntüleyici entegrasyonunu kolaylaştırır ve kullanıcıların aşağıdaki şekillerde etkileşim kurmasına olanak tanır:
    • Yakınlaştırma: Rahat bir okuma deneyimi için yakınlaştırma düzeylerini ayarlamak üzere iki parmağınızı yakınlaştırın ve uzaklaştırın. Ayrıca, varsayılan duruma hızlıca yakınlaştırmak veya uzaklaştırmak için iki kez dokunun.
    • Gezinme: Varsayılan/yakınlaştırılmış durumda kaydırma. PdfViewerFragment, sayfalar arasında hızlı kaydırma için hızlı bir kaydırma çubuğu sağlar.
    • Metin işlemleri: Metne uzun dokunulduğunda metin seçilir. Böylece kullanıcılar, mevcut sayfada Kopyala ve Tümünü seç gibi seçenekleri kullanabilir.
    • Şifre korumalı dokümanlar: PdfViewerFragment, kullanıcının şifreyi girip dokümanı açması için bir iletişim kutusu sağlar.
    • Gezilebilir köprüler: Kullanıcılar, PDF'deki köprülere dokunarak web URL'lerine veya yer işaretlerine gidebilir.
    • Notlar moduna kısayol: Düzenleme modu henüz PdfViewerFragment'da desteklenmemektedir. Bunun yerine PdfViewerFragment, doküman URI'siyle örtülü bir android.intent.action.ANNOTATE amacını tetikleyen bir FloatingActionButton gösterir.

API Değişiklikleri

  • Doküman için bir dosya veya içerik URI'si ayarlamak ve doküman yüklemeyi başlatmak üzere PdfViewerFragment.documentUri özelliği eklendi. URI ayarlandığında, dokümanın arka planda işlendiğini belirtmek için PdfViewerFragment yükleme animasyonu gösterir.
  • Dosyada bul menüsünün görünürlüğünü açıp kapatmak için PdfViewerFragment.isTextSearchActive simgesi eklendi. PdfViewerFragment, tüm akışı yönetir. Girişe izin verir, toplam eşleşme sayısını gösterir, sonuçlar arasında gezinmeyi sağlar ve sonuçlardan çıkmayı mümkün kılar.
  • Belge başarıyla oluşturulduktan sonra veya oluşturma işleminden önce bir hata oluştuğunda çağrılan onDocumentLoadSuccess ve onDocumentLoadError geri çağırmaları eklendi.

Bilinen Sorunlar

  • Dosyada bulma çubuğu bazı durumlarda FloatingActionButton ile çakışıyor.
  • Tek sayfalık PDF'lerde FloatingActionButton simgesi görünmez.
  • Dosyada bul menüsünde yapılandırma değişikliği yapıldığında sonuç sayısı korunmaz.
  • Dosyada bul menüsü kapatılırken titreme görülüyor
  • PDF belgelerindeki 3D görüntüler, görüntüleyicide oluşturulmaz.
  • Erişilebilirlik özellikleri aşağıdaki sürümlerde etkinleştirilecektir.
  • PDF resmi, dikeyden yataya döndürüldüğünde bulanıklaşıyor.
  • Metin/vurgulama notu desteği yoktur.
  • PdfViewerFragment çok büyük PDF belgelerinde (> 250 MB) bazı performans sorunları yaşıyor.

Not

  • compileSdk, 35 5dc41be olarak güncelleniyor