בנובמבר 2022, יוסרו ב-Google Play Services for AR שיטות שהוצאו משימוש וקשורות לתמונות ולמטא-נתונים של מצלמת NDK.
אפליקציות שנעשה בהן שימוש בשיטות האלה בגרסאות שהושפעו של ARCore SDK עשויות להתחיל לפעול באופן שונה או לקרוס כשמשתמשים מעדכנים את Google Play Services ל-AR.
אפליקציות שהושפעו
החל מנובמבר 2022, האפליקציה עשויה להפסיק לפעול או לקרוס אם משתמשים יתעדכנו לגרסה האחרונה של Google Play Services למציאות רבודה אם:
- האפליקציה נערכה עם ערכת SDK שהושפעה
- באפליקציה נעשה שימוש בכל אחד מממשקי ה-API הבאים שהושפעו:
אם האפליקציה שלך הודרכה באמצעות גרסת ARCore SDK... |
ומשתמשת בממשקי API שהושפעו... | הפרות חמורות של המדיניות החל מנובמבר 2022 |
---|---|---|
1.22.0 ומטה | ArImage_getNdkImage() (הוסר ב-ARCore SDK 1.23.0) |
מחזירה את NULL במבנה AImage שמתקבל. |
1.22.0 ומטה | ArImage_getNdkCameraMetadata() (הוסר ב-ARCore SDK 1.23.0) |
מחזירה את NULL במבנה ACameraMetadata שמתקבל. |
תיקון האפליקציות שהושפעו
ייתכן שבנובמבר 2022 תקלה באפליקציות המושפעות. כדי למזער את התופעה, כדאי להשתמש בתחליפי מכשיר חלופי:
ArImage_getNdkImage()
ו-AImage_*
: שימוש בשיטות תואמות מ-ArImage
. לדוגמה:ArImage_getNdkCameraMetadata()
: שימוש ב-ArImageMetadata_getConstEntry()
במקום זאת
אימות שהאפליקציה שהושפעה תוקנה
כדי לבדוק את האפליקציה, צריך לדמות את השינויים בנובמבר 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 (ARCore SDK גרסה 1.23.0) |
יש להסיר מ-ARCore SDK חתימות של ממשקי API שהוצאו משימוש. |
נובמבר 2021 | יש להודיע על שינוי תוכנה עתידי שעלול לגרום להסרה של הטמעת ממשקי ה-API המושפעים מ-Google Play Services עבור AR בנובמבר 2022. |
נובמבר 2022 |
מסירים את ההטמעה של ממשקי ה-API המושפעים
מ-Google Play Services למציאות רבודה. שינוי תוכנה שעלול לגרום לכשל באפליקציות שמשתמשות בגרסאות ARCore שקודמות ל-1.23.0. |