pdf

  
مكتبة لإضافة إمكانات عرض ملفات pdf داخل التطبيقات
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار التجريبي الأول
13 تشرين الثاني (نوفمبر) 2024 - - - 1.0.0-alpha04

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

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

أضِف التبعيات للعناصر التي تحتاج إليها في ملف 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. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زر النجمة.

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

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

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

الإصدار 1.0

الإصدار 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