این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

pdf

کتابخانه ای برای افزودن قابلیت مشاهده pdf در داخل برنامه ها.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
7 مه 2025	-	-	-	1.0.0-alpha09

اعلام وابستگی ها

برای افزودن وابستگی به 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 حاوی این تعهدات است.

تغییرات عمده

پایگاه کد تحت یک بازسازی بزرگ قرار گرفته است و اکنون با استفاده از Coroutines و ViewModel به طور کامل در Kotlin نوشته شده است. این شامل اجرای مجدد PdfViewerFragment است. این نسخه شامل هیچ API یا ویژگی جدیدی نیست.

مسائل شناخته شده:

پیمایش سریع و نشانگر صفحه دارای جلوه های سایه نیستند.
ممکن است اسناد پی دی اف تک صفحه ای همیشه در مرکز و به عرض نما نباشند.

تغییرات API

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 حاوی این commit ها است.

ویژگی های جدید

اکنون PdfViewerFragment از StylingOptions (مجموعه‌ای از شناسه‌های منبع سبک) پشتیبانی می‌کند که استایل‌سازی سفارشی را از طریق newInstance یا XML ( FragmentContainerView ) ممکن می‌سازد. زیر کلاس ها می توانند از سازنده محافظت شده برای عملکردهای مشابه استفاده کنند.
StylingOptions در حال حاضر containerStyle دریافت می کند که ارائه می دهد:
- پشتیبانی قابل کشیدن سفارشی برای دسته اسکرول سریع و نشانگر صفحه.
- ویژگی marginEnd برای موقعیت یابی دقیق دسته اسکرول سریع و نشانگر صفحه.

تغییرات API

مشخصات عمومی اضافه شده از PdfView ( I30fc5 )
APIs 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 )
صفحه ثابتی که قبلاً باز شده بود پس از چرخش در اندروید 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 مرتبط است.

تغییرات API

حداقل محدودیت SdkExtension به PdfViewerFragment اضافه شد. ( I922af )
افشای apis جدید برای کتابخانه PDF Viewer. ( I0af57 )

رفع اشکال

رفع خرابی برای مشکل مرگ فرآیند.
رفع UI مربوط به گفتگوی رمز عبور.
رفع دسترسی برای 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 حاوی این تعهدات است.

رفع اشکال

هنگامی که جستجو برای اولین بار باز می شود، صفحه کلید بالا نمی آید
رفع UI مربوط به فونت نمای FindInFile.
رفع UI برای انتخاب متن و کشیدن دسته.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 هنگام چرخش از حالت عمودی به افقی و برنامه در حالت خواب حل شده است.
منوی Find in file اکنون حتی زمانی که پیکربندی تغییر می کند، تعداد نتایج را حفظ می کند.
نماد FloatingActionButton اکنون برای PDF های تک صفحه ای در دسترس است.
مشکلات همپوشانی بین Find in file bar و FloatingActionButton رفع شده است.
متن و حاشیه‌نویسی برجسته اکنون می‌تواند در بیننده ارائه شود.
بهبود قابلیت دسترسی در نوار فایل Find in انجام شده است.
اصلاحات رابط کاربری برای چرخش پیاده‌سازی شده‌اند، از جمله حفظ تعداد یافتن، رسیدگی به منوی انتخاب متن در حال ناپدید شدن، و حل مشکل همپوشانی FAB.
یافتن در منوی فایل که پشت صفحه کلید در حالت افقی پنهان شده بود، رفع شده است.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 (SDK 35) پشتیبانی می‌شود. پشتیبانی از نسخه های قدیمی اندروید در نسخه های بعدی اضافه خواهد شد.

PdfViewerFragment را معرفی کرد که برنامه شما می تواند از آن برای ارائه یک سند PDF استفاده کند. PdfViewerFragment یکپارچه سازی یک نمایشگر PDF در فعالیت شما را ساده می کند و به کاربران اجازه می دهد به روش های زیر تعامل داشته باشند:
- بزرگنمایی: برای تنظیم سطوح زوم برای تجربه خواندن راحت و همچنین دو ضربه سریع برای بزرگنمایی/کوچک کردن سریع به حالت پیش فرض، به داخل و خارج کنید.
- پیمایش: در حالت پیش فرض/بزرگنمایی شده پیمایش کنید. PdfViewerFragment یک اسکرابر سریع برای پیمایش سریع بین صفحات فراهم می کند.
- اقدامات متنی: با ضربه زدن طولانی روی متن آن را انتخاب می‌کند و به کاربران امکان می‌دهد از گزینه‌هایی مانند کپی و انتخاب همه در صفحه فعلی استفاده کنند.
- اسناد محافظت شده با رمز عبور: PdfViewerFragment یک کادر محاوره ای برای کاربر فراهم می کند تا رمز عبور را وارد کرده و سند را باز کند.
- هایپرلینک های قابل پیمایش: کاربران می توانند با ضربه زدن بر روی پیوندهای داخل PDF به آدرس های وب یا نشانک ها حرکت کنند.
- میانبر به حالت حاشیه نویسی: حالت ویرایش هنوز در PdfViewerFragment پشتیبانی نمی شود. در عوض، PdfViewerFragment یک FloatingActionButton نمایش می دهد که یک intent ضمنی android.intent.action.ANNOTATE را با URI سند اجرا می کند.

تغییرات API

ویژگی PdfViewerFragment.documentUri را برای تنظیم یک فایل یا محتوای URI برای سند و شروع بارگیری سند اضافه کرد. PdfViewerFragment هنگامی که URI تنظیم شده است که پردازش پس‌زمینه سند را نشان می‌دهد، یک اسپینر بارگیری را نشان می‌دهد.
PdfViewerFragment.isTextSearchActive اضافه شد تا قابلیت مشاهده یافتن در منوی فایل را تغییر دهد. PdfViewerFragment کل جریان را کنترل می کند - اجازه ورودی، نمایش تعداد کل موارد مطابق، امکان ناوبری بین نتایج و خروج از آن را می دهد.
تماس‌های onDocumentLoadSuccess و onDocumentLoadError اضافه شده است که پس از رندر موفقیت‌آمیز سند یا پس از پرتاب خطا قبل از رندر فراخوانی می‌شوند.

مسائل شناخته شده

در برخی موارد نوار فایل با FloatingActionButton همپوشانی دارد.
نماد FloatingActionButton برای PDF های تک صفحه ای قابل مشاهده نیست.
تعداد نتایج در تغییر پیکربندی در منوی Find in file حفظ نمی‌شود.
هنگام بستن منوی Find in file، سوسو زدن مشاهده می شود
تصاویر سه بعدی در اسناد PDF در بیننده ارائه نمی شوند.
ویژگی‌های دسترس‌پذیری در نسخه‌های زیر فعال خواهند شد.
تصویر PDF با چرخش از حالت عمودی به افقی تار می شود.
بدون پشتیبانی از حاشیه نویسی متن/هایلایت.
PdfViewerFragment دارای برخی مشکلات عملکرد در اسناد PDF بسیار بزرگ (بیش از 250 مگابایت) است.

توجه داشته باشید

compileSdk به 35 5dc41be به روز کنید

pdf

مرجع API
androidx.pdf.viewer.fragment

کتابخانه ای برای افزودن قابلیت مشاهده pdf در داخل برنامه ها.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
7 مه 2025	-	-	-	1.0.0-alpha09

اعلام وابستگی ها

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار

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

کاتلین

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

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

هیچ یادداشت انتشار برای این مصنوع وجود ندارد.

نسخه 1.0

نسخه 1.0.0-alpha09

7 مه 2025

androidx.pdf:pdf-*:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 حاوی این تعهدات است.

تغییرات عمده

پایگاه کد تحت یک بازسازی بزرگ قرار گرفته است و اکنون با استفاده از Coroutines و ViewModel به طور کامل در Kotlin نوشته شده است. این شامل اجرای مجدد PdfViewerFragment است. این نسخه شامل هیچ API یا ویژگی جدیدی نیست.

مسائل شناخته شده:

پیمایش سریع و نشانگر صفحه دارای جلوه های سایه نیستند.
ممکن است اسناد پی دی اف تک صفحه ای همیشه در مرکز و به عرض نما نباشند.

تغییرات API

containerStyleResId با @StyleRes حاشیه نویسی کنید. ( I88d85 )

نسخه 1.0.0-alpha08

12 مارس 2025

رفع اشکال

به دلیل تفاوت‌های مقیاس‌بندی، قرار دادن منوی انتخاب ناسازگار بین دستگاه‌های Android مختلف برطرف شد. قرار دادن منوی انتخاب اکنون در بین دستگاه‌ها ثابت است.
پیمایش سریع تراز شده و موقعیت نشانگر صفحه در بازآفرینی قطعه در سناریوهایی مانند تغییر پیکربندی و غیره.

نسخه 1.0.0-alpha07

26 فوریه 2025

ویژگی های جدید

اکنون PdfViewerFragment از StylingOptions (مجموعه‌ای از شناسه‌های منبع سبک) پشتیبانی می‌کند که استایل‌سازی سفارشی را از طریق newInstance یا XML ( FragmentContainerView ) ممکن می‌سازد. زیر کلاس ها می توانند از سازنده محافظت شده برای عملکردهای مشابه استفاده کنند.
StylingOptions در حال حاضر containerStyle دریافت می کند که ارائه می دهد:
- پشتیبانی قابل کشیدن سفارشی برای دسته اسکرول سریع و نشانگر صفحه.
- ویژگی marginEnd برای موقعیت یابی دقیق دسته اسکرول سریع و نشانگر صفحه.

تغییرات API

مشخصات عمومی اضافه شده از PdfView ( I30fc5 )
APIs StylingOptions جدید برای نمای pdf اضافه شد. ( ID2993 )

رفع اشکال

رفع اختلاف همگام سازی بین دسته پیمایش سریع و وضعیت دید نشانگر صفحه.

نسخه 1.0.0-alpha06

29 ژانویه 2025

رفع اشکال

رفع: خرابی ناشی از IllegalArgumentException هنگام لغو اتصال سرویسی که ثبت نشده است ( eb4e85 )
رفع: خرابی IllegalArgumentException به دلیل تفاوت در mMaxPages و numPages . ( 75d763 )

نسخه 1.0.0-alpha05

11 دسامبر 2024

رفع اشکال

این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش فرض با نسخه 2.1.0 کامپایلر Kotlin شروع می شود). ( I38301 , b/326456246 )
صفحه ثابتی که قبلاً باز شده بود پس از چرخش در اندروید 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 مرتبط است.

تغییرات API

حداقل محدودیت SdkExtension به PdfViewerFragment اضافه شد. ( I922af )
افشای apis جدید برای کتابخانه PDF Viewer. ( I0af57 )

رفع اشکال

رفع خرابی برای مشکل مرگ فرآیند.
رفع UI مربوط به گفتگوی رمز عبور.
رفع دسترسی برای 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 حاوی این تعهدات است.

رفع اشکال

هنگامی که جستجو برای اولین بار باز می شود، صفحه کلید بالا نمی آید
رفع UI مربوط به فونت نمای FindInFile.
رفع UI برای انتخاب متن و کشیدن دسته.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 هنگام چرخش از حالت عمودی به افقی و برنامه در حالت خواب حل شده است.
منوی Find in file اکنون حتی زمانی که پیکربندی تغییر می کند، تعداد نتایج را حفظ می کند.
نماد FloatingActionButton اکنون برای PDF های تک صفحه ای در دسترس است.
مشکلات همپوشانی بین Find in file bar و FloatingActionButton رفع شده است.
متن و حاشیه‌نویسی برجسته اکنون می‌تواند در بیننده ارائه شود.
بهبود قابلیت دسترسی در نوار فایل Find in انجام شده است.
اصلاحات رابط کاربری برای چرخش پیاده‌سازی شده‌اند، از جمله حفظ تعداد یافتن، رسیدگی به منوی انتخاب متن در حال ناپدید شدن، و حل مشکل همپوشانی FAB.
یافتن در منوی فایل که پشت صفحه کلید در حالت افقی پنهان شده بود، رفع شده است.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 حاوی این تعهدات است.

ویژگی های جدید

PdfViewerFragment را معرفی کرد که برنامه شما می تواند از آن برای ارائه یک سند PDF استفاده کند. PdfViewerFragment یکپارچه سازی یک نمایشگر PDF در فعالیت شما را ساده می کند و به کاربران اجازه می دهد به روش های زیر تعامل داشته باشند:
- بزرگنمایی: برای تنظیم سطوح زوم برای تجربه خواندن راحت و همچنین دو ضربه سریع برای بزرگنمایی/کوچک کردن سریع به حالت پیش فرض، به داخل و خارج کنید.
- پیمایش: در حالت پیش فرض/بزرگنمایی شده پیمایش کنید. PdfViewerFragment یک اسکرابر سریع برای پیمایش سریع بین صفحات فراهم می کند.
- اقدامات متنی: با ضربه زدن طولانی روی متن آن را انتخاب می‌کند و به کاربران امکان می‌دهد از گزینه‌هایی مانند کپی و انتخاب همه در صفحه فعلی استفاده کنند.
- اسناد محافظت شده با رمز عبور: PdfViewerFragment یک کادر محاوره ای برای کاربر فراهم می کند تا رمز عبور را وارد کرده و سند را باز کند.
- هایپرلینک های قابل پیمایش: کاربران می توانند با ضربه زدن بر روی پیوندهای داخل PDF به آدرس های وب یا نشانک ها حرکت کنند.
- میانبر به حالت حاشیه نویسی: حالت ویرایش هنوز در PdfViewerFragment پشتیبانی نمی شود. در عوض، PdfViewerFragment یک FloatingActionButton نمایش می دهد که یک intent ضمنی android.intent.action.ANNOTATE را با URI سند اجرا می کند.

تغییرات API

ویژگی PdfViewerFragment.documentUri را برای تنظیم یک فایل یا محتوای URI برای سند و شروع بارگیری سند اضافه کرد. PdfViewerFragment هنگامی که URI تنظیم شده است که پردازش پس‌زمینه سند را نشان می‌دهد، یک اسپینر بارگیری را نشان می‌دهد.
PdfViewerFragment.isTextSearchActive اضافه شد تا قابلیت مشاهده یافتن در منوی فایل را تغییر دهد. PdfViewerFragment کل جریان را کنترل می کند - اجازه ورودی، نمایش تعداد کل موارد مطابق، امکان ناوبری بین نتایج و خروج از آن را می دهد.
تماس‌های onDocumentLoadSuccess و onDocumentLoadError اضافه شده است که پس از رندر موفقیت‌آمیز سند یا پس از پرتاب خطا قبل از رندر فراخوانی می‌شوند.

مسائل شناخته شده

در برخی موارد نوار فایل با FloatingActionButton همپوشانی دارد.
نماد FloatingActionButton برای PDF های تک صفحه ای قابل مشاهده نیست.
تعداد نتایج در تغییر پیکربندی در منوی Find in file حفظ نمی‌شود.
هنگام بستن منوی Find in file، سوسو زدن مشاهده می شود
تصاویر سه بعدی در اسناد PDF در بیننده ارائه نمی شوند.
ویژگی‌های دسترس‌پذیری در نسخه‌های زیر فعال خواهند شد.
تصویر PDF با چرخش از حالت عمودی به افقی تار می شود.
بدون پشتیبانی از حاشیه نویسی متن/هایلایت.
PdfViewerFragment دارای برخی مشکلات عملکرد در اسناد PDF بسیار بزرگ (بیش از 250 مگابایت) است.

توجه داشته باشید

compileSdk به 35 5dc41be به روز کنید

pdf

مرجع API
androidx.pdf.viewer.fragment

کتابخانه ای برای افزودن قابلیت مشاهده pdf در داخل برنامه ها.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
7 مه 2025	-	-	-	1.0.0-alpha09

اعلام وابستگی ها

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار

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

کاتلین

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

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

هیچ یادداشت انتشار برای این مصنوع وجود ندارد.

نسخه 1.0

نسخه 1.0.0-alpha09

7 مه 2025

androidx.pdf:pdf-*:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 حاوی این تعهدات است.

تغییرات عمده

پایگاه کد تحت یک بازسازی بزرگ قرار گرفته است و اکنون با استفاده از Coroutines و ViewModel به طور کامل در Kotlin نوشته شده است. این شامل اجرای مجدد PdfViewerFragment است. این نسخه شامل هیچ API یا ویژگی جدیدی نیست.

مسائل شناخته شده:

پیمایش سریع و نشانگر صفحه دارای جلوه های سایه نیستند.
ممکن است اسناد پی دی اف تک صفحه ای همیشه در مرکز و به عرض نما نباشند.

تغییرات API

containerStyleResId با @StyleRes حاشیه نویسی کنید. ( I88d85 )

نسخه 1.0.0-alpha08

12 مارس 2025

رفع اشکال

به دلیل تفاوت‌های مقیاس‌بندی، قرار دادن منوی انتخاب ناسازگار بین دستگاه‌های Android مختلف برطرف شد. قرار دادن منوی انتخاب اکنون در بین دستگاه‌ها ثابت است.
پیمایش سریع تراز شده و موقعیت نشانگر صفحه در بازآفرینی قطعه در سناریوهایی مانند تغییر پیکربندی و غیره.

نسخه 1.0.0-alpha07

26 فوریه 2025

ویژگی های جدید

اکنون PdfViewerFragment از StylingOptions (مجموعه‌ای از شناسه‌های منبع سبک) پشتیبانی می‌کند که استایل‌سازی سفارشی را از طریق newInstance یا XML ( FragmentContainerView ) ممکن می‌سازد. زیر کلاس ها می توانند از سازنده محافظت شده برای عملکردهای مشابه استفاده کنند.
StylingOptions در حال حاضر containerStyle دریافت می کند که ارائه می دهد:
- پشتیبانی قابل کشیدن سفارشی برای دسته اسکرول سریع و نشانگر صفحه.
- ویژگی marginEnd برای موقعیت یابی دقیق دسته اسکرول سریع و نشانگر صفحه.

تغییرات API

مشخصات عمومی اضافه شده از PdfView ( I30fc5 )
APIs StylingOptions جدید برای نمای pdf اضافه شد. ( ID2993 )

رفع اشکال

رفع اختلاف همگام سازی بین دسته پیمایش سریع و وضعیت دید نشانگر صفحه.

نسخه 1.0.0-alpha06

29 ژانویه 2025

رفع اشکال

رفع: خرابی ناشی از IllegalArgumentException هنگام لغو اتصال سرویسی که ثبت نشده است ( eb4e85 )
رفع: خرابی IllegalArgumentException به دلیل تفاوت در mMaxPages و numPages . ( 75d763 )

نسخه 1.0.0-alpha05

11 دسامبر 2024

رفع اشکال

این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش فرض با نسخه 2.1.0 کامپایلر Kotlin شروع می شود). ( I38301 , b/326456246 )
صفحه ثابتی که قبلاً باز شده بود پس از چرخش در اندروید 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 مرتبط است.

تغییرات API

حداقل محدودیت SdkExtension به PdfViewerFragment اضافه شد. ( I922af )
افشای apis جدید برای کتابخانه PDF Viewer. ( I0af57 )

رفع اشکال

رفع خرابی برای مشکل مرگ فرآیند.
رفع UI مربوط به گفتگوی رمز عبور.
رفع دسترسی برای 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 حاوی این تعهدات است.

رفع اشکال

هنگامی که جستجو برای اولین بار باز می شود، صفحه کلید بالا نمی آید
رفع UI مربوط به فونت نمای FindInFile.
رفع UI برای انتخاب متن و کشیدن دسته.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 هنگام چرخش از حالت عمودی به افقی و برنامه در حالت خواب حل شده است.
منوی Find in file اکنون حتی زمانی که پیکربندی تغییر می کند، تعداد نتایج را حفظ می کند.
نماد FloatingActionButton اکنون برای PDF های تک صفحه ای در دسترس است.
مشکلات همپوشانی بین Find in file bar و FloatingActionButton رفع شده است.
متن و حاشیه‌نویسی برجسته اکنون می‌تواند در بیننده ارائه شود.
بهبود قابلیت دسترسی در نوار فایل Find in انجام شده است.
اصلاحات رابط کاربری برای چرخش پیاده‌سازی شده‌اند، از جمله حفظ تعداد یافتن، رسیدگی به منوی انتخاب متن در حال ناپدید شدن، و حل مشکل همپوشانی FAB.
یافتن در منوی فایل که پشت صفحه کلید در حالت افقی پنهان شده بود، رفع شده است.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 حاوی این تعهدات است.

ویژگی های جدید

PdfViewerFragment را معرفی کرد که برنامه شما می تواند از آن برای ارائه یک سند PDF استفاده کند. PdfViewerFragment یکپارچه سازی یک نمایشگر PDF در فعالیت شما را ساده می کند و به کاربران اجازه می دهد به روش های زیر تعامل داشته باشند:
- بزرگنمایی: برای تنظیم سطوح زوم برای تجربه خواندن راحت و همچنین دو ضربه سریع برای بزرگنمایی/کوچک کردن سریع به حالت پیش فرض، به داخل و خارج کنید.
- پیمایش: در حالت پیش فرض/بزرگنمایی شده پیمایش کنید. PdfViewerFragment یک اسکرابر سریع برای پیمایش سریع بین صفحات فراهم می کند.
- اقدامات متنی: با ضربه زدن طولانی روی متن آن را انتخاب می‌کند و به کاربران امکان می‌دهد از گزینه‌هایی مانند کپی و انتخاب همه در صفحه فعلی استفاده کنند.
- اسناد محافظت شده با رمز عبور: PdfViewerFragment یک کادر محاوره ای برای کاربر فراهم می کند تا رمز عبور را وارد کرده و سند را باز کند.
- هایپرلینک های قابل پیمایش: کاربران می توانند با ضربه زدن بر روی پیوندهای داخل PDF به آدرس های وب یا نشانک ها حرکت کنند.
- میانبر به حالت حاشیه نویسی: حالت ویرایش هنوز در PdfViewerFragment پشتیبانی نمی شود. در عوض، PdfViewerFragment یک FloatingActionButton نمایش می دهد که یک intent ضمنی android.intent.action.ANNOTATE را با URI سند اجرا می کند.

تغییرات API

ویژگی PdfViewerFragment.documentUri را برای تنظیم یک فایل یا محتوای URI برای سند و شروع بارگیری سند اضافه کرد. PdfViewerFragment هنگامی که URI تنظیم شده است که پردازش پس‌زمینه سند را نشان می‌دهد، یک اسپینر بارگیری را نشان می‌دهد.
PdfViewerFragment.isTextSearchActive اضافه شد تا قابلیت مشاهده یافتن در منوی فایل را تغییر دهد. PdfViewerFragment کل جریان را کنترل می کند - اجازه ورودی، نمایش تعداد کل موارد مطابق، امکان ناوبری بین نتایج و خروج از آن را می دهد.
تماس‌های onDocumentLoadSuccess و onDocumentLoadError اضافه شده است که پس از رندر موفقیت‌آمیز سند یا پس از پرتاب خطا قبل از رندر فراخوانی می‌شوند.

مسائل شناخته شده

در برخی موارد نوار فایل با FloatingActionButton همپوشانی دارد.
نماد FloatingActionButton برای PDF های تک صفحه ای قابل مشاهده نیست.
تعداد نتایج در تغییر پیکربندی در منوی Find in file حفظ نمی‌شود.
هنگام بستن منوی Find in file، سوسو زدن مشاهده می شود
تصاویر سه بعدی در اسناد PDF در بیننده ارائه نمی شوند.
ویژگی‌های دسترس‌پذیری در نسخه‌های زیر فعال خواهند شد.
تصویر PDF با چرخش از حالت عمودی به افقی تار می شود.
بدون پشتیبانی از حاشیه نویسی متن/هایلایت.
PdfViewerFragment دارای برخی مشکلات عملکرد در اسناد PDF بسیار بزرگ (بیش از 250 مگابایت) است.

توجه داشته باشید

compileSdk به 35 5dc41be به روز کنید

pdf

مرجع API
androidx.pdf.viewer.fragment

کتابخانه ای برای افزودن قابلیت مشاهده pdf در داخل برنامه ها.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
7 مه 2025	-	-	-	1.0.0-alpha09

اعلام وابستگی ها

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار

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

کاتلین

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

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

هیچ یادداشت انتشار برای این مصنوع وجود ندارد.

نسخه 1.0

نسخه 1.0.0-alpha09

7 مه 2025

androidx.pdf:pdf-*:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 حاوی این تعهدات است.

تغییرات عمده

پایگاه کد تحت یک بازسازی بزرگ قرار گرفته است و اکنون با استفاده از Coroutines و ViewModel به طور کامل در Kotlin نوشته شده است. این شامل اجرای مجدد PdfViewerFragment است. این نسخه شامل هیچ API یا ویژگی جدیدی نیست.

مسائل شناخته شده:

پیمایش سریع و نشانگر صفحه دارای جلوه های سایه نیستند.
ممکن است اسناد پی دی اف تک صفحه ای همیشه در مرکز و به عرض نما نباشند.

تغییرات API

containerStyleResId با @StyleRes حاشیه نویسی کنید. ( I88d85 )

نسخه 1.0.0-alpha08

12 مارس 2025

رفع اشکال

به دلیل تفاوت‌های مقیاس‌بندی، قرار دادن منوی انتخاب ناسازگار بین دستگاه‌های Android مختلف برطرف شد. قرار دادن منوی انتخاب اکنون در بین دستگاه‌ها ثابت است.
پیمایش سریع تراز شده و موقعیت نشانگر صفحه در بازآفرینی قطعه در سناریوهایی مانند تغییر پیکربندی و غیره.

نسخه 1.0.0-alpha07

26 فوریه 2025

ویژگی های جدید

اکنون PdfViewerFragment از StylingOptions (مجموعه‌ای از شناسه‌های منبع سبک) پشتیبانی می‌کند که استایل‌سازی سفارشی را از طریق newInstance یا XML ( FragmentContainerView ) ممکن می‌سازد. زیر کلاس ها می توانند از سازنده محافظت شده برای عملکردهای مشابه استفاده کنند.
StylingOptions در حال حاضر containerStyle دریافت می کند که ارائه می دهد:
- پشتیبانی قابل کشیدن سفارشی برای دسته اسکرول سریع و نشانگر صفحه.
- ویژگی marginEnd برای موقعیت یابی دقیق دسته اسکرول سریع و نشانگر صفحه.

تغییرات API

مشخصات عمومی اضافه شده از PdfView ( I30fc5 )
APIs StylingOptions جدید برای نمای pdf اضافه شد. ( ID2993 )

رفع اشکال

رفع اختلاف همگام سازی بین دسته پیمایش سریع و وضعیت دید نشانگر صفحه.

نسخه 1.0.0-alpha06

29 ژانویه 2025

رفع اشکال

رفع: خرابی ناشی از IllegalArgumentException هنگام لغو اتصال سرویسی که ثبت نشده است ( eb4e85 )
رفع: خرابی IllegalArgumentException به دلیل تفاوت در mMaxPages و numPages . ( 75d763 )

نسخه 1.0.0-alpha05

11 دسامبر 2024

رفع اشکال

این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش فرض با نسخه 2.1.0 کامپایلر Kotlin شروع می شود). ( I38301 , b/326456246 )
صفحه ثابتی که قبلاً باز شده بود پس از چرخش در اندروید 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 مرتبط است.

API تغییر می کند

حداقل محدودیت SdkExtension به PdfViewerFragment اضافه شده است. ( i922af )
افشای API های جدید برای کتابخانه بیننده PDF. ( i0af57 )

رفع اشکال

رفع مشکل برای مسئله مرگ فرآیند.
رفع UI مربوط به گفتگوی رمز عبور.
رفع دسترسی برای findInFileView و FastscrollView .

توسعه مداوم

ما به طور فعال در تلاش هستیم تا آهنگسازی Jetpack را در کتابخانه بگنجانیم.

نسخه 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 شامل این تعهدات است.

رفع اشکال

صفحه کلید هنگام باز شدن جستجو برای اولین بار برطرف نمی شود
رفع UI مربوط به قلم نمای FindInfile.
رفع UI برای انتخاب متن و دسته کشیدن.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 شامل این تعهدات است.

رفع اشکال

مسئله تصویر Blurry PDF هنگام چرخش از پرتره به چشم انداز و برنامه رفتن به خواب برطرف شده است.
منوی Find in File اکنون تعداد نتیجه را حتی در صورت تغییر پیکربندی حفظ می کند.
نماد FloatingActionButton اکنون برای PDF های تک صفحه ای در دسترس است.
با هم همپوشانی بین Find in File Bar و FloatingActionButton برطرف شده است.
متن و یادداشت های برجسته اکنون می توانند در بیننده ارائه شوند.
پیشرفت های دسترسی به Find in File Bar انجام شده است.
اصلاحات UI برای چرخش اجرا شده است ، از جمله حفظ تعداد یافتن ، پرداختن به منوی انتخاب متن ناپدید شده و حل مسئله FAB.
منوی Find in File که در پشت صفحه کلید در حالت چشم انداز پنهان شده است ، ثابت شده است.

مسائل شناخته شده

تصاویر سه بعدی در اسناد 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 (SDK 35) پشتیبانی می شود. پشتیبانی از نسخه های قدیمی Android در نسخه های آینده اضافه می شود.

معرفی شده PdfViewerFragment که برنامه شما می تواند برای ارائه یک سند PDF از آن استفاده کند. PdfViewerFragment ادغام یک بیننده pdf در فعالیت شما را ساده می کند و به کاربران اجازه می دهد تا به روش های زیر تعامل داشته باشند:
- بزرگنمایی: برای تنظیم سطح بزرگنمایی برای یک تجربه خواندن راحت و همچنین دو برابر ضربه زدن به یک بزرگنمایی سریع در داخل/خارج به حالت پیش فرض ، وارد و خارج شوید.
- ناوبری: در حالت پیش فرض/بزرگنمایی پیمایش کنید. PdfViewerFragment یک اسکراب سریع برای پیمایش سریع بین صفحات فراهم می کند.
- اقدامات متنی: ضربه زدن طولانی روی متن آن را انتخاب می کند و به کاربران این امکان را می دهد تا از گزینه هایی مانند کپی استفاده کنند و همه را در صفحه فعلی انتخاب کنند.
- اسناد محافظت شده با رمز عبور: PdfViewerFragment یک کادر گفتگو را برای کاربر فراهم می کند تا رمز عبور را وارد کرده و سند را باز کند.
- لینک های قابل پیمایش: کاربران می توانند با ضربه زدن به لینک های موجود در PDF به URL های وب یا نشانک ها حرکت کنند.
- میانبر به حالت حاشیه نویسی: حالت ویرایش هنوز در PdfViewerFragment پشتیبانی نمی شود. در عوض ، PdfViewerFragment یک FloatingActionButton نشان می دهد که یک android.intent.action.ANNOTATE را با اسناد URI شلیک می کند.

API تغییر می کند

PdfViewerFragment.documentUri ویژگی اضافه شده برای تنظیم یک پرونده یا URI محتوا برای سند و شروع بارگیری سند. PdfViewerFragment هنگامی که URI تنظیم شده است که نشانگر پردازش پس زمینه سند است ، یک اسپینر بارگیری را نشان می دهد.
اضافه شده PdfViewerFragment.isTextSearchActive برای تغییر دیدگاه منوی Find in File. PdfViewerFragment کل جریان را کنترل می کند - اجازه ورودی ، نمایش تعداد کل مسابقات ، امکان ناوبری بین نتایج و خروج از آن را نشان می دهد.
اضافه شده onDocumentLoadSuccess و onDocumentLoadError Callbacks که پس از ارائه موفقیت آمیز سند یا پس از خطایی قبل از ارائه ، فراخوانی می شوند.

مسائل شناخته شده

در بعضی موارد در نوار پرونده با FloatingActionButton همپوشانی پیدا کنید.
نماد FloatingActionButton برای PDF های یک صفحه قابل مشاهده نیست.
تعداد نتیجه در تغییر پیکربندی در منوی Find in File حفظ نمی شود.
سوسو زدن هنگام بستن منوی Find در File مشاهده می شود
تصاویر سه بعدی در اسناد PDF در بیننده ارائه نمی شود.
ویژگی های دسترسی در نسخه های زیر فعال خواهد شد.
تصویر PDF در چرخش از پرتره به چشم انداز مبهم می شود.
بدون پشتیبانی از حاشیه نویسی متن/برجسته.
PdfViewerFragment برخی از مشکلات عملکرد در اسناد PDF بسیار بزرگ (> 250 مگابایت)

توجه داشته باشید

compileSdk به 35 5dc41be بروزرسانی کنید