Version: 2020.2
개발용 빌드
Xcode 프레임워크

선처리 및 후처리 익스포트 메서드

선처리 및 후처리 익스포트 메서드를 사용하면 Unity 프로젝트가 빌드되기 전후에 액션을 트리거할 수 있습니다. 단, 이러한 메서드는 에셋(Asset) 폴더의 에디터(Editor) 폴더에 위치한 프로젝트 내부 코드여야 합니다. 디렉토리에 이 폴더가 없으면 에셋(Asset) 폴더 내에서 마우스 오른쪽 버튼을 클릭하여 만들기(Create) > 폴더(Folder) 로 이동한 후 “Editor”라고 이름을 지정하십시오.

중요: UnityEngine.CloudBuild.BuildManifestObject 클래스는 클라우드 빌드(로컬 상태 아님)에서 실행 중일 때만 사용할 수 있습니다. 코드를 로컬로 컴파일하려면 선처리 및 후처리 익스포트 메서드를 #if UNITY_CLOUD_BUILD 블록으로 래핑해야 합니다.

빌드 타겟의 고급 옵션에서 선처리 및 후처리 익스포트 메서드를 설정하십시오. 자세한 내용은 고급 옵션을 참조하십시오.

고급 옵션 수정 창
고급 옵션 수정 창

선처리 익스포트 메서드 이름

선처리 익스포트 메서드를 사용하려면 Unity 에디터에서 프로젝트를 익스포트하기 전에 실행하려는 코드가 포함된 Unity 프로젝트에 공용 정적 메서드를 생성하십시오.

public static void PreExport()

클라우드 빌드를 활성화한 후 메서드 서명에서 BuildManifestObject 오브젝트를 파라미터로 지정하여 현재 빌드의 빌드 매니페스트를 선처리 익스포트 메서드로 전달할 수 있습니다. 그런 다음 프로젝트를 익스포트하기 전에 프로젝트 또는 Player 설정을 변경하십시오.

public static void PreExport(UnityEngine.CloudBuild.BuildManifestObject manifest)

Unity 클라우드 빌드는 메서드를 호출할 때 BuildManifestObject 오브젝트를 옵션 파라미터로 전달합니다. 이 경우 BuildManifestObject가 현재 빌드의 빌드 매니페스트입니다.

자세한 내용은 ScriptableObject로 매니페스트 빌드를 참조하십시오.

후처리 익스포트 메서드 이름

후처리 익스포트 메서드를 사용하려면 Unity 에디터에서 프로젝트를 익스포트한 후에 실행하려는 코드가 포함된 Unity 프로젝트에 공용 정적 메서드를 생성하십시오.

public static void PostExport(string exportPath)

Unity 클라우드 빌드가 메서드를 호출할 때 다음 문자열을 전달합니다.

*비 iOS 빌드 타겟의 경우 문자열에 익스포트된 프로젝트의 경로가 포함됩니다.

  • iOS 프로젝트의 경우 문자열에 익스포트된 Xcode 프로젝트의 경로가 포함됩니다. 이 경로를 사용하면 빌드 프로세스를 완료하기 위해 Xcode를 호출하기 전에 익스포트된 Xcode 프로젝트를 찾아 추가 선처리 작업을 수행할 수 있습니다.

참고: 만일 Unity PostProcessBuildAttribute에서 코드에 메서드를 하나라도 태그한 경우, 태그된 메서드는 Unity 클라우드 빌드에서 후처리 익스포트 메서드로 설정된 메서드 이전에 실행됩니다.

개발용 빌드
Xcode 프레임워크