Webzen 자동업데이트 모듈 Webzen 게임개발팀

Webzen 자동업데이트 모듈 구성도 WZ_UM.DLL : 실제 업데이트 코드가 있는 동적 라이브러리 WZ_Update.ini : 클라이언트의 버전정보를 가진 파일로 자동 업데이트 모듈을 사용하는 프로그램은 반드시 가지고 있어야 한다.

Webzen 자동업데이트 모듈 구성도 FTP WZ_UM.DLL 서버 사용자 프로그램

Webzen 자동업데이트 모듈 설명 자동업데이트 모듈을 사용하기 위해서는 다음 총 2개의 파일이 필요하다. WZ_UM.DLL(lib 와 h 파일은 필요시 사용) wz_update.ini (버전저장 및 기타 업데이트 환경설정 파일) 만일 업데이트에 실패하면 모듈은 기본적으로 메시지 박스로 에러상태를 알리며, 클라이언트 프로그램은 계속 수행 혹은 중단이 가능하다.

CFtpUpdateModule 설명 중요 함수원형 및 인수설명 BOOL CWZFtpUpdateModule:: Connect (LPSTR lpszIPADDR, WORD wPORT, LPSTR lpszID, LPSTR lpszPASS ) // FTP 서버와 연결한다. LPSTR lpszIPADDR, // 업데이트 서버 IP 주소 WORD wPORT, // 업데이트 서버 프토번호 (기본포트이면 생략가능) LPSTR lpszID, // 업데이트 서버 사용자 ID (생략가능) LPSTR lpszPASS // 업데이트 서버 사용자 비밀번호 (생략가능) BOOL CWZFtpUpdateModule::StartUpdate (LPFUNC_RECEIVEEVENT lpFN_EventCallbackFunc, LPSTR lpszVersionFileName) // 업데이트를 시작한다. LPFUNC_RECEIVEEVENT lpFN_EventCallbackFunc, // 사용자 EventCallBack 함수 LPSTR lpszVersionFileName // default버전 파일을 사용 안 할 경우 파일이름 BOOL CWZUpdateModule::UpdateStop() // 현재 진행중인 업데이트를 멈춤 VOID CWZUpdateModule:: Disconnect () // 서버와 연결을 끊음.

업데이트 관계도 P.S.> 위의 관계도의 자세한 설명은 뒷장에 설명한다. Wz_filelist.dat WZ 업데이트 모듈 폴더 “00.00.07” 파일1 파일2 WZ 업데이트 모듈 Wz_update.ini FTP (혹은 HTTP) 업데이트 서버 Version.dat 폴더 “00.01.02” 클라이언트 프로그램 폴더 “00.01.07” P.S.> 위의 관계도의 자세한 설명은 뒷장에 설명한다.

업데이트 버전관리 업데이트 모듈이 설치되는 클라이언트 측에서는 wz_update.ini 라는 파일 안에 버전을 관리하며 파일의 내용과 버전의 형식은 아래와 같다. [UPDATE_DATA] Version =2.10.04 // 버전은 세 개의 숫자가 점으로 나뉜 형태로 관리된다. SkipUpdate=0 // 이 값이 1이면 업데이트를 1회 건너뛴다. FTP (혹은 HTTP) 서버 의 최상위 폴더에는 version.dat 라는 파일이 있으며 이 파일은 실제 업데이트할 버전번호와 같은 이름의 업데이트 폴더들의 목록이 들어있다. 설사 FTP폴더에 업데이트 폴더가 존재한다 할지라도 version.dat 파일의 리스트 안에 들어있지 않는다면 업데이트 대상에서 제외된다. 아래는 이 파일의 내용의 예제이다. "00.93.01" "00.93.02" "00.93.04" "00.93.05"

업데이트 버전관리 FTP (혹은 HTTP) 업데이트 서버의 하위폴더로 각 업데이트 버전폴더가 존재하며 이 폴더의 이름은 업데이트할 버전의 이름과 같다. 또한 이 버전은 반드시 version.dat 파일의 버전리스트에 포함되어 있어야 한다. 각 업데이트 버전폴더 안에는 wz_filelist.dat 라는 업데이트할 파일의 목록이 존재하며 이 파일의 설명은 아래와 같다. "config.ini“ // 클라이언트 실행파일과 같은 폴더에 다운로드됨 "main.exe“ // 클라이언트 실행파일과 같은 폴더에 다운로드됨 0 "Data“ // 중요!!> 앞에 0이 붙으면 폴더생성 명령 // 클라이언트 쪽에 ‘Data’라는 폴더를 만들고 이 폴더로 다운로드 경로를 이동하라 0 "Data\Local“ // ‘Data\Local’ 이란 폴더를 만들고 이 폴더로 다운로드 경로를 이동하라. (주의!!> 이때 실제로는 ‘Data’폴더로 가서 ‘Loca’l이란 폴더를 만드는 것이므로 ‘Data’폴더는 미리 존재해야 한다. "Text.bmd“ // ‘.\Data\Local’ 폴더에 ‘Text.bmp’ 파일을 다운로드 함.

업데이트 버전관리 Wz_filelist.dat 파일 안의 파일목록은 대소문자를 구분하므로 주의한다. Wz_filelist.dat 파일 목록을 쉽게 만드는 방법은 같이 제공되는 UpdateListGen.exe 를 이용하는 것으로 사용법은 UpdateListGen.exe를 실행 시킨 후 나타난 윈도우 창 안에 업데이트할 파일들을 블록지정하여 (하위폴더 포함) 드래그 & 드롭하면 자동으로 Wz_filelist.dat 를 생성하여 준다. 또한 Wz_filelist.dat 파일 목록 안에 Wz_filelist.dat 자신이 기재되어 있으면 반드시 에러를 유발한다. 주의하기 바란다.