pdf

  
ספרייה להוספת יכולות צפייה בקובצי PDF בתוך אפליקציות.
העדכון האחרון גרסה יציבה מועמד לפרסום גרסת בטא גרסת אלפא
4 בספטמבר 2024 - - - 1.0.0-alpha02

הצהרה על יחסי תלות

כדי להוסיף תלות בקובץ PDF, צריך להוסיף את מאגר Google Maven פרויקט. למאגר Maven של Google אפשר לקבל מידע נוסף.

מוסיפים את יחסי התלות של פריטי המידע הנדרשים בקובץ build.gradle בשביל האפליקציה או המודול שלך:

מגניב

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

Kotlin

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

למידע נוסף על יחסי תלות, אפשר לעיין במאמר הוספת יחסי תלות של build.

משוב

המשוב שלך עוזר לנו לשפר את Jetpack. נשמח לשמוע אם גילית בעיות חדשות או אם יש לך רעיונות לשיפור הספרייה הזו. מומלץ לעיין בעיות קיימות בספרייה הזו לפני שיוצרים ספר חדש. אפשר להוסיף את ההצבעה שלך לבעיה קיימת על ידי לחיצה על לחצן הכוכב.

דיווח על בעיה חדשה

מקורות מידע בנושא מעקב אחר בעיות אפשר לקבל מידע נוסף.

אין נתוני גרסה של פריט המידע הזה שנוצר בתהליך הפיתוח (Artifact).

גירסה 1.0

גרסה 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.
  • עכשיו ניתן לעבד הערות טקסט והדגשה במציג.
  • ביצענו שיפורי נגישות בסרגל הקבצים 'חיפוש בקובץ'.
  • יושמו תיקונים בממשק המשתמש לרוטציה, כולל שימור ספירת החיפושים, טיפול בתפריט בחירת הטקסט שנעלם ופתרון הבעיה החופפת של FAB.
  • תוקן התפריט 'קובץ' שמוסתר מאחורי המקלדת בפריסה לרוחב.

בעיות מוכרות

  • תמונות תלת-ממדיות במסמכי PDF לא מעובדות במציג.
  • ב-PdfViewerFragment יש בעיות בביצועים של מסמכי PDF גדולים מאוד (יותר מ-250MB)

גרסה 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 מוצגת תיבת דו-שיח שבה המשתמש יכול להזין את הסיסמה ולפתוח את המסמך.
    • היפר-קישורים שניתנים לניווט: המשתמשים יכולים לנווט לכתובות URL או לסימניות על ידי הקשה על היפר-קישורים בקובץ ה-PDF.
    • קיצור דרך למצב הערות: עדיין אין תמיכה במצב עריכה ב-PdfViewerFragment. במקום זאת, PdfViewerFragment מציג FloatingActionButton שמפעיל Intent מרומז של android.intent.action.ANNOTATE עם ה-URI של המסמך.

שינויים ב-API

  • נוסף המאפיין PdfViewerFragment.documentUri כדי להגדיר URI של קובץ או תוכן עבור המסמך ולהתחיל את טעינת המסמך. PdfViewerFragment מציג סימן גרפי שמוצג בזמן טעינה כאשר מוגדר ה-URI, שמציין את עיבוד המסמך ברקע.
  • בוצעה הוספה של PdfViewerFragment.isTextSearchActive כדי להציג או להסתיר את החיפוש בתפריט הקבצים. PdfViewerFragment מטפל בכל התהליך – מאפשר קלט, מציג את המספר הכולל של ההתאמות, מאפשר ניווט בין התוצאות ויציאה ממנו.
  • נוספו קריאות חוזרות (callback) של onDocumentLoadSuccess ו-onDocumentLoadError שמופעלות אחרי שהמסמך רינדור בהצלחה או אחרי שהופקה שגיאה לפני הרינדור.

בעיות מוכרות

  • במקרים מסוימים, החיפוש בסרגל הקבצים חופף ל-FloatingActionButton.
  • הסמל של FloatingActionButton לא מוצג בקובצי PDF שמכילים רק דף אחד.
  • ספירת התוצאות לא נשמרת כשמשנים את ההגדרות האישיות בתפריט 'חיפוש בקובץ'.
  • הבהוב נראה כשסוגרים את החיפוש בתפריט הקבצים
  • תמונות תלת-ממדיות במסמכי PDF לא מעובדות במציג.
  • תכונות הנגישות יופעלו בגרסאות הבאות.
  • התמונה בפורמט PDF מטושטשת כשמסובבים את המכשיר מפריסה לאורך לפריסה לרוחב.
  • אין תמיכה בהערות טקסט/הדגשה.
  • ב-PdfViewerFragment יש בעיות בביצועים של מסמכי PDF גדולים מאוד (יותר מ-250MB)

הערה

  • עדכון compileSdk ל-35 5dc41be