Unity C# Obsolete 어트리뷰트

1. 개요

[Obsolete]는 더 이상 사용되지 않는 코드(메서드, 클래스, 필드 등) 에 표시하는 C# 어트리뷰트입니다.

• 해당 코드 사용 시 경고(WARNING) 또는 오류(ERROR)를 발생시킴.
• 새로운 API로의 전환을 유도하는 용도로 사용.
• Unity에서도 기존 함수의 폐기(Deprecated) 시 사용됨.

2. 기본 사용법

[Obsolete]
void OldMethod()
{
    Debug.Log("이 메서드는 더 이상 사용되지 않습니다.");
}

3. 사용자 메시지 추가

[Obsolete("NewMethod()를 대신 사용하세요.")]
void OldMethod()
{
    Debug.Log("이 메서드는 더 이상 사용되지 않습니다.");
}

⚠ 경고 메시지:

"OldMethod()는 더 이상 사용되지 않습니다. NewMethod()를 대신 사용하세요."

 

 

4. 오류로 변경 (error = true)

더 이상 사용 불가능하게 만들기

[Obsolete("NewMethod()를 대신 사용하세요.", true)]
void OldMethod()
{
    Debug.Log("이 메서드는 실행되지 않습니다.");
}

🚨 컴파일 오류 발생 (실행 불가)

"OldMethod()는 더 이상 사용되지 않습니다. NewMethod()를 대신 사용하세요."

 

 

5. 실전 예제 (대체 함수 제공)

class Example
{
    [Obsolete("Use NewMethod() instead.", false)]
    public void OldMethod() { Debug.Log("구버전"); }

    public void NewMethod() { Debug.Log("신버전"); }
}

Example ex = new Example();
ex.OldMethod(); // 경고 발생
ex.NewMethod(); // 정상 실행

6. Unity에서의 활용 예시

(1) Unity의 기존 API 변경

Unity는 종종 오래된 함수를 [Obsolete] 처리하여 새 함수로 대체합니다.
예: Application.LoadLevel() → SceneManager.LoadScene()

[Obsolete("Use SceneManager.LoadScene instead.")]
public static void LoadLevel(string name)
{
    SceneManager.LoadScene(name);
}

(2) 게임 개발에서 API 변경 시 유도

[Obsolete("MovePlayer(float x, float y)를 대신 사용하세요.")]
public void MovePlayer(Vector2 position)
{
    MovePlayer(position.x, position.y);
}

public void MovePlayer(float x, float y)
{
    Debug.Log($"플레이어 이동: {x}, {y}");
}

개발자가 기존 코드를 사용하지 않고 새로운 함수로 전환하도록 유도 가능.

 

7. 요약

▶ [Obsolete]로 더 이상 사용되지 않는 코드를 표시.
▶  "경고 메시지"를 추가해 대체 API 안내 가능.
▶  true 설정 시 컴파일 오류 발생 (사용 완전 금지).
▶  Unity API 변경 시 자주 사용됨 (Application.LoadLevel() → SceneManager.LoadScene()).