Unity용 ARCore SDK는 2021년에 지원 중단되었으며 더 이상 지원되지 않습니다. 또한 Unity용 ARCore SDK는 Unity 2020 이상에서 사용할 수 없습니다. 새 프로젝트를 시작하는 개발자는 대신 AR Foundation용 ARCore 확장 프로그램을 사용해야 합니다. 이 SDK는 AR Foundation으로 이전할 수 없는 기존 프로젝트에서 작업하는 개발자만 사용해야 합니다.

Unity로 Android 11용 빌드

Android 11 (API 수준 30)을 지원하기 위해 패키지 공개 상태 <queries> 요소가 Unity용 ARCore SDK (1.19 이상)에 추가되었습니다. 이러한 버전의 ARCore를 사용할 경우 <queries> 요소에 Gradle 버전 5.6.4 이상이 필요합니다.

대부분의 경우 Android Gradle 플러그인 버전 3.6.0을 사용하는 것으로 충분합니다. Android Gradle 플러그인과 사용 중인 Gradle 버전 간의 호환성을 확인하려면 Android Gradle 플러그인 호환성 표를 참고하세요.

Unity Gradle 지원

다음 섹션에서 지원되는 Unity 버전에 대한 안내를 확인할 수 있습니다. Gradle 맞춤설정을 지원하지 않는 Unity 버전은 Unity 빌드에서 직접 Android 11 (API 수준 30) (targetSdkVersion 30)을 타겟팅할 수 없습니다.

자세한 내용은 다음 도움말을 참고하세요.

Unity 2019.3 및 2019.4

  1. Preferences > External Tools > Android > Gradle로 이동하고 맞춤 Gradle을 Gradle 5.6.4 이상으로 설정합니다. 다운로드는 Gradle 빌드 도구를 참고하세요.

    수동으로 지정된 Gradle 경로를 보여주는 외부 도구, Android 창 스크린샷

  2. Project Settings &gt Player > Android> Publishing Settings > Build로 이동하여 다음 두 가지를 모두 선택합니다.

    1. 맞춤 기본 Gradle 템플릿
    2. 맞춤 런처 Gradle 템플릿

    두 개의 Gradle 템플릿 옵션이 선택된 Publishing Settings(빌드 설정)의 Build(빌드) 창을 보여주는 스크린샷

  3. 생성된 두 파일 모두에 다음 변경사항을 적용합니다.

    • Assets/Plugins/Android/mainTemplate.gradle
    • Assets/Plugins/Android/launcherTemplate.gradle

    파일 상단에서 다음 댓글을 삭제합니다.

    // GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN
    

    파일 상단에 다음 줄을 삽입합니다.

    buildscript {
        repositories {
            google()
            jcenter()
        }
        dependencies {
            // Must be Android Gradle Plugin 3.6.0 or later. For a list of
            // compatible Gradle versions refer to:
            // https://developer.android.com/studio/releases/gradle-plugin
            classpath 'com.android.tools.build:gradle:3.6.0'
        }
    }
    
    allprojects {
       repositories {
          google()
          jcenter()
          flatDir {
            dirs 'libs'
          }
       }
    }
    

2019.1 및 2019.2

  1. Preferences > External Tools > Android > Gradle installed with Unity로 이동합니다. 옵션을 지우고 5.6.4 이상의 커스텀 버전을 지정합니다. 다운로드는 Gradle 빌드 도구를 참고하세요.

    수동으로 지정된 Gradle 경로를 보여주는 외부 도구, Android 창 스크린샷

  2. Project Settings > Player > Android Tab > Publishing Settings > Build로 이동하여 Custom Gradle Template을 선택합니다.

    Custom Gradle 템플릿이 선택된 게시 설정, 빌드 창의 스크린샷

  3. 생성된 파일 Assets/Plugins/Android/mainTemplate.gradle을 수정하고 사용하는 Gradle 버전에 따라 종속 항목 com.android.tools.build:gradle을 3.6.0 이상으로 설정합니다.

    buildscript {
        dependencies {
            // Must be Android Gradle Plugin 3.6.0 or later. For a list of
            // compatible Gradle versions refer to:
            // https://developer.android.com/studio/releases/gradle-plugin
            classpath 'com.android.tools.build:gradle:3.6.0'
        }
    }
    

Unity 2018.4

  1. Build Settings > Android로 이동하고 Build SystemGradle로 설정하여 맞춤 Gradle 버전을 사용합니다.

    드롭다운 선택 요소에서 Gradle을 빌드 시스템으로 선택하는 것을 강조하는 Unity 플랫폼 선택 창의 스크린샷

  2. Preferences > External Tools > Android > Gradle installed with Unity로 이동합니다. 옵션을 지우고 5.6.4 이상의 커스텀 버전을 지정합니다. 다운로드는 Gradle 빌드 도구를 참고하세요.

    수동으로 지정된 Gradle 경로를 보여주는 외부 도구, Android 창 스크린샷

  3. Project Settings &gt Player > Android> Publishing Settings > Build로 이동하여 Custom Gradle Template을 선택합니다.

    Custom Gradle 템플릿이 선택된 게시 설정, 빌드 창의 스크린샷

  4. 생성된 파일 Assets/Plugins/Android/mainTemplate.gradle을 수정하고 사용하는 Gradle 버전에 따라 종속 항목 com.android.tools.build:gradle을 3.6.0 이상으로 설정합니다.

    buildscript {
        dependencies {
            // Must be Android Gradle Plugin 3.6.0 or later. For a list of
            // compatible Gradle versions refer to:
            // https://developer.android.com/studio/releases/gradle-plugin
            classpath 'com.android.tools.build:gradle:3.6.0'
        }
    }
    

Unity 2018.3 이하(2017 포함)

Gradle 맞춤설정은 이러한 버전의 Unity에서 지원되지 않으며 Android 11 (API 수준 30)을 지원하는 데 필요한 변경사항과 호환되지 않습니다.

Unity용 ARCore SDK는 이러한 버전에서 Android 11 (API 수준 30) 지원을 제거하므로 앱은 Android 10 (API 수준 29) 이하에서도 원활하게 작동합니다.