게임 런처용 PC 클라이언트 빌드 업로드

개요

이 가이드는 게임 런처를 통해 배포되는 클라이언트 파일을 업로드하는 방법과 관리 절차를 설명합니다.

효율적인 파일 배포와 무결성 검증을 위해 필요한 권장 사항과 필수 조건을 포함하고 있으며, 개발 환경(QA, STAGE, PROD) 및 배포 과정에서의 주의사항을 명시합니다. 이를 통해 안정적인 업데이트 및 설치 과정을 지원하고자 합니다.

파일 업로드 및 게임 실행 명세 가이드

1. 파일 업로드 방식

전체 클라이언트 파일 스냅샷 업로드

클라이언트 빌드 내용을 참고하셔서 전체 클라이언트 파일을 업로드 해 주셔야 합니다.

파일은 버전별 전체 파일 스냅샷 방식으로 관리됩니다.
최신 버전의 전체 파일을 한 번에 업로드하는 것을 권장합니다.
ZIP 으로 압축하지 않은 설치 경로 그대로의 파일을 업로드 해 주시는 걸 권장하며, 별도의 아카이빙 포멧은 사전 협의가 필요합니다.

변경 파일만 업로드

변경 점이 적은 경우 기술PM과 협의 후 변경된 파일만 업로드할 수 있습니다.
변경된 파일을 최신 빌드 스냅샷에 덮어쓰기(Overwrite)한 뒤 해당 스냅샷을 기준으로 배포 됩니다.

2. 환경 별 파일 그룹 관리

파일은 환경(QA, STAGE, PROD 등) 별로 구분하여 관리됩니다.
각 환경에 맞는 파일을 별도로 업로드해야 합니다. ( 클라이언트 빌드 내용 참고)

3. 무결성 검사

Checksum 업로드

업로드하는 파일의 무결성을 검증하기 위해 Checksum 모음 파일을 함께 업로드할 것을 권장합니다.
- 해당 Checksum은 유저 공개용 빌드 배포 전 빌드 업로드 과정에서의 무결성 체크 검증을 위해 사용합니다.
- 빌드 업로드 과정에서 플랫폼 내부 정책으로 일부 파일이 변경 될 수 있으며, 유저에게 공개되어 배포 되는 최종 Checksum은 플랫폼에서 별도로 생성합니다.

Checksum 생성 예시

PowerShell 스크립트:

# 디렉토리와 기준 경로를 설정
$baseDir = "C:\YourDirectory"

# 결과를 저장할 파일 설정
$outputFile = "C:\YourDirectory\checksums.json"

# 결과를 저장할 배열 생성
$result = @()

# 디렉토리 내 모든 파일 처리
Get-ChildItem -Path $baseDir -Recurse -File | ForEach-Object {
    $filePath = $_.FullName
    $hash = Get-FileHash -Path $filePath -Algorithm SHA256
    $relativePath = $filePath.Substring($baseDir.Length + 1) # 상대 경로 계산
    $result += [PSCustomObject]@{
        FileName = $_.Name
        RelativePath = $relativePath
        SHA256 = $hash.Hash
    }
}

# 결과를 JSON로 저장
$result | ConvertTo-Json | Out-File -FilePath $outputFile

Write-Output "Checksums saved to $outputFile"

실행 방법:

위 스크립트를 .ps1 파일로 저장 (예: GenerateChecksums.ps1).

PowerShell에서 실행:

powershell -ExecutionPolicy Bypass -File GenerateChecksums.ps1

결과가 지정한 checksums.json 파일에 저장됩니다.
빌드 업로드 시 checksums.json파일을 포함합니다.

유저 PC파일 업데이트 방식의 권장사항

클라이언트 파일 업로드 후, 유저 PC에 설치된 파일과의 Checksum 비교를 통해 업데이트 여부를 판단합니다.
배포 이후 실행 과정에서 파일이 변경되지 않도록 구성하는 것을 권장합니다.
Checksum이 달라도 업데이트하지 않아야 하는 파일이 있다면, 해당 파일 목록을 별도로 전달해야 합니다.

<파일 목록 신청 표 양식 예시>

파일명

파일 경로

설명

example.dll

\Game\

업데이트 제외 파일 예시

config.json

\Game\Config\

설정 파일 예시

\Game\Saved\

디랙토리 전체 제외 예시

4. 설치 및 실행 단계 예외 사항

설치 이후 추가 아카이빙 처리

설치 이후 압축 해제 등의 추가 아카이빙이 발생하는 경우, 해당 파일의 무결성 검사는 게임 내에서 직접 수행해야 합니다.

게임 실행 후 추가 다운로드 파일

게임 실행 이후 다운로드되는 파일(예: Asset Bundle, IFix, DLC 등)은 게임 내에서 무결성 검사를 직접 수행해야 합니다.

설치 과정 중 추가 요구 사항

설치 과정에서 Registry 수정이나 윈도우 방화벽 예외 추가 혹은 필수 라이브러리의 추가 설치가 필요한 경우, 해당 요구 사항을 사전에 별도로 요청 주셔야 합니다.
설치 과정에서 빌드에 포함되어 있는 Post Install Script 를 실행 해야 하는 경우 해당 Script 위치와 목적을 공유 주셔야 합니다.

게임 실행 경로와 인자

게임 실행 시 필요한 실행 경로와 Arguments를 사전에 공유해야 합니다.
- 실행 파일 경로 예시: bin\game.exe
- 인자 예시: -server [ServerName]
실행 시 추가적으로 필요한 사항은 반드시 공유 주셔야 합니다.
- 윈도우 설정이나 환경 변수 변경이 필요한 경우
- 실행 시 관리자 권한(Administrator)이 필요한 경우

5. 실행 파일의 보안 처리

실행 파일은 Code Signing 또는 보안 모듈 랩핑 등의 절차를 거칠 수 있습니다.
- 이로 인해 업로드된 파일과 유저에게 배포되는 파일이 다를 수 있습니다.
안티바이러스 소프트웨어의 오탐지 여부를 사전에 확인하는 절차가 있습니다.
- 주요 안티바이러스 소프트웨어에서 오탐 여부를 테스트하며, 필요한 경우 재 빌드나 화이트리스트 등록 과정에서의 업데이트 지연이 발생 될 수 있습니다.

추가 참고 사항

파일 업로드 시 환경별 디렉토리 구조를 명확히 구분하고, 각 환경의 요구 사항이 있는 경우 준수 하셔야 합니다.
무결성 검사를 위한 Checksum은 SHA-256 이상의 알고리즘을 권장합니다.
모든 파일 업로드 및 변경 사항은 로그를 기록하여 증적 관리합니다.

Previous빌드 업로드 Next보관

Last updated 6 months ago