하위 호환성 노트

저희는 제품을 가능한 한 하위 호환성(BC)을 유지하도록 개발하려고 노력합니다.

하위 호환성을 깨는 것은 주요 릴리스(4.0, 5.0 등)에서만 허용됩니다. 마이너 릴리스(4.2, 4.3 등)는 새로운 기능을 도입할 수 있지만, 기존 API를 깨지 않는 방식으로 해야 합니다.

그러나 코드가 아직 성숙하지 않아 버그 수정이 마이너 릴리스 또는 패치 릴리스(4.2.5 등)에서도 호환성을 깰 수 있습니다. 이러한 경우 모든 호환성 변경 사항은 변경 로그에 설명되어 있습니다.

호환성을 깨지 않는 변경 사항

  • 더 이상 사용되지 않는(deprecated) 항목은 하위 호환성(BC) 약속의 적용 대상이 아닙니다. 해당 항목은 그 다음 마이너 버전 이후에 제거될 수 있습니다. 예를 들어, 4.3.x부터 deprecated된 항목은 4.5.0에서 제거될 수 있습니다.

  • system/Language/en/에 정의된 시스템 메시지는 엄격히 프레임워크 내부 용도로만 사용되며 하위 호환성(BC) 약속의 적용 대상이 아닙니다. 개발자가 언어 문자열 출력에 의존하는 경우, 내용이 아닌 함수 호출(lang('...'))을 기준으로 확인해야 합니다.

  • 명명된 인수는 하위 호환성(BC) 약속의 적용 대상이 아닙니다. 코드베이스 개선을 위해 필요한 경우 메서드/함수 매개변수 이름을 변경할 수 있습니다.