בנובמבר 2022 הסרת שיטות המצלמה מ-ARCore SDK ל-Android (Kotlin/Java)

בנובמבר 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.