에셋 이주하기

프로젝트 간에 에셋을 복사하는 방법

Choose your operating system:

Windows

macOS

Linux

여러 프로젝트에서 같은 에셋을 이용하려면 이주 툴(Migrate Tool) 을 사용하여 에셋을 관련 레퍼런스 및 종속성과 함께 복사하면 됩니다. 예를 들어 하나의 머티리얼을 이주할 때는 해당 머티리얼에서 사용하는 모든 텍스처 에셋도 함께 자동으로 복사됩니다. 이는 프로젝트를 병합하거나 분할해야 하거나, 테스트 환경에서 제작 프로젝트로 전환할 때 유용한 툴입니다.

이주 툴을 사용하는 방법은 다음과 같습니다.

  1. 콘텐츠 브라우저(Content Browser) 에서 이주하려는 에셋을 원하는 만큼 선택합니다.

    • 에셋을 여러 개 선택하려면 Ctrl 키를 누른 상태에서 선택하려는 각 에셋을 좌클릭 합니다.

    • 특정 범위의 에셋을 모두 선택하려면 첫 에셋을 좌클릭 한 후 Shift 키를 누른 상태에서 마지막 에셋을 좌클릭 합니다. 이렇게 하면 범위 내의 모든 에셋을 선택할 수 있습니다.

    콘텐츠 브라우저에서 이주할 에셋 선택하기

    이 예시에서는 네 개의 머티리얼 에셋을 선택했습니다.

  2. 선택한 에셋 중에서 아무거나 우클릭 합니다. 컨텍스트 메뉴가 나타나면 에셋 액션(Asset Actions) > 이주(Migrate) 를 선택합니다.

    이렇게 하면 에셋 리포트(Asset Report) 창이 열리면서 이주 과정에서 복사될 에셋이 모두 표시됩니다.

    에셋 리포트 창

    이주하지 않을 에셋이 목록에 있다면 해당 에셋 옆의 체크박스를 해제합니다. 단, 체크박스를 해제하면 이주하려는 다른 에셋이 손상될 수 있다는 점에 유의하세요. 예를 들어 텍스처 하나가 빠진 머티리얼은 더 이상 제대로 표시되지 않습니다.

  3. 확인(OK) 을 클릭하여 에셋 이주를 확인합니다. 이렇게 하면 파일 브라우저 창이 열리면서 에셋을 이주할 프로젝트(타깃 프로젝트)를 선택할 수 있게 됩니다.

    대상 폴더 선택하기

    타깃 프로젝트의 Content 폴더를 선택하고 폴더 선택(Select Folder) 버튼을 클릭합니다.

  4. 이주를 확인하면 이주 진행률을 트래킹하는 프로그레스 바가 나타납니다.

    이주하려는 에셋과 이름이 같은 에셋이 타깃 프로젝트의 Content 폴더에 있으면 다음과 같은 경고가 표시됩니다.

    (위치)에 이미 에셋이 있습니다. 덮어쓸까요? (location), would you like to overwrite it?](asset-migration-warning.png)

    예(Yes) 를 클릭하여 해당 에셋을 덮어쓰거나 아니요(No) 를 클릭하여 해당 에셋을 건너뛰고 이주 작업을 계속합니다. 관련 결정을 모든 에셋에 적용하려면 모두 예(Yes All) 또는 모두 아니요(No All) 를 클릭하면 됩니다.

  5. 이주가 완료되면 모든 에셋이 이주되었음을 확인하는 대화창이 나타납니다. 이 대화창에서 메시지 로그 표시(Show Message Log) 를 클릭하면 이주된 에셋을 모두 볼 수 있습니다.

    이주된 에셋 목록

에셋 이주 문제 해결하기

언리얼 프로젝트의 Content 폴더가 아닌 곳에 에셋을 이주하려고 하면 다음과 같은 메시지가 나타납니다.

"[파일 경로] 폴더는 게임 콘텐츠 폴더로 보이지 않습니다. 이주된 콘텐츠는 콘텐츠 폴더에 있을 때만 정상 작동합니다. 그래도 콘텐츠를 이곳에 넣을까요?"

이주된 콘텐츠를 타깃 프로젝트에서 바로 사용하려면 아니요(No) 를 클릭하고 프로젝트의 Content 폴더를 선택합니다.

에셋이 이주된 후에 제대로 표시되지 않으면 관련 종속성도 모두 이주되었는지 확인합니다. 원래 프로젝트에서 에셋이 제대로 표시되는지 확인한 후 이주를 재시도하면서 에셋 리포트(Asset Report) 창에서 에셋의 종속성이 모두 선택되도록 합니다.