pdf

تحديد الاعتماديات

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

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

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

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

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

الملاحظات

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

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

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

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

الإصدار 1.0

الإصدار ‎1.0.0-alpha14

‫25 فبراير 2026

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

الميزات الجديدة

• التفاعل مع الأجهزة الخارجية: يتوفّر الآن دعم كامل لاختصارات لوحة المفاتيح وأحداث الماوس في مكتبة PdfViewer .
  • التنقّل باستخدام لوحة المفاتيح وعناصر التحكّم:
  • التكبير أو التصغير: استخدِم Ctrl + + أو Ctrl + = للتكبير، وCtrl + - للتصغير، وCtrl + 0 لضبط المستند على "ملاءمة العرض".
  • التمرير: تتيح مفاتيح الأسهم العادية (لوحة التحكّم الاتجاهية) التمرير للأعلى والأسفل واليمين واليسار، بما في ذلك الانتقال إلى الصفحة التالية أو السابقة عند الحدود.
  • التحديد: استخدِم Ctrl + C لنسخ المحتوى المحدّد حاليًا بسرعة.
  • دعم محسَّن للماوس:
  • عجلة التمرير: إتاحة التمرير عموديًا وأفقيًا استخدِم Ctrl + عجلة التمرير لتكبير المستند أو تصغيره بالنسبة إلى موضع مؤشر الماوس.
  • التحديد: انقر واسحب باستخدام زر الماوس الأساسي لتحديد النص.
  • تحسينات على النماذج والتطبيقات المصغّرة:
  • تمت إضافة خيار "اختيار مخصّص" إلى مربّعات التحرير والسرد.
  • يتم الآن تفعيل وظيفة معاودة الاتصال لتعديل أداة النموذج عند إجراء أي تعديلات على النص

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

• عرض PdfDocument من PdfViewerFragment عبر onDocumentLoadSuccess(pdfDocument) (I4b47d، b/481616017)

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

• تجنَّب تقسيم Bitmap في ImageSelection لمنع RuntimeException عند حفظ حالة النسخة (I07bab).
• إيقاف ميزات التعليق التوضيحي أثناء تفعيل البحث في ملف PDF لتحسين التركيز Ia9866
• التأكّد من معالجة طلبات بدء/إنهاء التمييز دائمًا (I9a863)
• يتم التركيز على عنصر لوحة الألوان المحدّد أو شريط تمرير الفرشاة عند فتحه (Ie7a75).
• تعديل وظيفة معاودة الاتصال لتعديل أداة النموذج لتفعيلها عند إجراء جميع تعديلات النص (Icebe6)
• إصلاح مشكلة اختفاء مربّع حوار التجاهل بعد تغيير الإعدادات (I71a39)
• تم إصلاح مشكلة الرسم الذي يمتد خارج حدود الصفحة (I88bd5).
• إزالة تحديد النص عند الانتقال إلى وضع التعديل (I26fb9)
• تم إصلاح مشكلة عدم تعديل أداة النص بعد النقر على أداة أخرى (I5dffc).

الإصدار ‎1.0.0-alpha13

‫11 فبراير 2026

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

الميزات الجديدة

• تم طرح EditablePdfViewerFragment، وهو يوسّع نطاق PdfViewerFragment العادي لتوفير إمكانات تعديل ملفات PDF، بما في ذلك التعليقات التوضيحية وملء النماذج.
• التعليقات التوضيحية: تستفيد من مكتبة androidx.ink لتوفير دعم شامل للتعليقات التوضيحية في ملفات PDF. يمنح شريط الأدوات المخصّص، الذي يتم تفعيله من خلال رمز التعديل FloatingActionButton، إمكانية الوصول إلى أدوات متخصّصة، بما في ذلك:
  • القلم: يتيح الكتابة والرسم بخط اليد مباشرةً على المستند. يمكن للمستخدمين تخصيص ضربة القلم من خلال سمك قابل للتعديل ولوحة ألوان واسعة.
  • أداة التمييز: تتيح تمييز النص الحر والنص المحدد، وهي متوفرة بألوان متعددة.
  • الممحاة: لإزالة تعليقات توضيحية محدّدة بدقة
  • التراجع والإعادة: توفّر هذه الميزة إمكانات مدمجة للتراجع عن آخر التغييرات أو إعادتها بسلاسة.
• ملء النماذج: إتاحة النقر على حقول النماذج وتعديلها، مثل إدخالات النصوص والقوائم المنسدلة ومربّعات الاختيار وأزرار الاختيار
  • يتيح EditablePdfViewerFragment إمكانية ملء النماذج المضمّنة، ما يوفّر تجربة مستخدم سلسة. يتم التحكّم في هذه الميزة من خلال واجهة برمجة التطبيقات isFormFillingEnabled في PdfView.
  • EditablePdfDocument: واجهة جديدة توسّع PdfDocument لإدارة تعديلات بيانات النماذج وتطبيقها.
  • يتيح العنصر القابل للإنشاء PdfViewer التفاعل مع حقول النموذج، ويمكن التحكّم فيه من خلال المَعلمة isFormFillingEnabled.
• حفظ التغييرات: يتيح لك PdfWriteHandle حفظ المحتوى المعدَّل في ملف محدّد.
• اختيار الصور: تمت إضافة إمكانية اختيار الصور عند الضغط مع الاستمرار داخل مستندات PDF. يتم تفعيل هذه الميزة من خلال السمة isImageSelectionEnabled في كلّ من PdfView وPdfViewer القابل للإنشاء. يتم عرض البيانات الناتجة من خلال نموذج ImageSelection في OnSelectionChangedListener.
• تصميم الصفحتَين: تمت إضافة وضع تصميم جنبًا إلى جنب للأجهزة ذات الشاشات الكبيرة، ويمكن ضبطه باستخدام السمة pagesPerRow في PdfView وPdfViewer.

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

• إطلاق واجهة برمجة التطبيقات Image Selection API في مكتبة Jetpack PDF Library (Iee0b9، b/470897750)
• إتاحة واجهات برمجة التطبيقات الخاصة بطبقة معالجة ملء النماذج للجميع (Iec39c، b/474260451)
• إضافة المَعلمة renderParams إلى واجهة برمجة التطبيقات openDocument في SandboxedPdfLoader (If9344، b/438269273)
• إضافة واجهات برمجة تطبيقات لطبقة العرض الخاصة بملء النماذج (I829c5 وb/449869703)
• تمت إضافة التعليق التوضيحي @MainThread إلى طرق ردّ الاتصال في OnFirstContentLoadListener وOnSelectionChangedListener (I4cf10 وb/466965940)
• تم وضع علامة ApplyInProgressException على الدالة الإنشائية الداخلية، ما يمنع إنشاء مثيل خارجي (I5cc66، b/465414484)
• تمت إضافة التعليق التوضيحي @MainThread إلى طرق معاودة الاتصال الخاصة بمعالجات الأحداث في PdfView (Ie7201، b/429407597)
• إضافة واجهات برمجة تطبيقات لإتاحة إمكانات التعديل الأصلية من خلال EditablePdfViewerFragment (Ifae6c، b/462049364)
• إضافة واجهة برمجة التطبيقات FirstContentLoad إلى PdfView وPdfViewer (Icf63d وb/461666545)
• [2Page] إضافة Two-Page Layout API إلى PdfViewer Library (I8d7f1، b/452517650)

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

• إصلاح الاستثناء بسبب إغلاق الصفحة قبل جلب الصورة النقطية (b/475255729)

الإصدار ‎1.0.0-alpha12

‫3 ديسمبر 2025

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

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

• نقل الدالة textAsString من TextSelection إلى androidx-main
• إعادة تسمية clearSelection إلى clearCurrentSelection (I3a318، b/429407597)
• إزالة الدالة textAsString من TextSelection (I1305d، b/429407798)

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

• تم إصلاح مشكلة عدم ظهور أداة التمرير السريع في PdfView تلقائيًا. (I7fb0e)
• تم إصلاح عُطل في TextSelectionMenuProvider عند تحديد نص فارغ. (I855df)

الإصدار ‎1.0.0-alpha11

‫22 أكتوبر 2025

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

الميزات الجديدة

• تفعيل "عناصر القائمة الذكية" عند اختيار محتوى pdf
• تفعيل خيارَي تحديد الروابط التشعّبية والانتقال إلى الروابط في ملف PDF
• عرض واجهة برمجة التطبيقات لقائمة الاختيار fromPdfView وPdfViewer Composable، ما يتيح للمطوّرين إضافة عناصر إلى قائمة الاختيار
• إضافة واجهة برمجة تطبيقات لمحاذاة الصفحات في PdfView وPdfViewer Composable تتيح للمطوّرين اختيار محاذاة الصفحات عندما يكون ارتفاع المحتوى أقل من ارتفاع نافذة العرض

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

• تم السماح بقيمة فارغة للسمة contentDesc وإزالة القيمة التلقائية. (I86f8c، b/441973880)
• عرض PdfSelectionMenuKeys لعناصر قائمة اختيار الروابط (Ic9b05، b/447079082)
• إضافة واجهة برمجة التطبيقات PageAlignment إلى PdfView وPdfViewer في androidx-main
• تغيير واجهة برمجة التطبيقات ذات الصلة بالزوايا لاستخدام الدرجات وتضمين الوحدة في الأسماء، وتوضيح الوحدات في أدوات تحويل الزوايا وإتاحة استخدام الدرجات والراديان، وتغيير واجهة برمجة التطبيقات StockBrushes لتأخذ إصدار الفرشاة الجاهزة كمعلَمة دالة المصنع وعرض عنصر التحكّم في سلوك التداخل الذاتي لفرشاة التمييز، وإعادة تسمية MutableAffineTransform.populateFromTranslate إلى populateFromTranslation، وإزالة InProgressStrokesView.setRenderFactory/getRenderFactory (Id9eab، b/436656418)
• إضافة واجهة برمجة التطبيقات PageAlignment إلى PdfView وPdfViewer (I9c9a5، b/438065228)
• عرض واجهة برمجة التطبيقات لقائمة الاختيار من PdfViewer Composable (Id9b0f، b/407663999)
• اجعل PdfView ViewGroup. لا يمكن استخدام عناصر فرعية عشوائية. (Ib51d8، b/410008792)
• عرض HyperLinkSelection وGoToLinkSelection من PdfView (I378c4، b/441280002)
• إعادة تصميم PdfPageContent لتتوافق مع عمليات التحديد العامة (I28f16 وb/437845185)
• عرض واجهة برمجة التطبيقات لقائمة الاختيار من PdfView (Idd547، b/407663737)
• نقل الفئات ذات الصلة بتحديد النص إلى حزمة مخصّصة (I953cb، b/436157691)
• إتاحة ميزة تجريبية onPdfViewCreated للوصول إلى PdfView في PdfViewerFragment (I86715، b/422620454)
• إضافة واجهة برمجة التطبيقات FileDescriptor إلى PdfLoader (I60b8d)

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

• تحسين وضع نماذج الإدخال لجعل ضربات المفاتيح تعكس الإدخال بدقة أكبر (I93097)

المساهمة الخارجية

• عرض PdfSelectionMenuKeys لعناصر قائمة اختيار الروابط
• عرض واجهة برمجة التطبيقات لقائمة الاختيار من PdfViewer Composable
• عرض واجهة برمجة التطبيقات لقائمة الاختيار من PdfView

الإصدار ‎1.0.0-alpha10

‫16 يوليو 2025

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

الميزات الجديدة

• تتيح هذه الميزة للمستخدمين اختيار نص على صفحات متعددة من خلال سحب مقابض التحديد إلى ما بعد حدود الصفحة.
• يمكن للتطبيقات الآن اعتراض عمليات النقر على الروابط التشعّبية وتخصيص طريقة التعامل معها داخل مستندات PDF.

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

• تعرض هذه السمة عنصرًا قابلاً للإنشاء لعرض محتوى PDF (I8e7ee)
• جارٍ نقل PdfPoint وPdfRect إلى حزمة androidx.pdf.models (I26cf4)
• عرض مكوّن View لعرض محتوى PDF (I9fe27)
• إتاحة واجهة برمجة التطبيقات لتهيئة موارد ملفات PDF مسبقًا وتقليل وقت الاستجابة عند بدء التشغيل البارد (a18fa89)
• عرض واجهة برمجة التطبيقات لتجاوز معالجة النقر على الروابط التشعّبية في محتوى PDF(6330a8b)
• تعرض هذه الحزمة عنصرًا جديدًا باسم pdf-document-service وواجهات برمجة التطبيقات المقابلة: PdfLoader وPdfDocument وSandboxedPdfLoader. يمكن استخدام الواجهات لتنفيذ مكوّن تحليل مستند PDF ومعالجته (Ide70d).
• تعرض واجهة برمجة تطبيقات لضبط PdfDocument على PdfView من أجل بدء عرض المستند (If8738)

الإصدار ‎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 مع معرّف الموارد المنتظم (URI) للمستند.

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

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

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

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

ملاحظة

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