Deprecated 기능은 바로 사용할 수 없게 되는가

이런 상황일 때

로그에 “deprecated”라는 줄이 잔뜩 찍힙니다. 잘 돌고는 있는데 경고가 계속 나오니 불안합니다. 당장 고쳐야 하는 건지, 아니면 무시해도 되는 건지 판단이 안 섭니다.

한 줄 결론

지금 당장 고칠 필요는 대개 없습니다. Deprecated는 아직 동작한다는 뜻입니다. 다만 언제까지인지는 확인해 두셔야 하고, 그 시점은 대개 다음 메이저 판입니다.

핵심 개념

Deprecated — 없앨 예정

“더 이상 권하지 않는다”는 뜻입니다. 지금은 동작합니다. 만드는 쪽이 미리 알려 주어 옮길 시간을 주는 것입니다.

Removed — 없어졌다

이때부터 동작하지 않습니다. 로그에 경고가 아니라 오류가 찍히고 프로그램이 아예 뜨지 않기도 합니다.

사이에 있는 유예

경고와 제거 사이에는 대개 시간이 있습니다. 흔한 방식은 “다음 메이저 판에서 제거”입니다. 반년에서 몇 년까지 프로그램마다 다릅니다.

유예를 약속하지 않는 곳도 있다

0.x 판인 프로그램이나 시험판은 유예 없이 없앨 수 있습니다. 그래서 경고를 봤을 때 그 프로그램의 정책부터 확인하는 것이 순서입니다.

경고는 내가 아니라 남이 낼 수도 있다

내가 쓴 설정이 아니라 내가 깔아 둔 플러그인이나 테마가 내는 경고인 경우가 많습니다. 그때 내가 고칠 수 있는 것은 없고, 만든 쪽이 고쳐 주기를 기다리거나 다른 것으로 갈아타야 합니다.

이런 분에게 해당됩니다

• 로그에 deprecated 경고가 쌓이는 것을 보고 있는 분
• 플러그인이나 확장을 여러 개 깔아 쓰는 분
• 메이저 업데이트를 앞두고 무엇을 미리 고쳐야 할지 찾는 분

확인해야 할 항목

• 경고가 정확히 무엇을 가리키는가 — 설정 항목인가, 기능인가
• 그 경고를 내는 것이 내 설정인가, 내가 깐 확장인가
• 언제 제거될 예정이라고 적혀 있는가
• 대신 쓸 것이 안내돼 있는가
• 이 프로그램이 유예 기간을 약속하고 있는가

잘못 이해하기 쉬운 부분

안전한 행동 순서

1. 경고 줄 전체를 그대로 복사해 둡니다 — 무엇이 문제인지 그 줄에 적혀 있습니다.
2. 그 경고를 내는 것이 내 설정인지 내가 깐 확장인지 가립니다.
3. 공식 문서에서 언제 제거되는지를 찾습니다.
4. 내 설정이면 대신 쓸 것으로 바꿔 둡니다. 급하지 않으니 시험해 볼 여유를 두고 합니다.
5. 확장이 내는 것이면 그 확장의 최신판이 고쳤는지 확인합니다.
6. 고쳐지지 않았다면 제거 예정 시점을 적어 두고 그 전까지 대안을 찾습니다.

확인 체크리스트

• 경고 줄 원문을 기록해 두었다
• 경고의 출처(내 설정인가 확장인가)를 가렸다
• 제거 예정 시점을 확인했다
• 대신 쓸 것이 무엇인지 확인했다
• 다음 메이저 업데이트 전에 처리하기로 적어 두었다

관련 도구와 버전 페이지

• 폐기 예정 기능 추적 — 아직 제공하지 않습니다
  어떤 기능이 언제 없어지는지 이 사이트는 추적하지 않습니다. 각 제품의 공식 문서를 직접 보셔야 합니다.

자주 묻는 것

경고가 수백 줄씩 찍혀 로그를 못 보겠습니다.

같은 경고가 반복되는 것이라면 원인은 대개 한두 곳입니다. 중복을 걷어내고 서로 다른 줄만 세어 보세요. 생각보다 적습니다.

쓰던 확장이 더 이상 관리되지 않습니다.

제거 예정 시점이 사실상의 마감입니다. 그 전에 대안을 찾아 두셔야 하고, 마땅한 대안이 없다면 그 기능을 쓰는 방식 자체를 바꾸는 것까지 생각하셔야 합니다.

“다음 메이저에서 제거”라는데 다음 메이저가 언제인가요?

정해져 있지 않은 경우가 많습니다. 릴리스 간격으로 가늠하는 수밖에 없습니다. 다만 예고 없이 앞당겨지는 일은 드뭅니다.