2022 年 11 月,面向 AR 的 Google Play 服务将移除与 NDK 相机图片和元数据相关的已弃用方法。
在受影响的 ARCore SDK 版本中使用这些方法的应用可能会在用户更新面向 AR 的 Google Play 服务后开始表现出不同的行为或发生崩溃。
受影响的应用
自 2022 年 11 月起,在以下情况下,当用户更新到最新版本的面向 AR 的 Google Play 服务时,您的应用可能会停止运行或崩溃:
- 您的应用是使用受影响的 SDK 编译的
- 您的应用使用了以下任何受影响的 API:
如果您的应用是使用 ARCore SDK 版本 编译的... |
并使用受影响的 API… | 自 2022 年 11 月起的破坏性行为 |
---|---|---|
1.19.0 或更低版本 | Frame.getImageMetadata() |
抛出 IllegalArgumentException 。 |
1.10.0 或更低版本 | Frame.acquireCameraImage() |
返回大小为 0x0 的图片。 |
修复受影响的应用
受影响的应用可能会在 2022 年 11 月出现故障。为缓解此问题,请使用最新的 ARCore SDK 重新构建应用。您至少必须升级到 ARCore SDK 1.20.0 或更高版本。
验证受影响的应用是否已修复
通过向应用的 AndroidManifest.xml
添加特殊的 meta-data
条目,提前模拟 2022 年 11 月的变更,以便测试应用:
- 确保目标设备上安装了 1.29.0 或更高版本的 Play 服务(适用于 AR)。
在应用的
AndroidManifest.xml
文件中,将新的<meta-data>
标记添加为现有<application>
元素的子元素:<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 年 11 月为这些变化做好准备。
时间轴
时段 | 事件 |
---|---|
2020 年 11 月 (ARCore SDK 1.20.0 版) |
废弃原生 API。 更新实现以使用替代原生 API。 |
2021 年 11 月 | 由于我们计划于 2022 年 11 月从面向 AR 的 Google Play 服务中移除受影响 API 的实现,因此提前通知未来的重大变更。 |
2022 年 11 月 |
从“面向 AR 的 Google Play 服务”中移除了受影响 API 的实现。 针对使用 1.20.0 之前的 ARCore 版本的应用引入了重大变更。 |