콘텐츠로 이동

앱 패치 버전을 업로드

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

 

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

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

 

패치 파일만 업로드하면, 사용자는 패치 파일로만 앱을 업데이트합니다. 이 방식은 패치 파일 용량이 크지 않을 때에 사용할 수 있습니다. 단, 이 방식은 앱 최초 버전과 마지막 버전 사이에 중간 버전들이 많을 때(예시: 1.0.0.0, 1.0.0.1, 1.0.0.2, ..., 1.1.0.0), 문제가 될 수 있습니다. 크로스플레이 런처는 중간 버전들을 거치며 버전을 순차적으로 업데이트(예시: 1.0.0.0 → 1.0.0.1 → 1.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
Note

백신 프로그램을 사용 시 프로그램 설치 및 파일 변경 등을 감지하는 실시간 보호(혹은 감시) 기능으로 패치 파일 생성 중 오류가 발생할 수 있습니다. 패치 파일 생성 중 지속적으로 오류가 발생하면 백신 프로그램에서 패치 메이커를 신뢰할 수 있는 프로그램으로 등록하거나, 백신 프로그램을 종료한 후 시도하세요.


선택 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_0과 D:\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 (패치 과정에서 질문 프롬프트 스킵 여부)
    ‐‐prePath="D:\myGame_v1_0_0_0" \
‐‐nextPath="D:\myGame_v1_0_0_1" \
‐‐patchPath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
-envi="LIVE" \
-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이 나타납니다.czb


선택 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: 해당됨
    cpflupl.exe \
‐‐appid="com.gcp2.stepbystep.windows.google.global.normal" \
‐‐platform="w" \
--version="1.0.0.1" \
-envi="LIVE" \
‐‐filepath="D:\myGame_v1_0_0_1" \
‐‐filepatchpath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
-runbatch ‐‐notfirstupload ‐‐release="n"

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

Note

패치 파일을 업로드할 때, 직전에 배포한 버전과 현재 업로드할 버전(GUI에서 App Version, CUI에서 ‐‐version)이 동일하다면, 업로드가 실행되지 않습니다.


선택 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: 해당됨

    cpflupl.exe \
‐‐appid="com.gcp2.stepbystep.windows.google.global.normal" \
‐‐platform="w" \
--version="1.0.0.1" \
-envi="LIVE" \
--filepath="D:\myGame_v1_0_0_1" \
‐‐filepatchpath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
-runbatch --notfirstupload –release="n"
    4. 업로드가 잘 끝났다면 터미널 또는 쉘에 상태코드값 201이 나타납니다.

Note

패치 파일을 업로드할 때, 직전에 배포한 버전과 현재 업로드할 버전(GUI에서 App Version, CUI에서 ‐‐version)이 동일하다면, 업로드가 실행되지 않습니다.

 

업로드 결과 확인

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