pdf

  
مكتبة لإضافة إمكانات عرض ملفات pdf داخل التطبيقات
التعديل الأخير الإصدار المستقر سحب المرشح الإصدار التجريبي إصدار أولي
4 سبتمبر 2024 - - - 1.0.0-alpha02

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

لإضافة تبعية إلى ملف 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-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".
  • يمكن الآن عرض التعليقات التوضيحية النصية واللحظات المميّزة في المشاهد.
  • تم إجراء تحسينات على إمكانية الوصول إلى شريط "البحث في الملف".
  • تم تنفيذ إصلاحات في واجهة المستخدم بغرض التناوب، بما في ذلك الحفاظ على عدد النتائج ومعالجة قائمة تحديد النص المخفي وحلّ مشكلة تداخل FAB.
  • تم إصلاح الخطأ "البحث في قائمة الملف" الذي يختفي خلف لوحة المفاتيح في الوضع الأفقي.

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

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

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

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

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

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

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

ملاحظة

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