pdf

تحديد التبعيات

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

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

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

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

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

الملاحظات

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

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

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

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

الإصدار 1.0

الإصدار 1.0.0-alpha09

7 أيار (مايو) 2025

تم إصدار androidx.pdf:pdf-*:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 عمليات الربط هذه.

التغييرات الرئيسية

• خضع رمز المصدر لعملية إعادة هندسة كبيرة، وهو مكتوب الآن بالكامل بلغة Kotlin، باستخدام Coroutines وViewModel. ويشمل ذلك إعادة تنفيذ PdfViewerFragment. لا يتضمّن هذا الإصدار أي واجهات برمجة تطبيقات أو ميزات جديدة.

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

• لا تظهر تأثيرات الظلال في شريط التمرير السريع ومؤشر الصفحة.
• قد لا يتم دائمًا وضع ملفات PDF ذات الصفحة الواحدة في المنتصف وتغيير حجمها لتتناسب مع عرض العرض.

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

• أضِف تعليقًا توضيحيًا إلى containerStyleResId باستخدام @StyleRes. (I88d85)

الإصدار 1.0.0-alpha08

12 مارس 2025

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

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

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

الإصدار 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 (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مُجمِّع Kotlin). (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