pdf

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

כדי להוסיף תלות ב-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")
}

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

משוב

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

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

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

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

גירסה 1.0

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

בעיות מוכרות

• תמונות תלת-ממדיות במסמכי 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, מוצגת ספינר טעינה שמציין את העיבוד ברקע של המסמך.
• הוספנו את המקש PdfViewerFragment.isTextSearchActive כדי להציג או להסתיר את תפריט החיפוש בקובץ. PdfViewerFragment מטפל בתהליך כולו – מאפשר להזין נתונים, מציג את המספר הכולל של ההתאמות, מאפשר לנווט בין התוצאות ויוצא ממנו.
• נוספו פונקציות קריאה חוזרת (callbacks) מסוג onDocumentLoadSuccess ו-onDocumentLoadError, שמופעלות אחרי עיבוד מוצלח של המסמך או אחרי שמוצגת שגיאה לפני העיבוד.

בעיות מוכרות

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

הערה

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