pdf

  
ספרייה להוספת יכולות צפייה בקובצי PDF בתוך אפליקציות.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫1 ביולי 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")
}

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

משוב

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

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

אין הערות לגבי הגרסה של הארטיפקט הזה.

גרסת PDF 1.0

גרסה ‎1.0.0-alpha19

‫1 ביולי 2026

‫androidx.pdf:pdf-*:1.0.0-alpha19 מופץ. גרסה ‎1.0.0-alpha19 מכילה את השמירות האלה.

שינויים ב-API

  • הגדרת AnnotationView כציבורי (I8219f)
  • להגדיר את הכיתות EditablePdfDocument וההערות כציבוריות. (I5b962)
  • הוספנו מודול משנה חדש של pdf-core ‏ (Iea331)
  • העברנו ממשקי PDF API מרכזיים לארטיפקט pdf-core חדש כדי להפריד בין מודלים של מסמכים לבין הטמעה של תצוגה. (I26e1f)
  • הצגת ממשקי API של OcrProvider לתמיכה בזיהוי טקסט מבוסס-תמונה (I5271b)
  • הוסר מ-PdfViewerFragment ה-method‏ onLoadDocumentSuccess() ללא פרמטרים שהוצא משימוש, ומ-PdfDocument הוסר הנכס isLinearized שהוצא משימוש. (I6b7ab)
  • התמיכה במילוי אוטומטי של טפסים מופעלת.

תיקוני באגים

  • תוקנה הבעיה שבה הגלילה האופקית לא הייתה אמינה בקצוות הדף, כי כיוון הגלילה לא נלקח בחשבון כשמנהלים את ההפרעה לאירוע המגע. (I6bda5, b/505645009)
  • תוקנה בעיה שגרמה לכך שהאפשרות 'גלילה מהירה' לא הוצגה תמיד כשמופעלת נגישות. (Idaf5e, ‏ b/513082550)

גרסה ‎1.0.0-alpha18

‫22 באפריל 2026

‫androidx.pdf:pdf-*:1.0.0-alpha18 מופץ. גרסה ‎1.0.0-alpha18 מכילה את השמירות האלה.

שינויים ב-API

  • תכונות הקריאה והעיבוד של ספריית ה-PDF הועברו לאחור כדי לתמוך במכשירי Android עד גרסה minSdk = 28, וגרסה sdk-extension < 13 מרחיבה את התאימות ל-2 מיליארד מכשירי Android פעילים נוספים (I808f8)
  • הוספנו API מבוסס SelectionBoundary‏ getSelectionBounds אל PdfDocument. (Ida6ea)

תיקוני באגים

  • בטיפול פנימי ב-RemoteException (I2c59e)PageBitmapSource.close()

גרסה ‎1.0.0-alpha17

‫8 באפריל 2026

‫androidx.pdf:pdf-*:1.0.0-alpha17 מופץ. גרסה ‎1.0.0-alpha17 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת API של contentPadding ל-PdfViewer composable. (Idcfd4, ‏ b/481774503)

תיקוני באגים

  • עדכון של Compose compileSdk ל-API 37. כלומר, כשמשתמשים ב-Compose, נדרשת גרסת AGP מינימלית של 9.2.0. (Id45cd, b/413674743)

גרסה ‎1.0.0-alpha16

‫25 במרץ 2026

‫androidx.pdf:pdf-*:1.0.0-alpha16 מופץ. גרסה ‎1.0.0-alpha16 מכילה את השמירות האלה.

תכונות חדשות

  • ‫EditablePdfViewerFragment תומך עכשיו בעיבוד ובמחיקה של הערות להדגשת קטעים שנוספו מאפליקציות אחרות. (Ic46e4)

שינויים ב-API

גרסה ‎1.0.0-alpha15

‫11 במרץ 2026

‫androidx.pdf:pdf-*:1.0.0-alpha15 מופץ. גרסה ‎1.0.0-alpha15 מכילה את השמירות האלה.

שינויים ב-API

  • נוספה גרסה 19 של Android SDK Extension כדרישה לתכונה ImageSelection (I93af7)
  • התגובה isLinearized Boolean סומנה כהוצאה משימוש והוחלפה בתגובה linearizationStatus IntDef(I5c1bf)

תיקוני באגים

  • תיקון עיבוד של סרגל גלילה מהיר ללא טקסט בהקשה בודדת על רכיב PdfViewer הכתיבה (I442b7)
  • לחיצה על מרכז הווידג'ט clickTypeWidgets.(Ie5661)
  • הספריות מועברות לשימוש ביעד Java 11. המשמעות היא שקוד הבייט שנוצר יהיה 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 כדי להתאים את המסמך לרוחב.
    • גלילה: מקשי החיצים הרגילים (D-pad) מאפשרים גלילה למעלה, למטה, שמאלה וימינה, כולל מעבר לדף הבא או הקודם כשמגיעים לגבולות.
    • בחירה: משתמשים ב-Ctrl + C כדי להעתיק במהירות את התוכן שנבחר כרגע.
    • תמיכה משופרת בעכבר:
    • גלגל גלילה: תמיכה בגלילה אנכית ואופקית. כדי לשנות את מרחק התצוגה במסמך ביחס למיקום סמן העכבר, משתמשים ב-Ctrl + גלגל הגלילה.
    • בחירה: לוחצים וגוררים עם הכפתור הראשי בעכבר כדי לבחור טקסט.
    • שיפורים בווידג'טים ובטפסים:
    • נוספה אפשרות של בחירה מותאמת אישית לתיבות משולבות.
    • הקריאה החוזרת (callback) לעריכת הווידג'ט של הטופס מופעלת עכשיו לכל העדכונים של הטקסט לעריכה

שינויים ב-API

  • חשיפת PdfDocument מ-PdfViewerFragment דרך onDocumentLoadSuccess(pdfDocument). (I4b47d, b/481616017)

תיקוני באגים

  • כדי למנוע את RuntimeException כששומרים את מצב המופע (I07bab), צריך להימנע מ-parceling Bitmap ב-ImageSelection.
  • השבתת תכונות ההערות בזמן שחיפוש ה-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 API ב-PdfView.
    • ‫EditablePdfDocument: ממשק חדש שמרחיב את PdfDocument לניהול וליישום של עריכות בנתוני טפסים.
    • רכיב ה-Composable‏ PdfViewer תומך באינטראקציה עם שדות טופס, שאפשר לשלוט בהם באמצעות הפרמטר isFormFillingEnabled.
  • שמירת שינויים: PdfWriteHandle מאפשרת לשמור תוכן ערוך בקובץ ספציפי.
  • בחירת תמונות: נוספה תמיכה בבחירת תמונות בלחיצה ארוכה במסמכי PDF. התכונה הזו מופעלת באמצעות הנכס isImageSelectionEnabled ב-PdfView וב-PdfViewer composable. הנתונים שמתקבלים מוצגים באמצעות המודל ImageSelection ב-OnSelectionChangedListener.
  • פריסת שתי עמודות: נוסף מצב פריסה זה לצד זה למכשירים עם מסך גדול, שאפשר להגדיר באמצעות המאפיין pagesPerRow ב-PdfView וב-PdfViewer composable.

שינויים ב-API

  • הוספנו את Image Selection API (ממשק API לבחירת תמונות) לספריית ה-PDF של Jetpack ‏(Iee0b9, ‏ b/470897750)
  • פרסום ממשקי API של שכבת עיבוד למילוי טפסים. (Iec39c, ‏ b/474260451)
  • הוספת פרמטר renderParams ל-API של openDocument ב-SandboxedPdfLoader (If9344, ‏ b/438269273)
  • הוספת ממשקי API של שכבת ההצגה למילוי טפסים (I829c5, ‏ b/449869703)
  • נוספה הערה @MainThread לשיטות הקריאה החוזרת של OnFirstContentLoadListener ושל OnSelectionChangedListener (I4cf10, ‏ b/466965940)
  • הקונסטרוקטור ApplyInProgressException סומן כפנימי, כדי למנוע יצירת מופע חיצוני (I5cc66, ‏ b/465414484)
  • הוספנו את ההערה @MainThread לשיטות הקראה החוזרת של מאזינים ב-PdfView (Ie7201, ‏ b/429407597)
  • הוספנו ממשקי API ליכולות עריכה מקוריות דרך EditablePdfViewerFragment. (Ifae6c, b/462049364)
  • הוספת FirstContentLoad API אל PdfView ו-PdfViewer (Icf63d, ‏ b/461666545)
  • ‫[2Page] הוספת 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 מכילה את השמירות האלה.

שינויים ב-API

  • הסרת הפונקציה textAsString מ-TextSelection אל androidx-main
  • שינוי השם של clearSelection לclearCurrentSelection (I3a318, b/429407597)
  • הסרה של הפונקציה textAsString מ-TextSelection (I1305d, ‏ b/429407798)

תיקוני באגים

  • תוקנה בעיה שגרמה לכך שסרגל הגלילה המהירה ב-PdfView לא היה גלוי כברירת מחדל. (I7fb0e)
  • תוקנה קריסה ב-TextSelectionMenuProvider בבחירה עם טקסט null. (I855df)

גרסה ‎1.0.0-alpha11

‫22 באוקטובר 2025

‫androidx.pdf:pdf-*:1.0.0-alpha11 מופץ. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

תכונות חדשות

  • הפעלת פריטי תפריט חכמים בבחירת תוכן PDF.
  • הפעלת האפשרות לבחור היפר-קישור והפעלת האפשרות לבחור קישור 'מעבר אל' ב-PDF.
  • הוספנו את ממשקי ה-API של תפריט הבחירה fromPdfView ו-PdfViewer Composable, שמאפשרים למפתחים להוסיף פריטים לתפריט הבחירה.
  • הוספנו API ליישור דפים לרכיבים הניתנים להרכבה PdfView ו-PdfViewer, שמאפשר למפתחים לבחור את יישור הדפים כשהגובה של התוכן קטן מגובה אזור התצוגה.

שינויים ב-API

  • הגדרנו את contentDesc כ-nullable והסרנו את ערך ברירת המחדל. (I86f8c, ‏ b/441973880)
  • הצגת PdfSelectionMenuKeys עבור פריטים בתפריט לבחירת קישור (Ic9b05, ‏ b/447079082)
  • הוספת PageAlignment API אל PdfView ו-PdfViewer אל androidx-main
  • שינוי API שקשור לזווית לשימוש במעלות וכולל יחידה בשמות, הבהרה לגבי יחידות בכלי המרה של זווית ותמיכה במעלות וברדיאנים, שינוי StockBrushes API לקבלת גרסת מברשת המלאי כפרמטר של פונקציית יצירה וחשיפת בקרת התנהגות של חפיפה עצמית למברשות של הדגשה, שינוי השם של MutableAffineTransform.populateFromTranslate ל-populateFromTranslation, הסרת InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, ‏ b/436656418)
  • הוספת PageAlignment API אל PdfView ו-PdfViewer (I9c9a5, b/438065228)
  • הצגת API של תפריט בחירה מ-PdfViewer Composable ‏ (Id9b0f, ‏ b/407663999)
  • להפוך את PdfView לViewGroup. אין תמיכה בילדים שרירותיים. (Ib51d8, b/410008792)
  • הצגת HyperLinkSelection ו-GoToLinkSelection מ-PdfView (I378c4, ‏ b/441280002)
  • שינוי מבנה הקוד PdfPageContent כדי לתמוך בבחירות גנריות (I28f16, b/437845185)
  • הצגת Selection Menu API מ-PdfView (Idd547, ‏ b/407663737)
  • העברת כיתות שקשורות לבחירה לחבילה ייעודית (I953cb, b/436157691)
  • השקנו את התכונה הניסיונית onPdfViewCreated לגישה ל-PdfView ב-PdfViewerFragment. (I86715, ‏ b/422620454)
  • ‫FileDescriptor API נוסף ל-PdfLoader (I60b8d)

תיקוני באגים

  • שיפור המודלים של הקלט כדי שהמשיכות ישקפו את הקלט בצורה מדויקת יותר (I93097)

חישוב צריכת הנתונים

  • הצגת PdfSelectionMenuKeys באפשרויות התפריט לבחירת קישורים
  • חשיפת Selection Menu API מ-PdfViewer Composable
  • הצגת Selection Menu API מ-PdfView

גרסה ‎1.0.0-alpha10

‫16 ביולי 2025

‫androidx.pdf:pdf-*:1.0.0-alpha10 מופץ. גרסה ‎1.0.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

  • שיפור הבחירה שמאפשר למשתמשים לבחור טקסט בכמה דפים על ידי גרירת נקודות האחיזה לבחירה מעבר לגבולות הדף.
  • אפליקציות יכולות עכשיו ליירט את הטיפול בלחיצות על היפר-קישורים במסמכי PDF ולהתאים אותו אישית.

שינויים ב-API

  • הוספנו קומפוזיציה להצגת תוכן PDF ‏ (I8e7ee)
  • העברה של PdfPoint ו-PdfRect לחבילה androidx.pdf.models (I26cf4)
  • הוספת רכיב View להצגת תוכן PDF‏ (I9fe27)
  • הוספת API לאתחול מראש של משאבי PDF כדי להקטין את זמן האחזור של התנעה קרה (a18fa89)
  • ‫API שמאפשר לבטל את הטיפול בלחיצה על היפר-קישור בתוכן PDF(6330a8b)
  • נוצר ארטיפקט חדש בשם pdf-document-service וממשקי ה-API התואמים – PdfLoader, ‏ PdfDocument ו-SandboxedPdfLoader. אפשר להשתמש בממשקי ה-API כדי להטמיע את רכיב הניתוח והעיבוד של מסמך ה-PDF‏ (Ide70d)
  • חשיפת API להגדרת PdfDocument ב-PdfView כדי להפעיל את העיבוד של המסמך (If8738)

גרסה ‎1.0.0-alpha09

‫7 במאי 2025

‫androidx.pdf:pdf-*:1.0.0-alpha09 מופץ. גרסה ‎1.0.0-alpha09 מכילה את השמירות האלה.

שינויים משמעותיים

  • בסיס הקוד עבר שינוי משמעותי ועכשיו הוא כתוב כולו ב-Kotlin, תוך שימוש ב-Coroutines וב-ViewModel. השינוי כולל הטמעה מחדש של PdfViewerFragment. הגרסה הזו לא כוללת ממשקי API או תכונות חדשים.

בעיות מוכרות:

  • בסרגל הגלילה המהיר ובאינדיקטור הדף חסרים אפקטים של צל.
  • יכול להיות שמסמכי PDF עם דף אחד לא תמיד יוצגו במרכז ולא תמיד יותאמו לרוחב התצוגה.

שינויים ב-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 מכילה את השמירות האלה.

תכונות חדשות

  • התג PdfViewerFragment תומך עכשיו ב-StylingOptions (קבוצה של מזהי משאבי סגנון), שמאפשרת התאמה אישית של הסגנון באמצעות newInstance או XML‏ (FragmentContainerView). מחלקות משנה יכולות להשתמש בבונה המוגן כדי להשיג פונקציונליות דומה.
  • ‫StylingOptions מקבל כרגע את containerStyle, שמספק:
    • תמיכה בפריטים שניתן לצייר בהתאמה אישית עבור נקודת האחיזה של הרכיב לגלילה מהירה ומחוון הדף.
    • marginEnd כדי למקם במדויק את נקודת האחיזה של הרכיב לגלילה מהירה ואת אינדיקטור הדף.

שינויים ב-API

  • נוספו מאפיינים ציבוריים מ-PdfView (I30fc5)
  • הוספנו ממשקי API חדשים 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 לגבי ערכי null, שהן אנוטציות של שימוש בטיפוסים. מפתחי 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 extension 13.

שינויים ב-API

  • נוספה מגבלת מינימום של SdkExtension ל-PdfViewerFragment. (I922af)
  • הוספנו ממשקי API חדשים לספריית PDF Viewer. (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 גדולים מאוד (מעל 250MB)

גרסה ‎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