Unity 에디터와 연동

필수 조건

프로젝트 연결

1. Unity 에디터에서 Edit > Project Settings > Services를 선택합니다.
2. 프로젝트를 연결합니다.
   • 프로젝트에 Unity 프로젝트 ID가 없는 경우 다음 단계를 진행합니다.
     1. Create a Unity Project ID > Organizations를 선택한 다음 드롭다운 메뉴에서 조직을 선택합니다.
     2. Create project ID를 선택합니다.
   • Unity 프로젝트 ID가 있는 경우 다음 단계를 진행합니다.
     1. Use an existing Unity project ID를 선택합니다.
     2. 드롭다운 메뉴에서 조직과 프로젝트를 선택합니다.
     3. Link project ID를 선택합니다.

UnityEditor.CloudProjectSettings.projectId

필수 패키지 설치

• Deployment
• Cloud Code(2.1.1 이상)

1. Unity 에디터의 Package Manager 창에서 + (add) > Add package by name... 을 선택합니다.

2. com.unity.services.deployment

   를 입력합니다.
3. Add를 선택합니다.

4. com.unity.services.cloudcode

   에도 같은 단계를 반복합니다.

Unity 에디터에서 저작

스크립트 생성

1. Unity 에디터에서 프로젝트 창을 오른쪽 클릭한 다음, Create > Services > Cloud Code Js Script를 선택합니다.
2. C# 스크립트에서와 마찬가지로 스크립트 이름을 지정합니다. Cloud Code 스크립트는 서비스에 업로드할 때 해당 파일 이름을 식별자로 사용합니다.
3. Enter 키를 누릅니다.

스크립트 편집

• 프로젝트 탭에서 기존 스크립트를 더블 클릭합니다.
• Deployment 창에서 기존 스크립트를 찾아 오른쪽 클릭한 다음, 표시되는 메뉴에서 Open을 선택합니다.

1. Unity 에디터에서 Edit > Preferences... > Cloud Code를 선택합니다.
2. Javascript Editor 섹션에서 원하는 JS 에디터의 애플리케이션 경로를 선택합니다.
3. Apply를 선택합니다.

• $(File)

  : 에셋의 파일 경로

• $(ProjectPath)

  : 프로젝트 디렉토리

• $(SolutionPath)

  : 솔루션 경로

• $(EditorExePath)

  : 에디터 실행 경로(Unity 에디터에서 Edit > Preferences... > External Tools를 선택하여 결정)

• JetBrains Rider(Windows):
  • 애플리케이션:

    cmd.exe

  • 인자:

    /C "$(EditorExePath) $(ProjectPath) $(File)"

• Microsoft Visual Studio Code:
  • 애플리케이션:

    Code.exe

  • 인자:

    $(ProjectPath) $(File)"

스크립트 배포

스크립트 파라미터 수정

에디터 인스펙터 창에서 파라미터 액세스

• 문자열
• 부울
• 숫자
• JSON
• 모두

스크립트 본문에서 파라미터 선언

params

module.exports

module.exports.params = { "echo" : "Boolean" }

type

required

module.exports = async ({ params, context, logger }) => {    return {        "value": params["aParam"]    };};module.exports.params = { "aParam" : { "type": "String", "required": true } }

module.exports = async ({ params, context, logger }) => {    var value = params["echo"] ? params["aParam"] : "default";    return {        "value": value    };};module.exports.params = {  "echo" : "Boolean",  "aParam" : { "type": "String", "required": true } }

JS 번들

import

require

bundling

module.exports.bundling = true;

module.exports.helloWorld = "Hello world!";

const lib = require("./lib");module.exports = async ({ params, context, logger }) => {    return {        "value": lib.helloWorld    };};module.exports.bundling = true;

Deployment 창

Unity 에디터에서의 Cloud Code JavaScript 프로젝트

Assets

CloudCode

cloud_script.js

node_modules

package.json

package-lock.json

package.json

package.json

package-lock.json

NodeJS

자동 완성

.d.ts

.d.ts

node_modules

package.json

node_modules

외부 툴

npm install ...

ESLint

1. npm i -D eslint

   를 실행합니다. 이 커맨드는 프로젝트 종속성에 ESLint를 추가합니다.
2. 프로젝트 루트에 다음을 포함하는

   .eslint.json

   파일을 생성합니다. JSON

   {    "env": {    "commonjs": true,    "es2021": true    },    "extends": "eslint:recommended",    "parserOptions": {    "ecmaVersion": 13    },    "rules": {    }}

3. ESLint를 실행하도록 IDE를 구성합니다. Visual Studio Code의 경우 자동으로 설정되지만, IDE에 따라 추가 설정이 필요할 수 있습니다.
4. 이제 ESLint가 구성되어 작동합니다.

eslint:recommended

if (something == -0)

Jest

1. npm install --save-dev jest

   를 실행합니다. 이 커맨드는 Jest 패키지를 설치합니다.

2. .es10

   스크립트로 실행되도록 Jest를 구성합니다.
3. 다음 코드 스니핏을

   package.json

   에 추가합니다. JSON

   "jest": {    "moduleFileExtensions": ["es10", "js"],    "testMatch": ["**/*.test.es10"]}

moduleFileExtensions

js

es10

testMatch

.test.es10

유닛 테스트 예시

테스트 대상 스크립트

module.exports = async ({ params, context, logger }) => {    return {value: "1"};};

테스트 스크립트

const test = require("./jest_01.es10")it("test",async () =>{    expect(await test({})).toMatchObject({value:"1"});});

테스트 진행

npm run test