آخر تعديل | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار التجريبي |
---|---|---|---|---|
26 شباط (فبراير) 2025 | - | - | - | 1.0.0-alpha07 |
الإعلان عن التبعيات
لإضافة تبعية على 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-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