패치 버전을 Hive 서버에 업로드

기존에 크로스플레이 런처로 PC 버전 앱을 샌드박스 환경 또는 상용 환경에 배포한 적이 있을 때, 이 앱을 업데이트하는 패치 버전을 Hive 콘솔 샌드박스 또는 상용 서버에 업로드합니다.

 

패치 버전을 업로드하는 방식은 크게 2가지입니다.

  1. 패치 파일만 업로드하는 방식
  2. 패치 파일과 함께 앱 전체 파일을 업로드하는 방식

 

패치 파일만 업로드하면, 사용자는 패치 파일로만 앱을 업데이트합니다. 이 방식은 패치 파일 용량이 크지 않을 때에 사용할 수 있습니다. 단, 이 방식은 앱 최초 버전과 마지막 버전 사이에 중간 버전들이 많을 때(예시: 1.0.0.0, 1.0.0.1, 1.0.0.2, …, 1.1.0.0), 문제가 될 수 있습니다. 크로스플레이 런처는 중간 버전들을 거치며 버전을 순차적으로 업데이트(예시: 1.0.0.01.0.0.11.0.0.2 → … → 1.1.0.0) 하기 때문에, 계속해서 패치 파일만으로 앱을 업데이트하면 앱을 처음 설치하거나 재설치 시 앱을 업데이트하는 데 많은 시간이 걸릴 수 있습니다.

패치 파일과 함께 앱 전체 파일을 업로드하면, 사용자는 앱을 재설치하여 앱을 업데이트합니다. 이 방식은 앱 전체 용량이 지나치게 크지 않고, 중간 버전들이 많을 때 사용할 수 있습니다. 이 경우, 사용자가 앱을 업데이트하는 데 걸리는 시간이 패치 파일만으로 앱을 업데이트하는 것보다 짧을 수 있습니다.

결국, 둘 중 어떤 방식을 선택할지는 앱 전체 파일 용량, 중간 버전 개수, 앱 패치 파일 용량 등을 고려하여 앱 설치와 업데이트 소요 시간을 확인한 후 개발사가 선택해야 합니다.

패치 파일 생성

두 방식 모두 먼저 패치 파일을 생성해야 합니다. 패치 메이커로 앱 기존 버전과 새로운 버전의 차이를 분석해 패치 파일들을 생성합니다. 그 후에 업로더로 패치 파일들을 Hive 서버에 업로드합니다. 새로운 버전 앱을 구성하는 전체 파일들 용량 총합은 디스크 할당 크기 기준으로 30GB 이하이어야 하며, 각 파일 용량은 4GB 이하이어야 합니다.

패치 메이커와 업로더는 각각 GUI와 CUI 두 종류가 있습니다. 개발 환경에 따라 두 방식 중 하나를 선택하여 사용하세요. 아래에서는, 어떤 게임 앱 버전을 업데이트하는 상황을 예시로 하여 GUI 또는 CUI 패치 메이커를 쓰는 방법을 안내합니다.

 

예시 상황

  • AppID: com.gcp2.stepbystep.windows.google.global.normal
  • 업로드할 Hive 콘솔 서버: LIVE
  • 이전 앱 버전: 1.0.0.0
  • 이전 버전 앱 위치: D:\myGame_v1_0_0_0
  • 최신 앱 버전: 1.0.0.1
  • 최신 앱 위치: D:\myGame_v1_0_0_1
  • 패치 파일을 생성할 위치: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1

선택 1: GUI로 패치 파일 생성

GUI 패치 메이커는 GUI 화면으로 패치 파일을 만듭니다.

 

  1. 크로스플레이 런처 도구를 다운로드하고 압축을 해제한 후 GUI/patch_maker/CrossplayLauncherPatchFileMaker.exe를 실행합니다.
  2. 패치 메이커 화면에서 다음과 같이 입력하고 Start를 누릅니다.
    • Previous Version Path: D:\myGame_v1_0_0_0
    • Current Version Path: D:\myGame_v1_0_0_1
    • Patch File Path: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1
    • Environment: 샌드박스 환경은 SANDBOX, 상용 환경은 LIVE(REAL)
    • APP ID: com.gcp2.stepbystep.windows.google.global.normal
    • Previous Version: 1.0.0.0

선택 2: CUI로 패치 파일 생성

  1. 크로스플레이 런처 도구를 다운로드하고 압축을 해제합니다.
  2. CUI/patch_maker/cpflPtc.exe과 동일한 경로에 Pre_Version_Folder 폴더와 Cur_Version_Folder 폴더를 생성하고, 여기에 각각 D:\myGame_v1_0_0_0D:\myGame_v1_0_0_1에 있는 파일들을 복사해 넣습니다.
  3. CUI/patch_maker/cpflPtc.exe를 Windows 터미널 또는 파워쉘에서 다음 명령줄 인수와 함께 실행합니다.

    • ‐‐prePath: D:\myGame_v1_0_0_0, 기본값은 Pre_Version_Foler
    • ‐‐nextPath: D:\myGame_v1_0_0_1, 기본값은 Cur_Version_Foler
    • ‐‐patchPath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1, 기본값은 Patch_Files_Folder
    • -envi: 샌드박스 환경은 SANDBOX, 상용 환경은 LIVE (1.0.0.0 버전 앱 파일을 업로드했던 환경과 동일해야 함)
    • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
    • ‐‐version: 이전 버전인 1.0.0.0을 입력
    • -runbatch: y (패치 과정에서 질문 프롬프트 스킵 여부)

생성한 패치 파일 확인

GUI 또는 CUI 패치 메이커로 생성한 패치 파일을 Patch_Files_Folder에서 확인합니다. 이전 버전과 새 버전에서 경로가 동일함에도 파일 데이터가 다르면 패치 파일을 생성합니다. 이전 버전에 없던 파일이 새 버전에 추가되면, Patch_Files_Folder 내에 있는 해당 파일 경로에 파일이 생성됩니다.

선택 1: 패치 파일만 업로드

생성한 패치 파일을 Hive 콘솔 샌드박스 서버 또는 Hive 콘솔 상용 서버에 업로드합니다. 업로더는 GUI와 CUI 두 종류가 있습니다. 개발 환경에 따라 두 방식 중 하나를 선택하여 패치 파일을 업로드하세요.

선택 1: GUI로 패치 파일을 업로드

GUI 업로더는 GUI 화면으로 업로드를 진행합니다.

 

 

  1. Hive 샌드박스 콘솔 또는 Hive 상용 콘솔 크로스플레이 런처 > 앱 관리 > 업로드 IP에서 게임과 AppID를 선택하고 앱 파일들을 업로드할 PC의 IP 주소를 대표 IP에 등록합니다.
  2. 크로스플레이 런처 도구를 다운로드하고 압축을 해제합니다.
  3. GUI/uploader/CrossplayLauncherFileUploader.exe를 실행합니다.
  4. 업로더 화면에서 다음과 같이 입력하고 Start를 누릅니다.
    • Upload Folder Path: D:\myGame_v1_0_0_1
    • Patch Folder Path: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1 (패치 메이커로 생성한 패치 파일들이 있는 경로)
    • Not first time upload: 체크
    • Environment: 샌드박스 환경은 SANDBOX, 상용 환경은 LIVE(REAL) (1.0.0.0 버전 앱 파일을 업로드했던 환경과 동일해야 함)
    • Platform: Windows
    • Is Release: N
    • APP ID: com.gcp2.stepbystep.windows.google.global.normal
    • App Version: 1.0.0.1
  5. 업로드가 잘 끝났다면 Processing 창에 상태코드값 201이 나타납니다.

선택 2: CUI로 패치 파일을 업로드

  1. Hive 샌드박스 콘솔 또는 Hive 상용 콘솔 크로스플레이 런처 > 앱 관리 > 업로드 IP에서 게임과 AppID를 선택하고 앱 파일들을 업로드할 PC의 IP 주소를 대표 IP에 등록합니다.
  2. 크로스플레이 런처 도구를 다운로드하고 압축을 해제합니다.
  3. CUI/uploader/cpflupl.exe를 Windows 터미널 또는 파워쉘에서 다음 명령줄 인수와 함께 실행합니다.

    • -envi: 샌드박스 환경은 SANDBOX, 상용 환경은 LIVE (1.0.0.0 버전 앱 파일을 업로드했던 환경과 동일해야 함)
    • ‐‐platform: w
    • ‐‐release: n
    • -notfirstupload: 해당됨(새 앱 업로드가 아닌 패치 파일만 업로드하는 경우)
    • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
    • ‐‐version: 1.0.0.1
    • ‐‐filepath: D:\myGame_v1_0_0_1
    • ‐‐filepatchpath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1, 기본값은 toUploadPatchFiles
    • -runbatch: 해당됨

  4. 업로드가 잘 끝났다면 터미널 또는 쉘에 상태코드값 201이 나타납니다.

 

선택 2: 패치 파일과 앱 전체 파일을 함께 업로드

생성한 패치 파일과 앱 전체 파일을 Hive 콘솔 샌드박스 서버 또는 Hive 콘솔 상용 서버에 업로드합니다. 업로더는 GUI와 CUI 두 종류가 있습니다. 개발 환경에 따라 두 방식 중 하나를 선택하여 패치 파일과 앱 전체 파일을 업로드하세요.

선택 1: GUI로 패치 파일과 앱 전체 파일을 업로드

GUI 업로더는 GUI 화면으로 업로드를 진행합니다.

 

 

  1. Hive 샌드박스 콘솔 또는 Hive 상용 콘솔 크로스플레이 런처 > 앱 관리 > 업로드 IP에서 게임과 AppID를 선택하고 앱 파일들을 업로드할 PC의 IP 주소를 대표 IP에 등록합니다.
  2. 크로스플레이 런처 도구를 다운로드하고 압축을 해제합니다.
  3. GUI/uploader/CrossplayLauncherFileUploader.exe를 실행합니다.
  4. 업로더 화면에서 다음과 같이 입력하고 Start를 누릅니다.
    • Upload Folder Path: D:\myGame_v1_0_0_1
    • Patch Folder Path: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1 (패치 메이커로 생성한 패치 파일들이 있는 경로)
    • Not first time upload: 체크
    • Environment: 샌드박스 환경은 SANDBOX, 상용 환경은 LIVE(REAL) (1.0.0.0 버전 앱 파일을 업로드했던 환경과 동일해야 함)
    • Platform: Windows
    • Is Release: Y
    • APP ID: com.gcp2.stepbystep.windows.google.global.normal
    • App Version: 1.0.0.1
  5. 업로드가 잘 끝났다면 Processing 창에 상태코드값 201이 나타납니다.

선택 2: CUI로 패치 파일과 앱 전체 파일을 업로드

  1. Hive 샌드박스 콘솔 또는 Hive 상용 콘솔 크로스플레이 런처 > 앱 관리 > 업로드 IP에서 게임과 AppID를 선택하고 앱 파일들을 업로드할 PC의 IP 주소를 대표 IP에 등록합니다.
  2. 크로스플레이 런처 도구를 다운로드하고 압축을 해제합니다.
  3. CUI/uploader/cpflupl.exe를 Windows 터미널 또는 파워쉘에서 다음 명령줄 인수와 함께 실행합니다.

    • -envi: 샌드박스 환경은 SANDBOX, 상용 환경은 LIVE (1.0.0.0 버전 앱 파일을 업로드했던 환경과 동일해야 함)
    • ‐‐platform: w
    • ‐‐release: y
    • -notfirstupload: 해당됨(새 앱 업로드가 아닌 패치 파일만 업로드하는 경우)
    • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
    • ‐‐version: 1.0.0.1
    • ‐‐filepath: D:\myGame_v1_0_0_1
    • ‐‐filepatchpath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1, 기본값은 toUploadPatchFiles
    • -runbatch: 해당됨

  4. 업로드가 잘 끝났다면 터미널 또는 쉘에 상태코드값 201이 나타납니다.

 

업로드 결과 확인

업로드가 끝나면, Hive 콘솔 > 크로스플레이 런처 > 앱 관리 > 다운로드 설정에서 앱을 잘 업로드했는지 확인합니다.