ARCore 64비트 요구사항
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
2020년 8월, Google Play AR 서비스 (ARCore)에서는 일부 64비트 기기에서 32비트 전용 앱 지원이 삭제되었습니다. 나머지 64비트 기기에서 32비트 전용 ARCore 지원 앱 지원은 향후 ARCore 출시에서 예고 없이 삭제될 수 있습니다. 32비트 기기에서 실행되는 32비트 전용 ARCore 지원 앱은 영향을 받지 않으며 계속 지원됩니다.
32비트 전용 버전 (예: armeabi-v7a) 버전의 SDK를 사용하는 경우 64비트 기기용 64비트 (arm64-v8a) 버전을 게시하지 않는 경우 앱을 64비트 기기와 호환되는 64비트 버전으로 업데이트해야 합니다.
업데이트되지 않은 32비트 전용 ARCore 지원 앱은 ARCore 세션을 생성하지 못하며, 영향을 받는 64비트 기기에서 증강 현실(AR) 세션을 시작하려고 할 때 비정상 종료될 수 있습니다.
앱의 AndroidManifest.xml에서 android:use32bitAbi="true" 속성을 설정하면 앱에서 32비트 라이브러리만 사용합니다. 앱의 모든 AR 환경은 32비트 모드에서 ARCore를 사용하려고 합니다. 그러나 32비트 라이브러리는 일부 64비트 기기의 Google Play AR 서비스 서비스에 없습니다. 이러한 라이브러리가 없으면 앱이 ARCore 세션을 만들지 못하고 영향을 받는 64비트 기기에서 증강 현실 (AR) 세션을 시작하려고 할 때 비정상 종료될 수 있습니다. 이는 WebView 구성요소 내 네이티브 AR 환경과 WebXR 기반 AR 환경 모두에 영향을 미칩니다.
Google Play 스토어 64비트 요구사항
이전 섹션에서 설명한 ARCore 64비트 요구사항은 Android 버전 및 API 수준과 관계없이 모든 64비트 기기에 적용됩니다. 이 요구사항은 별개이며 2019년 8월 1일에 적용된 Google Play 64비트 요구사항과는 관련이 없습니다. 이 요구사항은 앱 출시 수준에서 평가되며 Android 9 Pie (API 수준 28) 이상을 실행하는 기기에 배포되는 APK 또는 App Bundle에만 적용됩니다.
ARCore ABI 지원 이해
ARCore를 사용하면 다음 Android ABI를 지원하는 앱을 빌드할 수 있습니다.
ARCore 지원 앱을 빌드하면 Android 빌드 시스템에는 앱에서 타겟팅하는 Android ABI용 ARCore 네이티브 라이브러리 (lib/…/libarcore_sdk*.so)가 하나 이상 포함됩니다.
이전에는 32비트 전용 ARCore 지원 앱이 32비트 및 64비트 기기 모두에서 실행될 수 있었습니다. 2020년 8월 Google Play AR 서비스 (ARCore)는 일부 64비트 기기에서 32비트 네이티브 라이브러리 포함을 중단했으며 그 당시 32비트 전용 ARCore 지원 앱은 더 이상 영향을 받는 64비트 기기에서 실행할 수 없었습니다. 향후 버전에서는 32비트 전용 ARCore 지원 앱 지원이 나머지 64비트 기기에서 예고 없이 삭제될 수 있습니다.
특히 다음과 같이 업데이트되지 않은 32비트 전용 ARCore 지원 앱은 세션 생성에 실패하고 영향을 받는 64비트 기기에서 증강 현실 (AR) 세션을 시작하려고 할 때 비정상 종료될 수 있습니다.
앱 업데이트 필요 여부 결정
게시된 앱에 64비트 기기를 지원하는 데 필요한 네이티브 ARCore 라이브러리가 포함되어 있는지 확인하려면 다음 단계를 따르세요.
Google Play Console을 엽니다.
ARCore 지원 앱을 선택합니다.
앱의 활성 버전을 확장하여 네이티브 플랫폼에 64비트 (arm64-v8a) 지원이 포함되어 있는지 확인합니다.
64비트 기기를 지원하도록 앱 업데이트
64비트 네이티브 라이브러리를 포함하도록 기존의 32비트 전용 ARCore 지원 앱을 업데이트하는 방법은 다음과 같습니다.
최신 ARCore SDK를 사용하도록 프로젝트를 업데이트합니다.
앱을 빌드하고 Google Play Console을 사용하여 게시합니다.
Google Play는 앱이 이전에 2019년 8월 1일에 적용된 Google Play 스토어 64비트 요구사항을 충족하는지 확인합니다. ARCore 지원 앱이 Android 버전이나 API 수준과 관계없이 모든 64비트 기기를 위한 64비트 (arm64-v8a) 지원을 포함하도록 하려면
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eGoogle Play Services for AR (ARCore) has dropped support for 32-bit-only apps on certain 64-bit Android devices, requiring app updates for continued AR functionality.\u003c/p\u003e\n"],["\u003cp\u003eARCore-enabled apps published without a corresponding 64-bit version (arm64-v8a) must be updated to include 64-bit libraries for compatibility.\u003c/p\u003e\n"],["\u003cp\u003e32-bit-only ARCore apps on affected 64-bit devices will fail to initiate AR sessions and may crash, necessitating an update to incorporate 64-bit support.\u003c/p\u003e\n"],["\u003cp\u003eThis ARCore 64-bit requirement is independent of the Google Play Store's broader 64-bit mandate and affects all 64-bit devices regardless of Android version.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can check their app's native platform support in the Google Play Console and update their projects using the latest ARCore SDK to ensure 64-bit compatibility.\u003c/p\u003e\n"]]],[],null,["# ARCore 64-bit requirement\n\nIn August 2020, *Google Play Services for AR* (ARCore) removed support for\n32-bit-only apps on some 64-bit devices. Support for 32-bit-only ARCore enabled\napps on the remaining 64-bit devices may be removed without notice in an\nupcoming ARCore release. 32-bit-only ARCore enabled apps running on 32-bit\ndevices are unaffected and continue to be supported.\n\nIf you published a 32-bit-only (e.g., `armeabi-v7a`) version of your\nARCore-enabled app without publishing a corresponding 64-bit (`arm64-v8a`)\nversion for 64-bit devices, you must update your app with a compatible 64-bit\nversion for 64-bit devices.\n\n**32-bit-only ARCore-enabled apps that aren't updated will fail to create an\nARCore session and might crash when attempting to start an augmented reality\n(AR) session on affected 64-bit devices**.\n\nIf you set the `android:use32bitAbi=\"true\"` attribute in your\napp's `AndroidManifest.xml`, your app will only use 32-bit libraries. Any AR\nexperiences in your app will attempt to use ARCore in 32-bit mode. However, the\n32-bit libraries will not be present in the *Google Play Services for AR*\nservice on some 64-bit devices. Without these libraries, your app will fail to\ncreate an ARCore session and might crash when attempting to start an augmented\nreality (AR) session on those affected 64-bit devices. This affects both native\nAR experiences and WebXR-based AR experiences inside a WebView component.\n\nGoogle Play Store 64-bit requirement\n------------------------------------\n\nThe ARCore 64-bit requirement described in the preceding section applies to all\n64-bit devices, regardless of Android version and API level. This requirement is\nseparate and not related to the Google Play\n[64-bit requirement](https://android-developers.googleblog.com/2019/01/get-your-apps-ready-for-64-bit.html)\nthat went into effect on August 1, 2019, which is\n[evaluated at the app release level](https://developer.android.com/games/optimize/64-bit#multi-apk-compliance)\nand applies only to APKs or app bundles that are distributed to devices running\nAndroid 9 Pie (API level 28) or later.\n\nUnderstanding ARCore ABI support\n--------------------------------\n\nARCore lets you build apps that support the following\n[Android ABIs](https://developer.android.com/ndk/guides/abis):\n\n- 32-bit (e.g., `armeabi-v7a`) and 64-bit (`arm64-v8a`) apps that target\n physical\n [ARCore supported devices](https://developers.google.com/ar/devices)\n\n- 32-bit (`x86`) and 64-bit (`x86_64`) apps that run inside an\n [Android Emulator](/ar/develop/java/emulator)\n\nWhen you build an ARCore-enabled app, the Android build system includes one or\nmore ARCore native libraries (`lib/.../libarcore_sdk*.so`) for the Android ABIs\ntargeted by your app.\n\n32-bit-only ARCore-enabled apps were previously able to run on both 32-bit\nand 64-bit devices. In August 2020 *Google Play Services for AR* (ARCore)\nstopped including 32-bit native libraries on some 64-bit devices, at which time\n32-bit only ARCore-enabled apps were no longer able to run on affected 64-bit\ndevices. In a future release, support for 32-bit-only ARCore-enabled apps may\nalso be removed without notice from the remaining 64-bit devices.\n\n**32-bit-only ARCore-enabled apps that aren't updated will fail to create a\nsession and might crash when attempting to start an augmented reality (AR)\nsession on affected 64-bit devices**, specifically:\n\n| ARCore SDK | Session creation failure details |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **ARCore SDK for Android (NDK)** | [`ArSession_create`](/ar/reference/c/group/session#arsession_create) and [`ArSession_createWithFeatures`](/ar/reference/c/group/session#arsession_createwithfeatures) will return `AR_ERROR_FATAL`. |\n| **ARCore SDK for Android (Java)** | The Session constructors, [`Session(Context)`](/ar/reference/java/com/google/ar/core/Session#Session-context) and [`Session(Context, Set\u003cSession.Feature\u003e)`](/ar/reference/java/com/google/ar/core/Session#Session-context-features), will throw a [`FatalException`](/ar/reference/java/com/google/ar/core/exceptions/FatalException). |\n| **ARCore SDK for Unity** | When you enable the [`ARCoreSession`](/ar/reference/unity/class/GoogleARCore/ARCoreSession) component, which is usually found on the [ARCore Device](/ar/reference/unity/prefab/ARCore_Device) prefab, ARCore will fail to create an ARCore session and [`Session.Status`](/ar/reference/unity/class/GoogleARCore/Session#status) will be `SessionStatus.FatalError`. |\n| [**AR Foundation (Unity)**](https://unity.com/unity/features/arfoundation) + [**ARCore XR Plugin**](https://docs.unity3d.com/Packages/com.unity.xr.arcore@latest) | The app will stop rendering (black screen) when the app tries to start an AR session, due to a crash on the main thread while trying to load non-existent 32-bit ARCore native libraries. |\n\nDetermining whether your app must be updated\n--------------------------------------------\n\nTo check whether your published app includes the required native ARCore\nlibraries to support 64-bit devices:\n\n1. Open the [Google Play Console](https://play.google.com/console).\n\n2. Select your ARCore-enabled app.\n\n3. Expand the app's active release to verify that the **Native platforms**\n includes 64-bit (`arm64-v8a`) support.\n\nUpdating your app to support 64-bit devices\n-------------------------------------------\n\nTo update an existing 32-bit-only ARCore-enabled app to include 64-bit native\nlibraries:\n\n1. Update your project to use the latest [ARCore SDK](/ar/develop/downloads).\n\n2. Build your app and publish it using the\n [Google Play Console](https://play.google.com/console).\n\nGoogle Play will verify that your app meets the Google Play Store\n[64-bit requirement](https://android-developers.googleblog.com/2019/01/get-your-apps-ready-for-64-bit.html)\nthat previously went into effect on August 1, 2019. To ensure that your\nARCore-enabled app includes 64-bit (`arm64-v8a`) support for all 64-bit devices,\nregardless of Android version or API level."]]
