버전 업데이트

DEXTUploadX5 업데이트 버전은 DEXTSolution 사이트에서 배포되고 있다. 만일 새로운 버전으로 제품을 교체해야 한다면, 로그인을 한 후, 정품 다운로드 페이지에서 다운로드할 수 있다.

업데이트 기본 절차

기존 제품 리소스가 있는 경로에서 dextuploadx5-configuration.js 파일을 백업한다.

만약 언어 리소스 파일을 수정했거나, 새로 추가된 리소스 파일이 있다면 대상 파일을 모두 백업한다.

변경된 사항이 없다면 언어 리소스 파일을 백업하지 않아도 상관없다.

DEXTSolution 사이트에서 로그인을 한 후, 정품 다운로드 페이지로 이동하여 업데이트할 버전을 다운로드 받는다.

다운로드 받은 배포 파일(dextuploadx5-{version}.zip)을 압축 해지한다.

압축을 풀었을 때 생성되는 dx5 디렉터리 안의 모든 리소스를 복사하여 기존 리소스를 교체(지우고 복사)한다.

dextuploadx5-configuration.js 파일을 열어 인증키 부분과 productPath 속성을 백업된 파일에서 복사하여 설정한다.

# dextuploadx5-configuraiton.js
win.dextuploadx5Configuration = {
  // 빈 문자열로 선언된 인증키 속성을 백업된 인증키 문자열로 다시 설정한다.
  authkey: "",
  // productPath 속성을 기존 경로에 맞게 설정한다.
  productPath: location.origin + "/path/dx5",
  ...
};

백업했던 언어 리소스 파일(txt, xml) 내용 중에 직접 추가하거나 수정했던 부분을 새로운 리소스 파일에 그대로 적용한다.

브라우저는 캐시 기능을 가지고 있기 때문에, 캐시를 지우지 않으면 업데이트된 내용이 바로 반영되지 않을 수 있다. 따라서 업데이트 후에는 브라우저 캐시를 반드시 삭제하거나 강력 새로고침을 수행해야 한다.

강력 새로고침 단축키: Windows - Ctrl + F5(Ctrl + Shift + R) / Mac - Command + Shift + R
Safari 브라우저는 강력 새로고침 단축키가 없으므로, 개발자 메뉴를 활성화 후, 개발자용 메뉴에서 캐시를 비우거나 설정에서 캐시를 삭제해야 한다.

1.4.1.0 버전 이전과 이후의 차이

1.4.1.0 버전은 클라이언트 설치 파일, 설치 파일 다운로드 페이지, 리소스 파일이 모두 dx5 디렉터리 하위에 존재했다. 그러나 1.4.1.0 버전 이후부터는 설치 파일과 다운로드 페이지를 하위 client 디렉터리로 따로 묶었으며, 리소스 파일은 하위 res 디렉터리로 이동시켰다.

그러므로 1.4.1.0 이전 버전에서 이후 버전으로 업데이트를 할 때에는 디렉터리 구조가 달라지므로 복사를 통한 덮어쓰기 보다, 기존 버전을 완전히 지우고 새 버전을 사용하시길 권장한다. 또한 dextuploadx5-configuration.js 파일도 일부 속성에 차이가 있기 때문에 기존 파일을 그대로 사용할 수 없으므로 인증키과 각 경로들을 새롭게 설정해주어야 한다.

3.0.0.0 버전 이전과 이후의 차이

주요 스크립트 파일들이 module 디렉터리 하위로 이동되었으며, 모듈화 작업으로 분리된 스크립트들이 생성되었다.

그러므로 3.0.0.0 이전 버전에서 이후 버전으로 업데이트를 할 때에는 디렉터리 구조가 달라지므로 복사를 통한 덮어쓰기 보다, 기존 버전을 완전히 지우고 새 버전을 사용하시길 권장한다.

4.0.0.0 버전 이전과 이후의 차이

4.0.0.0 버전부터는 Internet Explorer를 지원하지 않으므로써, IE 모듈이 완전히 제거되었다.

그러므로 4.0.0.0 이전 버전에서 이후 버전으로 업데이트를 할 때에는 디렉터리 구조 및 파일 모두가 달라지므로 복사를 통한 덮어쓰기 보다, 기존 버전을 완전히 지우고 새 버전을 사용하시길 권장한다.

4.3.2.0 버전 이전과 이후의 차이

4.3.2.0 버전부터는 HD 응용프로그램이 macOS를 지원하지 않는다.

3.10.4.0 이하 버전에서 4.3.4.0 버전 이상으로 업데이트하는 경우

Chrome(144.0.7559.60이상) 브라우저가 정책을 바꾸면서, DEXTUploadX5의 드래그 앤 드롭 기능이 동작하지 않는 현상이 발생하여, 2026년 1월 20일 긴급 패치(4.3.4.0)가 릴리즈되었다. 그러나 해당 패치는 Internet Explorer 브라우저(MS Edge IE mode 포함)를 지원하지 않으므로, 환경에 따라 다음과 같이 대응 방안을 선택하여 적용해야 한다.

최신 모던(Modern) 브라우저만 사용하는 경우

최신 Edge(144.0.3719.82이상) / Chrome(144.0.7559.60이상) 브라우저 사용 시, 반드시 최신버전(4.3.4.0 이상)으로 패치적용
Internet Explorer 브라우저(MS Edge IE mode 포함)만 사용하는 경우

DEXTUploadX5 기존 버전(3.10.3.0 이하)을 유지한다.

Internet Explorer 브라우저(MS Edge IE mode 포함)와 최신 모던 브라우저를 혼용하여 사용하는 경우

DEXTUploadX5 기존 버전(3.10.3.0 이하)과 최신 버전(4.3.4.0 이상)을 이원화하여 구성한 뒤, 페이지별로 환경에 맞는 버전이 로드 되도록 분리 적용한다. 이원화란 동일 사이트 내에서 페이지 별로 적합한 버전이 호출되도록 구성하는 방식을 말한다. 기존 업데이트 방식과 달리 DEXTUploadX5 리소스 디렉터리를 분리하여 관리해야 한다.

# Internet Explorer 브라우저(MS Edge IE mode 포함)용 예시
<script src="path/dx5/dextuploadx5-configuration.js"></script>
<script src="path/dx5/dextuploadx5.js"></script>

# dextuploadx5-configuration.js 파일 내의 설정 중 productPath 속성도 각각의 경로에 맞게 설정해야 한다.
win.dextuploadx5Configuration = {  
  ...
  // Internet Explorer 브라우저(MS Edge IE mode 포함)용
  productPath: location.origin + "/path/dx5",
  ...
};

# 최신 모던 브라우저용 예시
<script src="path/dx5-4340/dextuploadx5-configuration.js"></script>
<script src="path/dx5-4340/dextuploadx5.js"></script>

# dextuploadx5-configuration.js 파일 내의 설정 중 productPath 속성도 각각의 경로에 맞게 설정해야 한다.
win.dextuploadx5Configuration = {  
  ...
  // 최신 모던 브라우저용    
  productPath: location.origin + "/path/dx5-4340",
  ...
};

Setting multiple versions

만약에 하나의 페이지에서 브라우저 별로 이원화를 하고자 한다면 다음과 같은 방법을 사용할 수 있다.

# JSP 기반 예시 코드
<%
    String ua = request.getHeader("User-Agent");
    boolean isIE = (ua != null && (ua.contains("MSIE") || ua.contains("Trident")));
    String dx5Path = isIE ? "path/dx5" : "path/dx5-4340";
%>
<script src="<%= dx5Path %>/dextuploadx5-configuration.js"></script>
<script src="<%= dx5Path %>/dextuploadx5.js"></script>

위와 같이 하나의 페이지에서 브라우저를 판별하여 DEXTUploadX5 버전을 분기하는 방식은, DEXTUploadX5의 HTML5 기반 업로드 모듈을 사용하는 경우에만 적용 가능하다. ActiveX 기반 IE 전용 모듈을 사용하는 환경에서는 해당 방식이 컴포넌트 로드가 실패할 수 있는 가능성이 있으므로, 이 경우에는 반드시 페이지 단위로 완전히 분리된 구성을 통해 각각의 버전을 적용해야 한다.

상위 HD 응용프로그램을 사용하고자 하는 경우

"업데이트 기본 절차"를 따른 후, HD 응용프로그램을 새 버전으로 교체하기 위해 두 가지 방법이 제공된다.

사용자의 PC에 HD 응용프로그램이 설치가 되어 있지 않은 경우에는 사용자가 HD 응용프로그램을 다운로드할 수 있도록 팝업 창이 열린다. 이와 반대로 설치가 되어 있다면, HD 응용프로그램을 사용하여 다운로드를 하려고 할 때, 자동 업데이트 작업이 실행된다.

자동 업데이트 기능은 2.1.2.0 버전부터 지원하며, 자동 업데이트가 원활하려면 이미 열린 HDM(윈도우 트레이에 상주)이 있을 경우, 직접 종료시켜야 한다.

자동 업데이트으로 인해 내려 받게 되는 파일은 dextuploadx5-configuration.js 파일의 hd32UpdateURL, hd64UpdateURL 속성에 설정된 주소가 가리키는 대상이다.