עינית המצלמה

  
רכיב עין המצלמה עצמאי שניתן לשילוב ולצפייה בתמונה"

בטבלה הזו מפורטים כל הארטיפקטים בקבוצה androidx.camera-viewfinder.

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
viewfinder-compose - - - 1.4.0-alpha12
viewfinder-core - - - 1.4.0-alpha12
viewfinder-view - - - 1.4.0-alpha12
הספרייה עודכנה לאחרונה ב-15 בינואר 2025

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

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

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

Groovy

dependencies {
    // Use to implement camera viewfinders
    
    implementation "androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10"
    implementation "androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10"
    implementation "androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10"

}

Kotlin

dependencies {
    // Use to implement camera viewfinders
    implementation("androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10")
    implementation("androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10")
    implementation("androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10")


}

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

משוב

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

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

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

גרסה 1.4

גרסה 1.4.0-alpha12

15 בינואר 2025

התכונות androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha12, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha12 וגם androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha12 משוחררות. גרסת 1.4.0-alpha12 מכילה את ההוספות האלה.

תכונות חדשות

  • השדרוג של compileSdk ל-35 נעשה לצורך שימוש ב-API שקשור ל-Android 15. אפליקציות שמשתמשות בספריות של CameraX יצטרכו גם לשדרג את הגדרת התצורה compileSdk. (Ic80cd)
  • הספרייה הזו משתמשת עכשיו בהערות של JSpecify לגבי ערכים null, שהן שימוש בסוגים. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של המהדר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, ‏ -Xtype-enhancement-improvements-strict-mode (I7bcd7, ‏ b/326456246)

גרסה 1.4.0-alpha11

11 בדצמבר 2024

התכונות androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11 וגם androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11 משוחררות. גרסת 1.4.0-alpha11 מכילה את ההוספות האלה.

שינויים ב-API

  • הכיתות של viewfinder-core הועברו לחבילות שתואמות לספרייה שהן שייכות אליה. (I431c6)
  • המכשיר CameraViewfinder.ScaleType הועבר ליחידה הארגונית viewfinder-core כדי שניתן יהיה לעשות בו שימוש חוזר באמצעות Compose (I87ef1)
  • כיתות CameraViewfinder שהוצאו משימוש יוסרו. יש להשתמש בממשקי ה-API החדשים שמספקים פונקציונליות זהה. (I6e59a)

גרסה 1.4.0-alpha10

30 באוקטובר 2024

התכונות androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10 וגם androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10 משוחררות. גרסת 1.4.0-alpha10 כוללת את ההוספות האלה.

גרסה 1.4.0-alpha09

2 באוקטובר 2024

התכונות androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09 וגם androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09 משוחררות. גרסת 1.4.0-alpha09 מכילה את ההוספות האלה.

גרסה 1.4.0-alpha08

4 בספטמבר 2024

התכונות androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08 וגם androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08 משוחררות. גרסת 1.4.0-alpha08 כוללת את ההוספות האלה.

תכונות חדשות

בעדכון לגרסה 1.4.0-alpha08, פריט המידע שנוצר בתהליך הפיתוח (artifact) של חלון הצפייה של CameraX הועבר לקבוצת ספרייה משלו. השינוי הזה נדרש כדי לשפר את המודולריות ואת יכולת התחזוקה של ספריית CameraX.

אם בעבר השתמשתם ב-androidx.camera:camera-viewfinder, ב-androidx.camera:camera-viewfinder-compose או ב-androidx.camera:camera-viewfinder-core, תצטרכו להעביר את יחסי התלות שלכם לאפשרויות הבאות:

  • androidx.camera:camera-viewfinder -> ‏androidx.camera.viewfinder:viewfinder-view
  • androidx.camera:camera-viewfinder-compose -> ‏androidx.camera.viewfinder:viewfinder-compose
  • androidx.camera:camera-viewfinder-core -> ‏androidx.camera.viewfinder:viewfinder-core

לא אמורים להיות צורך בשינויים בקוד כדי לבצע את המעבר הזה. לא יתקבלו יותר עדכונים לקואורדינטות הישנות של Maven ב-Viewfinder.

בנוסף, אם אתם משתמשים ב-Compose עם CameraX, ספרייה חדשה של Compose-first זמינה עכשיו בגרסת אלפא: androidx.camera:camera-compose. כך מקבלים את ה-composable‏ CameraXViewfinder, שהוא רכיב Viewfinder שמותאם ל-Compose ומשתמש ב-SurfaceRequest של CameraX ב-Compose, בדומה לאופן שבו PreviewView פועל בתצוגות.