# SDK 개발환경 준비하기

# SDK 개발환경 준비란?

STOVE PC SDK를 사용하기 위해 STOVE Studio 콘솔에 테스트와 판매 목적의 게임을 사전에 등록하는 과정을 의미합니다. STOVE Studio 콘솔에 게임을 등록하기 위한 과정을 요약하면 아래와 같습니다.

fig1

# 1. STOVE Studio 입점신청하기

(1) STOVE Studio (opens new window)에서 이메일로 스토브 회원가입 및 계정생성
(2) STOVE Studio에서 "Studio 시작하기" 선택
(3) "입점 신청하기" 선택 후, 약관동의 및 팀 정보 등록
(4) 입점신청 완료

# 2. STOVE Studio 프로젝트 등록하기

(1) STOVE Studio 입점신청이 완료된 후
(2) STOVE Studio 콘솔화면에서 "프로젝트 등록" 선택
(3) 프로젝트 등록 팝업창에 프로젝트명, 프로젝트ID, 게임ID 입력 후 "등록"

fig2

(4) 등록완료된 프로젝트에서 아래 값을 미리 확인

게임ID, Application Key, Application Secret

(5) 이후 따라하기 예제의 SDK 연동 코드에서 위 4번 그림에 표시된 인증키 값을 입력

# 3. STOVE 런처 설정

# 기존 클라이언트(런처 v2)

1. 다음 링크에서 PC 클라이언트 다운로드 (opens new window)에서 STOVE 런처를 다운로드합니다.

STOVE 런처가 설치된 폴더에 PolicyConfig.json 파일을 생성

기본 설치위치 : C:\Program Files (x86)\Smilegate\STOVE

PolicyConfig.json 파일에 아래 내용을 입력하고 STOVE Studio 프로젝트 등록시에 생성

SDK 연동 중에는 STOVE 런처를 실행해야 합니다.

아래와 같은 구조로 PolicyConfig.json을 생성한 후 C:\Program Files (x86)\Smilegate\STOVE 폴더에 덮어씁니다. STOVE Studio (opens new window) (opens new window)의 프로젝트 관리 메뉴에서 Game ID를 확인한 후 교체합니다.

{
  "skip_check_game_list":
  [
    "id_hellostove"
  ]
}

1
2
3
4
5
6

"id_hellostove"는 STOVE Studio에 등록한 gameID로 변경

STOVE 런처를 실행하고 STOVE Studio에 가입한 스토브ID로 로그인합니다.

# New 클라이언트(런처 v3)

# A. 사전준비

빌드테스트를 진행하기 전에 미리 준비해야 되는 내용을 설명합니다.

# 1. STOVE Studio 가입 및 프로젝트 등록

STOVE에 가입된 계정으로 스튜디오에 접속하여 스토어 개발자로 등록을 합니다.
스튜디오 화면에서 "Studio에서 출시하기"메뉴를 통해 새 프로젝트를 등록합니다.
새 프로젝트로 등록하면 프로젝트 화면에서 “게임ID”, "Application Key"값을 확인할 수 있고 PC SDK 연동 시에 필요한 프로젝트 정보를 획득하게 됩니다.

# 2. 게임빌드에 PC SDK 연동 완료

게임빌드에 PC SDK가 연동되어 있어야 하며, SDK연동 시에 스튜디오의 프로젝트 정보(게임ID, Application Key)가 정확하게 포함되어 있어야 합니다.

프로젝트 정보를 정확하게 입력하지 않으면 빌드테스트가 진행되지 않습니다.

# 3. New 클라이언트 다운로드

STOVE 스토어 상단 메뉴(GNB)를 통해 New 클라이언트 (opens new window)를 다운로드 받아 테스트할 PC에 설치합니다.

# B. 개발자모드 활성화 하기

개발자모드 활성화는 New클라이언트가 로컬PC에서 실행되는 (PC SDK와 연동되어 있는)게임빌드를 인식할 수 있도록 하는 작업입니다.

# 1. 개발자모드 설정파일 생성

New 클라이언트의 개발자모드를 활성화하기 위해 설정파일은 policyconfig.json이름으로 생성해야 합니다. 파일명이 정확하지 않으면 New 클라이언트에서 설정파일을 인식하지 못합니다.
C:\Users\%username%\AppData\Local\STOVE\Config로 이동하고 policyconfig.json파일을 생성합니다.

경로 :  ...\AppData\Local\STOVE\Config\PolicyConfig.json

# 2. 설정내용 입력하기

New 클라이언트의 개발자모드를 활성화하기 위한 마지막 단계는 하단 박스와 같이 설정 내용을 작성해야 합니다.

경고

스토브 런처가 켜져 있으면 작성 후 꼭 스토브 런처를 재시작해야 합니다.

스튜디오에 등록된 게임ID를 dev_game_list안에 여러개 기입이 가능하고, 기입된 게임ID와 일치하는 게임빌드는 New 클라이언트와 개발자모드로 통신하며 로컬PC에서 빌드테스트가 가능하게 됩니다.

PolicyConfig.json
{
  "stove_launcher_policy_config":
  {
    "dev_game_list": [ "게임ID", "게임ID", .... ]
  }
}

1
2
3
4
5
6
7

New 클라이언트의 개발자모드가 활성화되지 않는 경우, policyconfig.json파일의 위치가 올바른지 확인하고, policyconfig.json에 기입된 게임ID가 스튜디오의 등록된 게임ID하고 정확하게 일치하는지 체크해주시기 바랍니다.

# C. 빌드테스트 진행하기

앞서 설명한 과정을 통해 New 클라이언트의 개발자모드를 활성화 시켰기 때문에 어려운 과정은 모두 완료되었고, New 클라이언트가 실행 중인 상태에서 PC SDK가 연동된 게임빌드를 실행만 하면 빌드테스트가 가능해집니다.

빌드테스트는 exe파일을 직접 실행하거나, 개발툴(Visual Studio, Unity, Unreal 등)의 디버그 모드에서 모두 동작하기 때문에 편리하게 빌드테스트를 진행하여 디버깅 과정을 수행할 수 있습니다.

IAP SDK와 연동된 게임빌드에서 테스트 결제가 필요한 경우 위 방법으로는 지원하지 않습니다. 테스트 결제를 수행하기 위해서는 반드시 빌드를 스튜디오에 업로드하고 New 클라이언트의 스튜디오 테스트 메뉴로 진입한 뒤에 테스트 결제를 시도해주시기 바랍니다.

# 따라하기 실습

위의 모든 준비를 마쳤으면, 각 게임엔진별 따라하기 설명을 통해 기본적인 SDK 연동 흐름을 파악할 수 있습니다.

← STOVE PC SDK소개 따라하기-Unity →