새로운 셸 스크립트로 내보내기

February 15th, 2024

Spine 내보내기 프로세스 간소화

새로운 쉘 스크립트를 사용하여 모든 프로젝트를 한 번에 내보낼 수 있습니다! 스크립트는 .spine 프로젝트 파일을 검색하고 찾은 각 프로젝트를 내보냅니다. 각 프로젝트는 프로젝트 파일 옆에 내보내기 설정 파일을 배치하여 다른 내보내기 설정을 사용할 수 있습니다. 스크립트를 사용하여 내보내면 다음과 같은 많은 이점이 있습니다.

  • 원하는 만큼의 프로젝트 파일을 한 번에 내보낼 수 있습니다.
  • 내보내기에서는 항상 올바른 설정을 사용합니다. 매번 올바른 설정을 사용하기 위해 애니메이터에게 의존할 필요가 없습니다.
  • 소프트웨어의 빌드 프로세스에서 내보내기 스크립트를 실행하여 모든 빌드에 항상 최신 내보내기 파일이 포함되도록 할 수 있습니다. 애니메이터는 프로젝트 파일을 변경할 때마다 내보내기를 수행하는 것을 기억할 필요가 없습니다.
  • 최신 Spine 버전으로 업데이트하는 경우 모든 프로젝트를 다시 내보내야 합니다. 내보내기 스크립트가 설정되어 있으면 이 작업은 매우 쉽습니다!

시작하기

다음은 스크립트 사용 방법을 보여주는 동영상입니다. 또는 본문의 단계별 설명을 계속 읽어보세요.


내보내기 스크립트 다운로드

운영 체제에 맞는 다음의 스크립트를 다운로드합니다.

spine-scripts GitHub 저장소에서 스크립트에 대한 자세한 내용을 확인할 수 있습니다.

스크립트 구성

텍스트 편집기로 스크립트를 열면 상단에 Customization Section (사용자 지정 섹션)이 있습니다. 다음은 spine-export.bat에서 발췌한 내용입니다(spine-export.sh는 매우 유사합니다).

스크립트를 실행하기 전에 다음의 3가지 설정을 먼저 검토해야 합니다.

  1. SPINE_EXE Spine 실행 파일의 경로입니다. 여기에서 Spine을 찾을 수 없는 경우 스크립트는 다른 일반적인 설치 위치를 찾습니다.

  2. VERSION 내보내기를 수행하는 데 사용할 Spine 편집기의 버전입니다. Spine 편집기와 런타임 버전을 동일하게 유지하는 것은 매우 중요합니다.

  3. DEFAULT_EXPORT 스크립트는 Spine 프로젝트와 동일한 폴더에서 내보내기 설정 JSON 파일을 찾습니다. 해당 파일을 찾을 수 없는 경우 여기에 지정된 내보내기 설정이 사용됩니다. 다음의 일반적인 기본 설정에 대한 4가지 단축키가 있습니다: json, json+pack, binary 또는 binary+pack. 또는 내보내기 설정 파일의 경로를 지정할 수도 있습니다(이에 대한 자세한 내용은 아래 참조).

스크립트 실행

Windows

Windows에서는 스크립트를 실행하는 다음의 몇 가지 방법이 있습니다.

  1. spine-export.bat 파일에 폴더를 끌어서 놓습니다.
  2. spine-export.bat 파일을 두 번 클릭하여 CMD 창을 연 다음 경로를 입력하거나 붙여 넣거나, 또는 폴더를 CMD 창으로 끌어서 놓습니다.
  3. CMD 프롬프트에서 spine-export.bat 파일을 실행한 다음 경로를 입력하거나 붙여 넣거나, 또는 폴더를 CMD 창으로 끌어서 놓습니다.
  4. 경로를 첫 번째 매개변수로 사용하여 CMD 프롬프트에서 spine-export.bat 파일을 실행합니다.
spine-export.bat path\to\spine\project\folder

스크립트는 지정된 폴더와 모든 하위 폴더를 검색합니다. .spine 파일을 찾으면 내보내기를 수행합니다.


macOS 또는 Linux

macOS 또는 Linux에서는 spine-export.sh를 실행하기 전에 먼저 macOS 또는 Linux에 실행 권한을 부여해야 합니다. 터미널을 열고 스크립트가 있는 디렉터리로 이동한 다음 아래 명령을 사용하여 실행 권한을 부여합니다.

chmod +x spine-export.sh

스크립트를 실행하려면 ./spine-export.sh와 내보내려는 Spine 프로젝트가 포함된 디렉터리 경로를 지정합니다. 예를 들면:

./spine-export.sh /path/to/spine/projects/directory/

스크립트를 실행할 때 경로를 지정하지 않으면 스크립트는 경로를 입력하라는 메시지를 표시됩니다.

스크립트는 지정된 디렉터리와 모든 하위 디렉터리를 검색합니다. .spine 파일을 찾으면 내보내기를 수행합니다.


설정 내보내기

자세한 내보내기 설정을 지정하려면 내보내기 설정 JSON 파일을 준비해야 합니다.

내보내기 설정 저장

Spine 편집기의 내보내기 대화 상자에는 현재 내보내기 설정을 JSON 파일로 저장하는 Save (저장) 버튼이 왼쪽 하단에 있습니다.

저장된 내보내기 설정 파일의 확장자는 ".export.json"입니다.

내보내기 설정에서 Pack (패킹)을 선택한 경우에는 텍스처 패커 설정도 .export.json 파일에 저장됩니다.


기본 내보내기 설정

텍스트 편집기로 스크립트 파일을 열고 DEFAULT_EXPORT 값을 .export.json 파일의 경로로 변경합니다. 예를 들면:

DEFAULT_EXPORT=/path/to/default.export.json

이 설정은 프로젝트 파일 옆에 .export.json 파일이 없는 경우에 사용됩니다.

내보낸 파일은 기본 .export.json 파일의 출력 경로가 아닌 Customization Section (사용자 지정 섹션)의 DEFAULT_OUTPUT_DIR을 사용하여 출력됩니다.

프로젝트별 설정 내보내기

다른 설정으로 Spine 프로젝트를 내보내려면 설정이 포함된 .export.json 파일을 준비하여 Spine 프로젝트와 동일한 폴더에 해당 파일을 저장합니다. 예를 들어 파일 시스템 계층 구조는 다음과 같을 수 있습니다.

<스크립트 실행 시 경로를 지정하는 폴더>
      ├── 01
      │ ├── skeleton1.spine
      │ ├── skeleton1.export.json
      │ ├── images
      ├── 02
      │ ├── skeleton2.spine
      │ ├── skeleton2.export.json
      │ ├── images
      └── 03
         ├── skeleton3.spine
         ├── skeleton3.export.json
         └── images

.export.json 파일 이름은 프로젝트 파일 이름과 일치하지 않아도 됩니다.

동일한 프로젝트에 대해 여러 번 내보내기

다른 내보내기 설정으로 프로젝트를 여러 번 내보내려면 해당 수만큼의 .export.json 파일을 준비하여 포함시킵니다. 예를 들어 스켈레톤 데이터를 바이너리 형식과 PNG 시퀀스로 모두 내보내려면 파일 시스템 계층 구조는 다음과 같을 수 있습니다.

<스크립트 실행 시 경로를 지정하는 폴더>
      ├── 01
      │ ├── skeleton1.spine
      │ ├── skeleton1_Binary.export.json
      │ ├── skeleton1_PNG.export.json
      │ ├── images
      ├── 02
      │ ├── skeleton2.spine
      │ ├── skeleton2_Binary.export.json
      │ ├── skeleton2_PNG.export.json
      │ ├── images
      └── 03
         ├── skeleton3.spine
         ├── skeleton3_Binary.export.json
         ├── skeleton3_PNG.export.json
         └── images

기본 설정과 사용자 지정 설정 믹싱

동일한 폴더에 .export.json 파일이 없는 프로젝트 파일은 다음의 기본 설정으로 내보내집니다.

<스크립트 실행 시 경로를 지정하는 폴더>
      ├── 01
      │ ├── skeleton1.spine
      │ ├── skeleton1_Binary.export.json
      │ ├── skeleton1_PNG.export.json
      │ ├── images
      ├── 02
      │ ├── skeleton2.spine <이 스켈레톤은 기본 형식으로 내보내집니다>
      │ ├── images
      └── 03
         ├── skeleton3.spine
         ├── skeleton3_Binary.export.json
         ├── skeleton3_PNG.export.json
         └── images

스크립트 수정

Spine의 명령줄 인터페이스를 사용하여 직접 스크립트를 작성하거나 필요에 맞게 당사의 스크립트를 수정하여도 됩니다. 스크립트의 모든 기능을 설명하기 위해 스크립트에 주석을 추가했으며, README 파일에서 스크립트 작동 방식에 대한 더 자세한 내용을 확인할 수 있습니다.


이 튜토리얼이 도움이 되었나요? Spine 포럼에서 여러분의 피드백을 듣고 싶습니다!