pdf

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:

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

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

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

22 Ekim 2025

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

Yeni Özellikler

• PDF içerik seçiminde Akıllı Menü Öğeleri'ni etkinleştirme
• PDF'de köprü seçimi ve GoTo bağlantı seçimini etkinleştirme.
• Geliştiricilerin seçim menüsü öğeleri eklemesine olanak tanıyan fromPdfView ve PdfViewer Composable seçim menüsü API'si kullanıma sunuldu.
• PdfView ve PdfViewer Composable'a sayfa hizalama API'si eklendi. Bu API, geliştiricilerin içerik yüksekliği < görüntü alanı yüksekliği olduğunda sayfa hizalamasını seçmesine olanak tanır.

API Değişiklikleri

• contentDesc null yapılabilir hale getirildi ve varsayılan değer kaldırıldı. (I86f8c, b/441973880)
• Bağlantı Seçim Menüsü Öğeleri için PdfSelectionMenuKeys seçeneğini kullanıma sunma (Ic9b05, b/447079082)
• PageAlignment API'sini PdfView ve PdfViewer'yi androidx-main'e ekleyin
• Açıyla ilgili API'yi derece kullanacak şekilde değiştirin ve birimi adlara ekleyin, açı dönüştürme yardımcı programlarındaki birimler konusunda net olun ve hem dereceyi hem de radyanı destekleyin, StockBrushes API'sini stok fırça sürümünü fabrika işlevi parametresi olarak alacak şekilde değiştirin ve vurgulayıcı fırçalar için kendi kendine çakışma davranış kontrolünü kullanıma sunun, MutableAffineTransform.populateFromTranslate öğesini populateFromTranslation olarak yeniden adlandırın, InProgressStrokesView.setRenderFactory/getRenderFactory öğesini kaldırın. (Id9eab, b/436656418)
• PageAlignment API'sini PdfView ve PdfViewer'ye ekleyin (I9c9a5, b/438065228)
• PdfViewer Composable'dan Selection Menu API'yi kullanıma sunma (Id9b0f, b/407663999)
• PdfView öğesini ViewGroup yapın. İsteğe bağlı alt öğeler desteklenmez. (Ib51d8, b/410008792)
• PdfView'den HyperLinkSelection ve GoToLinkSelection'yi kullanıma sunma (I378c4, b/441280002)
• Genel seçimleri desteklemek için yeniden düzenleme PdfPageContent (I28f16, b/437845185)
• PdfView (Idd547, b/407663737) üzerinden seçim menüsü API'sini kullanıma sunma
• Seçimle ilgili sınıfları özel bir pakete taşıma (I953cb, b/436157691)
• PdfViewerFragment'te PdfView erişimi için deneysel onPdfViewCreated özelliğini kullanıma sunuyoruz. (I86715, b/422620454)
• FileDescriptor API'si PdfLoader'ye eklendi (I60b8d)

Hata Düzeltmeleri

• Vuruşların girişi daha doğru yansıtması için giriş modellemeyi iyileştirme (I93097)

Harici Katkı (External Contribution)

• Bağlantı Seçimi Menü Öğeleri için PdfSelectionMenuKeys seçeneğini kullanıma sunma
• PdfViewer Composable'dan Expose Selection Menu API'yi kullanma
• PdfView'dan seçim menüsü API'sini kullanıma sunma

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 belgelerindeki 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 yok.
• 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 özellikleri kullanıma sunulur. 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 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 özellikleri kullanıma sunulur. 1.0.0-alpha07 sürümü bu 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 destek.
  • 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 özellikleri kullanıma sunulur. 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 özellikleri kullanıma sunulur. 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üncellemesiyle bağlantı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ı. 1.0.0-alpha03 sürümü 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 notları artık görüntüleyicide oluşturulabilir.
• Dosyada bul çubuğunda erişilebilirlik iyileştirmeleri yapıldı.
• Döndürme işleminde kullanıcı arayüzüyle ilgili düzeltmeler 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.
• 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 işlevinin şu anda yalnızca Android V (SDK 35) sürümlerinde desteklendiğini lütfen unutmayın. 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 entegre etmeyi kolaylaştırır ve kullanıcıların aşağıdaki şekillerde etkileşimde bulunması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ıca kaydırmak 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, giriş yapmaya, toplam eşleşme sayısını görüntülemeye, sonuçlar arasında gezinmeye ve sonuçlardan çıkmaya olanak tanıyarak tüm akışı yönetir.
• 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.
• FloatingActionButton simgesi, tek sayfalık PDF'lerde 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/vurgu ek açıklaması desteklenmez.
• PdfViewerFragment çok büyük PDF belgelerinde (> 250 MB) bazı performans sorunları yaşıyor.

Not

• compileSdk, 35 5dc41be olarak güncelleniyor