pdf

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

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

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

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

رائع

dependencies {
    //TODO: Confirm these dependencies
    implementation "androidx.pdf:pdf:1.0.0-alpha01"
}

Kotlin

dependencies {
    //TODO: Confirm these dependencies
    implementation("androidx.pdf:pdf:1.0.0-alpha01")
}

لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.

ملاحظات

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

إنشاء عدد جديد

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

ما مِن ملاحظات إصدار لهذا العنصر.

الإصدار 1.0

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