Game > Launching > 콘솔 사용 가이드

Launching 데이터 관리

모바일 앱에서 사용할 Launching 데이터 설정 방법은 다음과 같습니다.

설정정보

Console 화면의 설정정보 탭에서 현재 Launching 정보를 조회 할 수 있습니다.

launching_01_201812

[참고] Launching 서비스를 사용하면 위 그림과 같이 기본으로 템플릿 데이터를 제공합니다. (실제 템플릿 데이터는 그림과는 다를 수 있습니다.)

폴더 및 키 선택 및 변경

Launching 정보의 좌측 탐색 창에서 폴더 및 키를 선택하면 우측에 해당 폴더/키의 정보가 출력이 되고, 선택된 폴더 및 키의 이름 및 설명을 변경 한 후, 확인 버튼을 클릭하면 해당 정보가 변경 됩니다. launching_02_201812

[참고] 확인 버튼은 Console 내부적으로 변경 사항을 반영한 것으로, 수정된 사항을 서버에 반영 하려면 배포 탭에서 배포를 하셔야 합니다.

[참고] 서로 다른 폴더에 속하는 키는 동일한 키 이름을 가질 수 있지만, 하나의 폴더에 속하는 키들은 동일한 이름을 가질 수 없습니다. 즉, server 폴더 하단에 'ip'라는 키는 하나만 존재 가능하지만, client 라는 또 다른 폴더에 'ip'라는 키는 가질 수 있습니다.

키 형식 변경

키를 선택하면 나타나는 우측의 키 정보에서 형식을 변경할 수 있습니다. 배열 형식으로 변경하면 해당 키에서 원하는 문자열 형식의 값을 추가하거나 삭제할 수 있습니다.

launching_03_201812

폴더 및 키 작업

추가

Launching 정보의 좌측 탐색 창에서 폴더를 선택한 후 마우스 우클릭을 하면 나타나는 메뉴를 통해 폴더 및 키를 추가하거나, 좌측 탐색 창 위의 폴더 추가/키 추가 버튼을 통해 폴더 및 키를 추가할 수 있습니다.

launching_04_201812

복사, 붙여넣기 및 삭제

Launching 정보의 좌측 탐색창에서 폴더 또는 키를 선택한 후 나타나는 메뉴에서 복사/삭제/붙여넣기 버튼을 통해 여러 작업을 진행할 수 있습니다.

launching_05_201812

[참고] 폴더를 삭제하면 해당 폴더에 속한 모든 하위 폴더 및 키를 삭제 합니다.

로직

로직 탭을 누르면, 등록된 Launching 정보를 변경하기 위한 서버 로직 정보를 확인할 수 있습니다. 로직은 고정된 Launching 정보를 동적으로 변경하기 위한 비즈니스 로직을 의미하며, 서버에서 구동되기 때문에 모바일 앱의 업데이트 없이 변경된 Launching 정보를 얻을 수 있게 합니다.

launching_06_201812

로직 추가

서버 로직을 추가하기 위해서는 로직이 동작하는 시작 시각 및 종료 시각, 로직이 적용되는 조건 및 결과를 입력해야 합니다.

조건에는 최종 결과가 Boolean 인 Javascript 의 조건문을 사용할 수 있습니다. 서버에 등록된 Launching 정보 및 Launching 조회 API의 GET 파라미터 값을 일반 변수로 취급하여 사용할 수 있습니다. Launching 정보는 [launching.{folder}.{key}] 형식으로 사용할 수 있으며, 그 외에는 전부 일반 변수로 인식합니다.

결과는 로직의 조건이 맞을 경우, Launching 정보를 변경하는 설정으로, [launching.{folder}.{key}] 형식으로 사용 할 수 있습니다.

적용 기간을 통해 해당 로직이 적용될 시간을 설정할 수 있으며, 종료 시간을 설정하지 않고 로직에 계속 적용되게 할 수도 있습니다.

launching_07_201812

[참고] Launching 정보에서 결과로 지정한 키가 존재 하지 않으면 새롭게 추가하고, 아니면 기존 정보를 덮어 쓰게 됩니다.

[주의] 로직의 조건은 최대 1KB 를 넘길 수 없습니다. 또한 로직의 결과는 하나 이상 등록해야 하며, 로직 결과에서 설정하는 키와 결과 값은 최대 255 Bytes 를 넘길 수 없습니다.

로직 수정

등록된 로직을 클릭하면 해당 로직을 수정 할 수 있습니다.

launching_08_201812

로직 실행 / 정지

로직 목록에서 정지시키거나 실행 할 로직의 체크박스를 클릭하여 선택한 후, 상단의 실행 / 정지 버튼을 눌러 로직의 상태를 변경할 수 있습니다. 정지 상태의 로직은 Launching 정보를 수정하지 않습니다.

로직 삭제

로직 목록에서 삭제할 로직의 체크박스를 클릭하여 선택한 후, 상단의 삭제 버튼을 눌러 로직을 삭제할 수 있습니다.

[주의] 로직 실행 / 정지를 포함한 모든 변경 사항을 서버에 반영 하려면 배포 탭에서 배포를 하셔야 합니다.

로직 테스트

Launching 정보를 서버에 배포하기 전에 로직을 테스트 할 수 있습니다. Launching 정보를 호출 할 때 넘겨줄 GET 파라미터와 로직의 적용 시각을 설정 후 로직 테스트 버튼을 누르면 하단에 로직이 적용된 Launching 정보를 미리 확인 할 수 있습니다.

여러 개의 파라미터를 넘겨주는 것을 테스트 하기 위해 파라미터 가장 우측의 + 버튼을 클릭하면 새로운 파라미터를 등록할 수 있습니다.

launching_09_201812

예를 들어, 그림과 같이 로직을 등록한 후 테스트를 진행하면 로직결과에서 테스트 결과를 확인 할 수 있습니다.

로직의 조건으로 파라미터 'launching.server.cds' 의 값이 'TEST' 일 경우 [lauching.server.ip] 의 값에 '127.0.0.1' 를 넣도록 설정하였고, 로직 테스트시 GET 파라미터로 'launching.server.cds'에 TEST를 설정하였기 때문에 테스트 결과에서 [lauching.server.ip] 에 '127.0.0.1' 값이 들어간 것을 확인 할 수 있습니다.

[참고] 로직 테스트 결과에서 노란색 음영이 처리된 부분은 실제 원본 Launching 정보에서 로직 및 GET 파라미터를 통해 연산하여 추가 / 변경된 키를 의미합니다.

서브 키

서브 키를 통해 Launching 정보에서 일부 데이터만을 받을 수 있습니다. 서브 키는 "launching." 으로 시작하고, "." 로 조합되는 키로 이 키를 통해 전체 Launching 정보에서 일부 데이터를 받습니다.

다음 그림과 같이 서브 키를 [launching.server]로 지정하면 [launching.server] 에 있는 데이터만을 가져올 수 있습니다.

launching_10_201812

[주의] 그림에서 볼 수 있는 것처럼, 서브 키도 GET 파라미터를 통해 지정합니다. "subKey"를 키로 설정한 GET 파라미터는 서브 키로 인식합니다.

키 패턴

키 패턴은 "$." 로 시작하는 특수한 키로, 로직 조건 및 결과에서 사용할 수 있습니다. 전체 또는 서브 키를 통해 받아오는 최종 결과인 Launching 정보의 루트에서 상대적인 위치를 지정합니다.

다음 그림과 같이 로직이 등록되어 있다고 가정하겠습니다.

launching_11_201812

이러한 경우 서브 키를 지정하지 않은 경우 로직이 적용되지 않습니다.

그러나 서브 키를 [launching.server] 를 지정하여 일부 데이터만을 가져올 경우, 로직 조건 "$.cds === 'TEST'"이 만족하게 되어, "$.ip = '127.0.0.1'" 에 의해 값이 변경됩니다.

launching_12_201812

이 처럼 서브 키 및 키 패턴을 통해 Launching 정보를 유동적으로 변경할 수 있습니다.

Import

Import 탭에서 다른 프로젝트의 Launching 서비스에 등록된 Launching 정보 및 로직을 Import 하거나 Export 탭의 Json 형식으로 복사하기 메뉴를 통해 복사한 Json 형식의 데이터로부터 가져올 수 있습니다.

다른 프로젝트를 선택 후, Start Import 버튼을 통해 Launching 정보 및 로직을 Import 할 수 있습니다.

Json 형식으로부터 로드 메뉴에서 Json 형식의 데이터로부터 Launching 정보 및 로직을 가져올 수도 있습니다.

[참고] Import를 진행 한 후 Launching 정보 및 로직들을 설정정보 / 로직 탭에서 확인 및 테스트를 진행할 수 있습니다. Import를 진행하면 배포 탭에서 배포를 진행하셔야 서버에 반영됩니다.

Export

Export 탭에서 다른 프로젝트의 Launching 서비스로 Launching 정보 및 로직을 Export 하거나, Json 형식의 데이터로 복사할 수 있습니다.

다른 프로젝트를 선택 후, Start Export 버튼을 통해 Launching 정보 및 로직을 Export 할 수 있습니다.

Json 형식으로 복사하기 메뉴에서 Json 형식의 데이터를 복사할 수 있습니다.

배포

설정정보로직 탭에서 수정한 사항을 서버에 반영하기 위해서는 배포 탭에서 배포를 진행해야 합니다. 배포 탭에서는 배포하기 전 그림과 같이 Launching 정보 및 로직, 설명의 수정 사항을 확인할 수 있습니다.

launching_13_201812

배포 버튼을 통해 배포를 진행하면 서버에 반영되어 모바일 앱에서 변경된 Launching 정보를 가져가게 됩니다. 초기화 버튼을 통해 Console 에서 수정한 내역을 다시 되돌릴 수 있습니다.

배포를 진행하게 되면 Console 에서 수정하기 직전의 Launching 정보 및 로직들을 백업하게 됩니다. 이를 위해 배포 버튼을 클릭시 백업할 이름을 요구합니다.

백업 내역 확인

하단 백업 내역에서 현재까지 백업이 진행된 내역을 확인할 수 있습니다.

설정정보 / 로직 확인 버튼을 통해 백업된 Launching 정보 및 로직들을 확인할 수 있고, 복원 및 삭제를 진행할 수 있습니다.