pdf

  
ספרייה להוספת יכולות צפייה בקובצי PDF בתוך אפליקציות.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫25 במרץ 2026 - - - ‎1.0.0-alpha16

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

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

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

מגניב

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

Kotlin

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

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

משוב

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

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

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

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

גירסה 1.0

גרסה ‎1.0.0-alpha16

‫25 במרץ 2026

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

תכונות חדשות

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

שינויים ב-API

  • מתבצע עדכון של EditablePdfDocument לממשק (I94f75, ‏ b/483065130)

גרסה ‎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).
  • עדכון של פונקציית הקריאה החוזרת (callback) לעריכה של הווידג'ט של הטופס כדי להפעיל אותה לכל העדכונים של הטקסט לעריכה (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.

שינויים ב-API

  • הוספנו את Image Selection API (ממשק API לבחירת תמונות) לספריית Jetpack PDF (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] Add Two-Page Layout API to 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 Composable, שמאפשר למפתחים לבחור את יישור הדפים כשהגובה של התוכן קטן מגובה אזור התצוגה.

שינויים ב-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)
  • Expose Selection Menu API from 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)

External Contribution

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

גרסה ‎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 פיתוח נייטיב בספרייה.

גרסה ‎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 שמפעיל כוונה מרומזת android.intent.action.ANNOTATE עם ה-URI של המסמך.

שינויים ב-API

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

בעיות מוכרות

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

הערה

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