Crossplay Launcher Patch File Maker

Crossplay Launcher Patch File Maker는 게임 풀 클라이어트의 최신 버전과 직전 버전을 비교한 패치 파일들을 Patch_Files_Folder에 생성합니다. (명령줄로 경로를 설정하여 실행할 때에는 default 폴더를 사용하지 않습니다.)

항목 argument
환경
(-e를 -envi로 변경 가능)		 DEV -e=DEV
TEST -e=TEST
SANDBOX -e=SANDBOX
LIVE 무
이전 버전 게임 파일 경로 -prePath=… (미 설정 시 Pre_Version_Folder 폴더 사용)
신규 버전 게임 파일 경로 -nextPath=… (미 설정 시 Cur_Version_Folder 폴더 사용)
Patch 파일 생성 경로 -patchPath=… (미 설정 시 Patch_Files_Folder 폴더 사용)
appid 설정 -appid=…
버전 설정 -version=…
“y/n?” 건너뛰기 처리 -runbatch

적용 예시

앱 아이디가 com.gcp2.stepbystep.windows.google.global.normal이고 1.0.0.1 버전이 업로드된 조건에서1.0.0.2 버전을 업로드하는 경우를 예시로 아래와 같이 설명합니다.

  1. cpflptc.exe를 실행하세요.

    테스트 서버와 샌드박스 서버가 모두 필요한 경우에는 터미널, CMD, 파워쉘 등에서 프로그램 실행 인수로서 -envi=TEST 또는 -envi=SANDBOX를 추가하세요.
  2. 게임 파일을 복사하세요.

    Pre_Version_Folder에 1.0.0.1 버전의 게임 파일(meta.json 및 게임 파일 포함)을 넣고 Cur_Version_Folder에 1.0.0.2 버전의 게임 파일(meta.json 및 게임 파일 포함)을 넣으세요. 실행 창에 y 입력 후 Enter 키를 누르세요.
    meta.json 파일에 관한 내용은 개발 가이드 중 크로스플레이 런처 > 주의 사항 > 게임 관련 주의 사항을 참고하세요.
  3. 게임 appid 입력 후 Enter 키를 누르세요.
  4. 이전 버전을 입력하세요.
  5. 패치 파일 생성을 진행할지 묻는 “Start to process? (y/n)”(진행하시겠습니까? (예/아니오)) 질문에 y 입력 후 Enter 키를 누르세요.
  6. 패치 파일 생성이 완료될 때까지 대기하세요.
  7. Patch_Files_Folder에 다음과 같이 패치 파일이 생성되었는지 확인하세요.
    • [파일명]_patch 파일
      버전 간 같은 경로에 위치한 게임 파일의 내용이 서로 다를 경우 [파일명]_patch 파일이 생성됩니다.
    • [파일명] 파일
      1.0.0.1 버전에 없지만 1.0.0.2 버전에 새로 추가되는 파일은 Patch_Files_Folder에 생성됩니다.

Crossplay Launcher Uploader

크로스플레이 런처를 통해 사용자들이 게임 파일을 다운로드할 수 있도록 게임 개발 파트에서 게임 파일을 제작 및 QA 완료 후 서버에 업로드해야 합니다. Crossplay Launcher Uploader를 이용하여 게임 파일을 업로드할 수 있습니다. (명령줄로 설정하여 실행할 때 해당 항목은 입력하지 않습니다.)

항목 argument 비고
환경
(-e를 -envi로 변경 가능)		 DEV -e=DEV -e는 -envi로 대체가능
TEST -e=TEST
SANDBOX -e=SANDBOX
LIVE 무
도움말 -h or –help or -?
Release 설정 –release

생략시 패치 파일 업로드 모드로 동작

최초 업로드시 반드시 설정 필요

게임 버전은 릴리즈 버전과 패치 버전으로 구분됩니다. 최신 버전과 이전 버전 간 변경점이 크지 않다면 가급적 패치 버전으로 업로드를 권장합니다.

  • 릴리즈 버전: 서버에 원본 파일과 패치 파일이 모두 업로드 됩니다. 최초 설치 시 최신 릴리즈 버전 게임이 다운로드 됩니다
  • 패치 버전: 서버에 패치 파일만 업로드 됩니다. 최신 버전을 설치한 사용자는 이후 패치 버전을 다운로드 받아 게임을 패치 할 수 있습니다.
Appid 설정 ‐‐appid=…
버전 설정 -v=… or ‐‐version=…
최초 업로드 유무 설정 ‐‐notfirstupload 최초 업로드 이후 업로드 시 반드시 설정 필요
플랫폼 설정 -p=w or ‐‐platform=w 생략시 실행중인 플랫폼 환경으로 설정
업로드 파일 경로 설정 ‐‐filepath=… 미 설정 시 toUploadFiles 폴더 사용
patch 파일 경로 ‐‐filepatchpath=… 미 설정 시 toUploadPatchFiles 폴더 사용
Meta 데이터 생성경로 ‐‐metadatapath=… 미 설정 시 metadatas 폴더 사용

 

적용 예시

앱 아이디가 com.gcp2.stepbystep.windows.google.global.normal이고 1.0.0.2 버전 게임 파일을 업로드하는 경우를 예시로 아래와 같이 설명합니다.

  1. 게임 파일을 복사하세요.

    게임 파일들은 toUploadFiles에 넣고, Crossplay Launcher Patch File Maker로 생성한 패치 파일들은 toUploadPatchFiles에 넣으세요. (게임 최초 업로드 시, 패치 파일이 없으므로 toUploadPatchFiles 폴더에 넣을 필요 없습니다.)

  2. cpflupl.exe를 상기 표를 참고하여 커맨드 파라메터를 포함하여 실행하세요.
  3. 커맨드 파라메터가 정상적으로 입력되었다면 콘솔 서버 업로드까지 자동으로 진행됩니다.
  4. 게임 업로드가 완료되면 http://console.withhive.com/에 접속하여 정상적으로 업로드되었는지 확인하세요.
    • SANDBOX 환경: http://sandbox-console.withhive.com/
  5. 검수 상태에서 릴리즈 버전은 아래 모든 항목을, 패치 버전은 검수 IP 등록과 게임 업데이트 확인하기 항목을 반드시 확인해야 합니다.

    1. 검수 IP 등록 (미등록 시)

      게임명과 appid를 선택하여 공인 IP(권장) 또는 사설 IP를 등록하세요.

    2. 게임 업데이트 확인하기 (릴리즈 버전과 패치 버전 모두 필요)
      • 직전 버전까지 설치 또는 업데이트를 진행하고, 검수할 버전을 대기 상태에서 검수 상태로 변경한 후 게임 업데이트를 실시하세요.
      • 게임 업데이트 중 크로스플레이 런처의 오류 발생 여부를 확인하세요.
      • 게임 시작 시 정상 작동 여부를 확인하세요.
      • WinMerge와 같은 데이터 비교 툴을 사용하여 로컬 크로스플레이 런처로 설치된 게임 풀 클라이언트와 게임 개발단에서 갖고 있는 검수 중인 버전의 오리지널 풀 클라이언트를 비교하세요. 파일이 동일해야 합니다.
        게임 검수 설정
    3. 게임 설치 확인하기 (릴리즈 버전에서만 필요)
      1. Windows 환경에서는 제어판에서 게임을 제거하세요.
      2. 업로드한 게임을 설치하세요.
        • 게임 설치 중 크로스플레이 런처의 오류 발생 여부를 확인하세요.
        • 바탕화면\시작 메뉴에 아이콘이 생성되었는지 확인하세요.
        • 게임 시작 시 정상 작동 여부를 확인하세요.
        • WinMerge와 같은 데이터 비교 툴을 사용하여 로컬 크로스플레이 런처로 설치된 게임 풀 클라이언트와 게임 개발단에서 갖고 있는 검수 중인 버전의 오리지널 풀 클라이언트를 비교하세요. 파일이 동일해야 합니다.
  6. 검수 상태에서 제어판에 진입하여 게임을 삭제하고, 추가로 파일을 삭제하는 delete 파라미터와 바탕화면 및 시작 메뉴 바로가기가 정상적으로 삭제되었는지 확인하세요. delete 파라미터에 대한 내용은 크로스플레이 런처 > 게임 관련 주의 사항 > 파일 삭제 기능 가이드를 참고하세요.
  7. 검수 설정을 OFF 상태로 변경하고, 배포 설정 창에서 배포일을 지정한 후 배포일 저장을 클릭하세요.
  8. 상태 항목이 배포중으로 변경되었는지 확인하세요.
    • 배포 전
    • 배포 후