Build

모듈화를 통해 각 빌드 환경에 맞춰 커스텀 빌더를 구축할 수 있도록 도와 주는 종합 빌드 툴

Builder Class Diagram

Build Progress Diagram

필수 구현 (Required Implementation)

`Attribute` 구현을 통한 커스텀 빌드 에디터 구현

BuilderAttribute의 BuilderAttribute.buildType으로 넘겨줄 enum을 BuildTypeEnumAttribute와 함께 구현
Builder를 상속 받는 class 구현
구현한 Builder에 BuilderAttribute를 추가
EditorBuildDrawer<TConfig, TNullConfig>를 상속 받는 EditorBuildDrawer를 구현
Service -> Build -> Build Service를 통해 빌드 실행

Builder 를 상속 받는 경우 반드시 BuilderAttribute, BuildTypeEnumAttribute 를 구현하여야 EditorBuildService 에서 정상 동작

[AttributeUsage(AttributeTargets.Class)]
public class BuilderAttribute : Attribute {

    public Enum buildType;
    public BuildTarget buildTarget;
    public BuildTargetGroup buildTargetGroup;

    public BuilderAttribute(object buildType, BuildTarget buildTarget, BuildTargetGroup buildTargetGroup) {
        this.buildType = buildType is Enum enumType ? enumType : default;
        this.buildTarget = buildTarget;
        this.buildTargetGroup = buildTargetGroup;
    }
}

[AttributeUsage(AttributeTargets.Enum)]
public class BuildTypeEnumAttribute : Attribute { }

[BuildTypeEnum]
public enum BUILD_TYPE {
    NONE,
    ANDROID,
    IOS
}

using System.IO;
using UnityEditor;
using UnityEditor.Build.Reporting;

[Alias("Sample Standalone Build")]
[Builder(SAMPLE_BUILD_TYPE.STANDALONE, BuildTarget.StandaloneWindows64, BuildTargetGroup.Standalone)]
public class Sample_Builder_Standalone : Builder {

    protected override void OnPreProcess(ref BuildPlayerOptions options)
    protected override void OnPostProcess(BuildSummary summary)
}

BuildConfigProvider

모든 빌드 관련 옵션은 정적 Class인 BuildConfigProvider에 JObject형태의 Key-Value 타입으로 저장 되며 구현한 Builder에서 BuilderConfigProvider에 접근 하여 각 옵션에 대해서 처리

BuildInteractionInterface

모든 빌드는 BuildInteractionInterface를 거쳐 동작 하며 생성한 Builder의 시작 지점을 제공

CLI를 통한 빌드 interface 시작점 제공

선택 구현 (Optional Implementation)

Builder 사용을 위한 추가 적인 옵션 구현

BuildOptionEnumAttribute: 빌드에 사용할 추가 적인 옵션 사용. buildTargetGroup을 지정 하지 않는 경우 범용 옵션으로 적용
DefineSymbolEnumAttribute: 빌드에 적용할 DefineSymbol을 정의

[AttributeUsage(AttributeTargets.Enum)]
public class BuildOptionEnumAttribute : Attribute {

    public BuildTargetGroup buildTargetGroup;

    public BuildOptionEnumAttribute() => buildTargetGroup = BuildTargetGroup.Unknown;
    public BuildOptionEnumAttribute(BuildTargetGroup buildTargetGroup) => this.buildTargetGroup = buildTargetGroup;
}

[AttributeUsage(AttributeTargets.Enum)]
public class DefineSymbolEnumAttribute : Attribute { }

[BuildOptionEnum]
public enum DEFAULT_CUSTOM_BUILD_OPTION {
    ignoreResourcesReimport,
    cleanBurstDebug,
    cleanIL2CPPSludge,
    revealInFinder,
    refreshAssetDatabase,
}

[BuildOptionEnum(BuildTargetGroup.Android)]
public enum ANDROID_CUSTOM_BUILD_OPTION_TYPE {
    DEBUG_ANDROID,
    RELEASE_ANDROID,
}

[BuildOptionEnum(BuildTargetGroup.iOS)]
public enum IOS_CUSTOM_BUILD_OPTION_TYPE {
    DEBUG_IOS,
    RELEASE_IOS,
}

[DefineSymbolEnum]
public enum BUILD_DEFINE_SYMBOL_TYPE {
    DEBUG_LOG,
    DISABLE_ERROR,
    ACTIVE_DEBUG_MODE,
}

Last modified: 01 2월 2025

Build

필수 구현 (Required Implementation)

Attribute 구현을 통한 커스텀 빌드 에디터 구현

선택 구현 (Optional Implementation)

`Attribute` 구현을 통한 커스텀 빌드 에디터 구현