pdf

  
مكتبة لإضافة إمكانات عرض ملفات pdf داخل التطبيقات
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار التجريبي
26 شباط (فبراير) 2025 - - - 1.0.0-alpha07

الإعلان عن التبعيات

لإضافة تبعية على pdf، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle ل تطبيقك أو وحدتك:

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

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زرّ النجمة.

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

لا تتوفّر ملاحظات حول الإصدار لهذا العنصر.

الإصدار 1.0

الإصدار 1.0.0-alpha07

26 شباط (فبراير) 2025

تم إصدار androidx.pdf:pdf-document-service:1.0.0-alpha07 وandroidx.pdf:pdf-viewer:1.0.0-alpha07 وandroidx.pdf:pdf-viewer-fragment:1.0.0-alpha07. يحتوي الإصدار 1.0.0-alpha07 على عمليات الربط هذه.

الميزات الجديدة

  • تتيح فئة PdfViewerFragment الآن استخدام StylingOptions (مجموعة من أرقام تعريف موارد الأنماط) لتفعيل الأنماط المخصّصة من خلال newInstance أو XML (FragmentContainerView). ويمكن للطبقات الفرعية استخدام المنشئ المحمي للحصول على وظائف مماثلة.
  • يتلقّى StylingOptions حاليًا containerStyle الذي يقدّم ما يلي:
    • إتاحة عناصر قابلة للرسم مخصّصة لعنصر التحكّم في الانتقال السريع للأسفل أو للأعلى ومؤشر الصفحة
    • سمة marginEnd لتحديد موضع شريط التمرير السريع ومؤشر الصفحة بدقة

تغييرات واجهة برمجة التطبيقات

  • تمّت إضافة سمات عامة من PdfView (I30fc5)
  • تمت إضافة واجهات برمجة تطبيقات جديدة StylingOptions لعرض ملفات pdf. (Id2993)

إصلاح الأخطاء

  • تمّ إصلاح مشكلة عدم تطابق المزامنة بين شريط التمرير السريع وحالة ظهور مؤشر الصفحة.

الإصدار 1.0.0-alpha06

29 كانون الثاني (يناير) 2025

تم إصدار androidx.pdf:pdf-document-service:1.0.0-alpha06 وandroidx.pdf:pdf-viewer:1.0.0-alpha06 وandroidx.pdf:pdf-viewer-fragment:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 عمليات الربط هذه.

إصلاح الأخطاء

  • حلّ مشكلة تعطُّل التطبيق بسبب IllegalArgumentException عند إلغاء ربط خدمة غير مسجَّلة (eb4e85)
  • حلّ مشكلة الأعطال IllegalArgumentException بسبب الاختلاف في mMaxPages وnumPages (75d763)

الإصدار 1.0.0-alpha05

11 كانون الأول (ديسمبر) 2024

تم إصدار 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، وهي عبارة عن استخدام للنوع. على مطوّري Kotlin استخدام مَعلمات المُجمِّع التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I38301، b/326456246)
  • تم إصلاح مشكلة ظهور الصفحة التي تم فتحها سابقًا بعد التدوير في Android 13. (Ib03dd)
  • تم إصلاح مشكلة اختفاء "صندوق الأدوات" عند التدوير. (01148f)

الإصدار 1.0.0-alpha04

13 تشرين الثاني (نوفمبر) 2024

تم إصدار 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.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة حدّ أدنى SdkExtension إلى PdfViewerFragment. (I922af)
  • إتاحة واجهات برمجة تطبيقات جديدة لمكتبة "عارض ملفات PDF" (I0af57)

إصلاح الأخطاء

  • إصلاح مشكلة تعطُّل التطبيق بسبب إيقاف العملية نهائيًا
  • إصلاحات واجهة المستخدم ذات الصلة بمربّع حوار كلمة المرور
  • إصلاحات لتسهيل الاستخدام في findInFileView وFastscrollView

التطوير المستمر

  • نحن نعمل جاهدين على دمج Jetpack Compose في المكتبة.

الإصدار 1.0.0-alpha03

18 أيلول (سبتمبر) 2024

تم إصدار androidx.pdf:pdf-viewer:1.0.0-alpha03 وandroidx.pdf:pdf-viewer-fragment:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على عمليات الربط هذه.

إصلاح الأخطاء

  • تم حلّ مشكلة عدم ظهور لوحة المفاتيح عند فتح البحث لأول مرة
  • إصلاحات لواجهة المستخدم ذات الصلة بخط عرض FindInFile
  • إصلاحات في واجهة المستخدم لاختيار النص ومقبض السحب

المشاكل المعروفة

  • لا يتم عرض الصور الثلاثية الأبعاد في ملفات PDF في المُشاهد.
  • يواجه PdfViewerFragment بعض مشاكل الأداء في ملفات PDF كبيرة جدًا (> 250 ميغابايت).

الإصدار 1.0.0-alpha02

4 أيلول (سبتمبر) 2024

تم إصدار androidx.pdf:pdf-viewer:1.0.0-alpha02 وandroidx.pdf:pdf-viewer-fragment:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على عمليات الربط هذه.

إصلاح الأخطاء

  • تم حلّ مشكلة عدم وضوح صورة PDF عند تدويرها من الوضع العمودي إلى الوضع الأفقي ودخول التطبيق في وضع السكون.
  • تحافظ قائمة "البحث في الملف" الآن على عدد النتائج حتى في حال تغيير الإعدادات.
  • يتوفّر رمز FloatingActionButton الآن لملفات PDF ذات الصفحة الواحدة.
  • تم إصلاح المشاكل المتداخلة بين شريط "البحث في الملف" ورمز FloatingActionButton.
  • يمكن الآن عرض التعليقات التوضيحية النصية والمميزة في المشغّل.
  • تم إجراء تحسينات على ميزات تسهيل الاستخدام في شريط "البحث في الملف".
  • تم تنفيذ إصلاحات على واجهة المستخدم للاستفادة من ميزة التدوير، بما في ذلك الحفاظ على عدد عمليات البحث ومعالجة مشكلة اختفاء قائمة اختيار النص وحلّ مشكلة تداخل التطبيق المصغّر للإجراءات السريعة.
  • تم إصلاح مشكلة إخفاء قائمة "البحث في الملف" خلف لوحة المفاتيح في الوضع الأفقي.

المشاكل المعروفة

  • لا يتم عرض الصور الثلاثية الأبعاد في ملفات PDF في المُشاهد.
  • يواجه PdfViewerFragment بعض مشاكل الأداء في ملفات PDF كبيرة جدًا (> 250 ميغابايت).

الإصدار 1.0.0-alpha01

7 آب (أغسطس) 2024

تم إصدار 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 (حزمة تطوير البرامج 35). وسيتم توفير الإصدارات القديمة من Android في الإصدارات القادمة.

  • تمّت إضافة PdfViewerFragment التي يمكن لتطبيقك استخدامها لعرض مستند PDF. تعمل PdfViewerFragment على تبسيط دمج عارض PDF في نشاطك والسماح للمستخدمين بالتفاعل بالطرق التالية:
    • التكبير والتصغير: يمكنك تكبير المحتوى وتصغيره من خلال تضييق أو توسيع إصبعَيك للحصول على تجربة قراءة مريحة، كما يمكنك النقر مرّتين للتكبير أو التصغير بسرعة إلى الحالة التلقائية.
    • التنقّل: يمكنك الانتقال للأعلى أو للأسفل في الوضع التلقائي أو المكبَّر. PdfViewerFragment يقدّم أداة تمرير سريع للتمرير السريع بين الصفحات.
    • إجراءات النص: يؤدي النقر مع الاستمرار على النص إلى اختياره، ما يتيح للمستخدمين استخدام خيارات مثل "نسخ" و"اختيار الكل" في الصفحة الحالية.
    • المستندات المحمية بكلمة مرور: PdfViewerFragment يوفّر مربّع حوار للمستخدم لإدخال كلمة المرور وفتح المستند.
    • روابط تشعبية قابلة للتنقّل: يمكن للمستخدمين الانتقال إلى عناوين URL على الويب أو الإشارات المرجعية من خلال النقر على الروابط التشعّبية في ملف PDF.
    • اختصار للانتقال إلى وضع التعليقات التوضيحية: لا يتوفّر وضع التعديل بعد في PdfViewerFragment. بدلاً من ذلك، يعرض PdfViewerFragment FloatingActionButton الذي يشغّل نية android.intent.action.ANNOTATE ضمنية باستخدام معرّف الموارد المنتظم للمستند.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة السمة PdfViewerFragment.documentUri لضبط ملف أو عنوان URL للمحتوى للمستند وبدء تحميل المستند. يعرض الرمز PdfViewerFragment مؤشر تحميل عند ضبط معرّف الموارد المنتظم (URI) للإشارة إلى معالجة المستند في الخلفية.
  • تمت إضافة PdfViewerFragment.isTextSearchActive لتبديل مستوى ظهور قائمة "البحث في الملف". يعالج PdfViewerFragment العملية بأكملها، ما يتيح الإدخال وعرض إجمالي عدد المطابقات وتفعيل التنقّل بين النتائج والخروج منها.
  • تمت إضافة وظيفتَي الاستدعاء onDocumentLoadSuccess وonDocumentLoadError اللتين يتم استدعاؤهما بعد عرض المستند بنجاح أو بعد ظهور خطأ قبل العرض.

المشاكل المعروفة

  • يتداخل شريط "البحث في الملف" مع FloatingActionButton في بعض الحالات.
  • لا يظهر رمز FloatingActionButton لملفات PDF التي تتألف من صفحة واحدة.
  • لا يتم الاحتفاظ بعدد النتائج عند تغيير الإعدادات في قائمة "البحث في الملف".
  • ملاحظة وميض أثناء إغلاق قائمة "البحث في الملف"
  • لا يتم عرض الصور الثلاثية الأبعاد في ملفات PDF في المُشاهد.
  • وسيتم تفعيل ميزات تسهيل الاستخدام في الإصدارات التالية.
  • تصبح صورة PDF مموّهة عند تدويرها من الوضع العمودي إلى الوضع الأفقي.
  • لا تتوفّر ميزة التعليق التوضيحي للنص أو التمييز.
  • يواجه PdfViewerFragment بعض مشاكل الأداء في ملفات PDF كبيرة جدًا (> 250 ميغابايت).

ملاحظة

  • تعديل compileSdk إلى 35 5dc41be