Unity API 업데이터 사용 안내
Unity는 다양한 버전에서 스크립트와 API의 동작을 개선하기 위해 클래스를 업데이트하고, 이를 통해 사용하지 않는 코드를 자동으로 감지하고 수정하는 API 업데이터를 제공합니다. 이 문서에서는 API 업데이터 사용법과 관련된 내용을 한국어로 설명하고, 이를 활용하는 방법에 대한 예제를 제시합니다.
API 업데이터란?
API 업데이터는 Unity에서 제공하는 기능으로, 사용하지 않는 코드의 식별과 자동 수정을 담당합니다. 이 기능은 다음 두 가지로 나뉩니다:
- ScriptUpdater: 소스 코드(스크립트)를 업데이트합니다.
- AssemblyUpdater: 어셈블리(dll 파일)를 업데이트합니다.
주요 기능
- 자동 업데이트 실행: 스크립트 컴파일 시 자동으로 실행되며 프로젝트를 열거나 패키지를 임포트할 때 트리거됩니다.
- 경고 및 오류 메시지: 처리할 수 없는 오류는 수동으로 해결해야 하며, 콘솔 메시지에는
UnityUpgradable이 표시됩니다. - 사용자 동의 기반 업데이트: 사용자가 동의하면, API의 권장 업데이트로 자동으로 코드를 수정합니다.
API 업데이터 사용 절차
- 스크립트 컴파일 트리거: 프로젝트 열기, 패키지 임포트 및 스크립트 변경 저장 시 자동으로 트리거됩니다.
- 오류 및 경고 확인: 업데이트할 수 있는 오류 또는 경고가 발견되면 대화 상자가 표시됩니다.
- 프로젝트 백업: 업데이트를 진행하기 전에 프로젝트를 백업하는 것이 좋습니다.
- 업데이트 동의: 사용자 동의 후 자동 업데이트가 진행됩니다.
로그 기록 및 레벨 설정
API 업데이터는 어셈블리 변경 사항을 에디터 로그에 기록합니다. 로그의 임계값을 설정하여 기록되는 정보의 양을 조절할 수 있습니다.
| 로그 임계값 | 설명 |
|---|---|
| Error (기본값) | 오류 메시지만 기록합니다. |
| Warning | 경고 및 오류 메시지를 기록합니다. |
| Info | 정보, 경고, 오류 메시지를 기록합니다. |
| Debug | 모든 메시지를 기록합니다. |
예제: 로그 설정하기
Windows에서 Unity를 실행할 때 로그 설정을 추가하는 방법은 다음과 같습니다.
c:> set UNITY_APIUPDATER_LOG_THRESHOLD=Debug
c:> \path\to\unity\Unity.exe
Linux의 경우는 다음과 같습니다.
$ export UNITY_APIUPDATER_LOG_THRESHOLD=Debug
$ /path/to/unity/Unity
문제 해결
API 업데이트에 실패할 경우, 콘솔 메시지를 확인하여 원인을 파악할 수 있습니다. 특히 스크립트 파일에 대한 읽기 전용 권한 여부를 점검해야 합니다.
예제: 실패한 업데이트 확인하기
콘솔에서 확인할 수 있는 오류 메시지:
- 사용자 권한이 문제인 경우: "업데이트를 적용할 수 없습니다."
- 변경 내용이 저장되지 못한 경우: "API 업데이터가 모든 사용되지 않는 코드를 업데이트할 수 없습니다."
결론
Unity API 업데이터는 스크립트와 어셈블리의 자동 업데이트를 통해 코드의 유지 보수를 간소화하는 도구입니다. 정기적으로 사용하지 않는 코드를 점검하고, 필요에 따라 업데이트하여 프로젝트의 최적화와 성능 향상에 기여할 수 있습니다.