pdf

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

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

כדי להוסיף תלות ב-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. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

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

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

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

גירסה 1.0

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

בעיות מוכרות

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

הערה

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