Android Templates Upgrader 창은 Android Project Configuration Manager를 사용하기 위해 Gradle 템플릿 파일을 업그레이드하는 툴입니다. 업그레이드를 수행하기 위해 프로젝트의 Gradle 템플릿 파일을 가져온 다음 Android Project Configuration Manager API를 사용하여 Gradle 템플릿 파일과 동일한 Gradle 프로젝트 파일을 수정하는 새 C# 스크립트를 생성합니다. 그런 다음 Gradle 템플릿 파일을 비활성화합니다.
Android Templates Upgrader 창을 열려면 다음 단계를 따르십시오.
팁: 이 창을 일회성 업그레이드 경로로 사용하는 것이 가장 좋습니다. Gradle 템플릿 파일을 업그레이드한 후에는 새 C# 스크립트 및 Android Project Configuration Manager API를 사용하여 추가로 Gradle 프로젝트 파일을 수정해야 합니다.
| 프로퍼티 | 설명 |
|---|---|
| Custom Main Manifest | Main Manifest 템플릿 파일을 업그레이드할지 여부를 표시합니다. 이 프로퍼티는 플레이어 설정에서 Custom Main Manifest를 활성화한 경우에만 표시됩니다. |
| Custom Launcher Manifest | Launcher Manifest 템플릿 파일을 업그레이드할지 여부를 표시합니다. 이 프로퍼티는 플레이어 설정에서 Custom Launcher Manifest를 활성화한 경우에만 표시됩니다. |
| Custom Main Gradle Template | Main Gradle 템플릿 파일을 업그레이드할지 여부를 표시합니다. 이 프로퍼티는 플레이어 설정에서 Custom Main Gradle Template을 활성화한 경우에만 표시됩니다. |
| Custom Launcher Gradle Template | Launcher Gradle 템플릿 파일을 업그레이드할지 여부를 표시합니다. 이 프로퍼티는 플레이어 설정에서 Custom Launcher Gradle Template을 활성화한 경우에만 표시됩니다. |
| Custom Base Gradle Template | Base Gradle 템플릿 파일을 업그레이드할지 여부를 표시합니다. 이 프로퍼티는 플레이어 설정에서 Custom Base Gradle Template을 활성화한 경우에만 표시됩니다. |
| Custom Gradle Properties Template | Gradle Properties 템플릿 파일을 업그레이드할지 여부를 표시합니다. 이 프로퍼티는 플레이어 설정에서 Custom Gradle Properties Template을 활성화한 경우에만 표시됩니다. |
| Custom Gradle Settings Template | Gradle Settings 템플릿 파일을 업그레이드할지 여부를 표시합니다. 이 프로퍼티는 플레이어 설정에서 Custom Gradle Settings Template을 활성화한 경우에만 표시됩니다. |
| Upgrade Templates | Android Project Configuration Manager API를 사용하도록 선택한 Gradle 템플릿 파일을 업그레이드합니다. 업그레이드 프로세스에서는 선택한 Gradle 템플릿 파일과 동일한 Gradle 프로젝트 파일을 수정하는 새 C# 스크립트를 생성합니다. 업그레이드 프로세스가 성공하면 창에 새 C# 스크립트의 경로가 표시됩니다. 업그레이드 프로세스가 실패하면 창에 오류가 표시됩니다. 이 버튼은 업그레이드할 커스텀 Gradle 템플릿 파일을 하나 이상 선택하는 경우의 인터랙티브 버튼입니다. |
업그레이더가 커스텀 Gradle 템플릿 파일을 비활성화해도 삭제되지는 않습니다. 나중에 Gradle 템플릿 파일을 다시 사용하려는 경우, 생성된 C# 스크립트를 삭제하고 Android Player Settings에서 관련 커스텀 Gradle 템플릿 옵션을 다시 활성화하면 됩니다. 이렇게 하면 Gradle 템플릿 파일이 다시 활성화되어 업그레이더를 실행하기 전과 동일한 수정을 수행할 수 있습니다.
업그레이더를 여러 번 실행하면 이전에 생성된 C# 스크립트의 백업이 생성됩니다. 백업은 동일한 디렉토리에 있으며 새로 생성된 C# 스크립트와 동일한 이름을 갖습니다. 새로 생성된 C# 스크립트와 백업을 구분할 수 있도록 백업의 파일 확장자로는 .cs.BACKUP을 사용합니다.
경고: 업그레이더를 연속해서 실행하면 백업이 오버라이드됩니다. 따라서 백업 파일을 변경한 후 업그레이더를 실행하면 이러한 변경 사항이 손실됩니다.
경고: 작은따옴표를 사용하여 Gradle 템플릿의 문자열 프로퍼티 값을 정의하는 경우, 이러한 프로퍼티는 Gradle 프로젝트로 익스포트할 때 큰따옴표를 사용합니다.
경고: Unity는 두 개의 애플리케이션 엔트리 포인트를 지원합니다. Activity 및 GameActivity입니다. 업그레이드하려는 파일에 하나의 엔트리 포인트에 대한 수정 사항이 포함되었지만 해당 엔트리 포인트를 활성화하지 않은 경우, 생성된 C# 스크립트는 비활성화된 작업에 영향을 미치지 않습니다. 결과적으로 최종 AndroidManifest.xml은 수정 사항을 포함하지 않습니다.
예를 들어, 템플릿에 Activity 애플리케이션 엔트리 포인트에 대한 수정 사항이 포함된 경우 템플릿 업그레이더는 Activity도 수정하는 스크립트를 생성합니다. 나중에 GameActivity 애플리케이션 엔트리 포인트로 전환하는 경우 수정 사항은 영향을 미치지 않습니다.