בנובמבר 2022, יוסרו ב-Google Play Services for AR שיטות שהוצאו משימוש וקשורות לתמונות ולמטא-נתונים של מצלמת NDK.
אפליקציות שנעשה בהן שימוש בשיטות האלה בגרסאות שהושפעו של ARCore SDK עשויות להתחיל לפעול באופן שונה או לקרוס כשמשתמשים מעדכנים את Google Play Services ל-AR.
אפליקציות שהושפעו
החל מנובמבר 2022, האפליקציה עשויה להפסיק לפעול או לקרוס אם משתמשים יתעדכנו לגרסה האחרונה של Google Play Services למציאות רבודה אם:
- האפליקציה נערכה עם ערכת SDK שהושפעה
- באפליקציה נעשה שימוש בכל אחד מממשקי ה-API הבאים שהושפעו:
אם האפליקציה שלך הודרכה באמצעות גרסת ARCore SDK... |
ומשתמשת בממשקי API שהושפעו... | הפרות חמורות של המדיניות החל מנובמבר 2022 |
---|---|---|
1.19.0 ומטה | Frame.getImageMetadata() |
זריקת פתיחה של IllegalArgumentException . |
1.10.0 ומטה | Frame.acquireCameraImage() |
מחזירה תמונה בגודל 0x0. |
תיקון האפליקציות שהושפעו
ייתכן שבנובמבר 2022 תקלה באפליקציות המושפעות. כדי לפתור את הבעיה, כדאי לפתח מחדש את האפליקציה באמצעות ה-ARCore SDK העדכני. חייבים לשדרג ל-ARCore SDK לפחות גרסה 1.20.0 ואילך.
אימות שהאפליקציה שהושפעה תוקנה
כדי לבדוק את האפליקציה, צריך לדמות את השינויים בנובמבר 2022 מראש על ידי הוספה של רשומת meta-data
מיוחדת ל-AndroidManifest.xml
של האפליקציה:
- מוודאים ש-Play Services ל-AR מגרסה 1.29.0 ואילך מותקנים במכשיר היעד.
הוספת תג
<meta-data>
חדש כצאצא של רכיב<application>
הקיים בקובץAndroidManifest.xml
של האפליקציה :<application …> … <!-- Simulate the November 2022 changes in advance. IMPORTANT: Remove this tag when testing is completed. Do not include this tag in published versions of your app. --> <meta-data android:name="com.google.ar.core.session_settings" android:value="camera_stack_option,unified_mono" /> </application>
בודקים את האפליקציה ומוודאים שכל התכונות של ARCore פועלות כצפוי.
בסיום הבדיקה, צריך להסיר את התג
<meta-data>
. השארת התג הזה באפליקציה שפורסמה עלולה לגרום להתנהגות לא צפויה בעתיד.
אם האפליקציה פועלת כרגיל, האפליקציה מוכנה לשינויים בנובמבר 2022.
ציר הזמן
נקודה | אירועים |
---|---|
נובמבר 2020 (ARCore SDK גרסה 1.20.0) |
הוצא משימוש ממשקי API מקוריים. עדכון ההטמעה לשימוש בממשקי API מקוריים חלופיים. |
נובמבר 2021 | יש להודיע על שינוי תוכנה עתידי שעלול לגרום להסרה של הטמעת ממשקי ה-API המושפעים מ-Google Play Services עבור AR בנובמבר 2022. |
נובמבר 2022 |
מסירים את ההטמעה של ממשקי ה-API המושפעים
מ-Google Play Services למציאות רבודה. שינוי תוכנה שעלול לגרום לכשל באפליקציות שמשתמשות בגרסאות ARCore שקודמות ל-1.20.0. |