pdf

  
مكتبة لإضافة إمكانات عرض ملفات PDF داخل التطبيقات
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫01 يوليو 2026 - - - 1.0.0-alpha19

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

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

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

Groovy

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

Kotlin

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

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

الملاحظات

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

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

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

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

الإصدار 1.0 من ملف PDF

الإصدار ‎1.0.0-alpha19

‫01 يوليو 2026

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

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

  • إتاحة AnnotationView للجميع (I8219f)
  • اجعلوا فئات EditablePdfDocument والتعليقات التوضيحية متاحة للجميع. (I5b962)
  • تم تقديم وحدة فرعية جديدة باسم pdf-core (Iea331)
  • تم نقل واجهات برمجة التطبيقات الأساسية لملفات PDF إلى عنصر pdf-core جديد لفصل نماذج المستندات عن تنفيذ العرض. (I26e1f)
  • عرض واجهات برمجة التطبيقات OcrProvider لإتاحة التعرّف على النصوص المستندة إلى الصور (I5271b)
  • تمت إزالة الطريقة onLoadDocumentSuccess() التي تم إيقافها نهائيًا بدون مَعلمات من PdfViewerFragment والخاصية isLinearized التي تم إيقافها نهائيًا من PdfDocument. (I6b7ab)
  • تم تفعيل ميزة "الملء التلقائي" لملء النماذج.

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

  • تم إصلاح مشكلة عدم موثوقية التنقّل الأفقي في الصفحة عند الحواف لأنّه لم يتم أخذ اتجاه التنقّل في الصفحة في الاعتبار عند إدارة اعتراض أحداث اللمس. (I6bda5، b/505645009)
  • تم إصلاح مشكلة لضمان عرض أداة التمرير السريع دائمًا عند تفعيل ميزات تسهيل الاستخدام. (Idaf5e، b/513082550)

الإصدار ‎1.0.0-alpha18

‫22 أبريل 2026

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

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

  • تمت إعادة نقل ميزات القراءة والعرض في مكتبة PDF إلى الإصدارات القديمة لتتوافق مع أجهزة Android التي تعمل بالإصدار minSdk = 28 والإصدارات الأحدث، كما يوسّع الإصدار sdk-extension < 13 نطاق التوافق ليشمل ملياري جهاز Android نشط إضافي (I808f8).
  • تمت إضافة واجهة برمجة التطبيقات getSelectionBounds المستندة إلى SelectionBoundary إلى PdfDocument. (Ida6ea)

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

  • تمت معالجة RemoteException داخليًا في PageBitmapSource.close() (I2c59e)

الإصدار ‎1.0.0-alpha17

‫8 أبريل 2026

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

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

  • أضِف واجهة برمجة تطبيقات contentPadding إلى عنصر PdfViewer القابل للإنشاء. (Idcfd4، b/481774503)

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

  • تم تعديل Compose compileSdk إلى الإصدار 37 من واجهة برمجة التطبيقات. وهذا يعني أنّه يجب توفُّر الإصدار 9.2.0 أو إصدار أحدث من "مكوّن Android الإضافي" عند استخدام Compose. (Id45cd، b/413674743)

الإصدار ‎1.0.0-alpha16

‫25 مارس 2026

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

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

  • يتيح تطبيق "EditablePdfViewerFragment" الآن عرض التعليقات التوضيحية المميّزة التي تمت إضافتها من تطبيقات أخرى ومحوها. (Ic46e4)

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

الإصدار ‎1.0.0-alpha15

‫11 مارس 2026

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

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

  • تمت إضافة الإصدار 19 من "إضافة حزمة تطوير البرامج (SDK) لنظام التشغيل Android" كشرط أساسي لاستخدام ميزة "ImageSelection" (I93af7)
  • تم وضع علامة isLinearized Boolean على أنّه متوقّف نهائيًا وتم استبداله بـ linearizationStatus IntDef(I5c1bf)

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

  • إصلاح عرض أداة التمرير السريع بدون نص عند استخدام إيماءة النقر الفردي لمكوّن PdfViewer الإنشاء (I442b7)
  • النقر على وسط مركز الأدوات المصغّرة clickTypeWidgets.(Ie5661)
  • نقل المكتبات لاستخدام الإصدار 11 من Java وهذا يعني أنّ الرمز الثانوي الذي تم إنشاؤه سيكون Java 11 (إصدار ملف الفئة 55) وقد يتطلّب إزالة التكرار لاستخدام المكتبة (If4c2a، b/457821470).

الإصدار ‎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 من حزمة تطوير البرامج (SDK)). ستتم إتاحة الإصدارات القديمة من 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