기술 자료

Unity 엔진

Unity 엔진

관리되는 코드 스트리핑 및 Unity linker

스트리핑하기 전에 Unity linker가 코드의 요소를 분석하고 마킹하는 방법을 이해합니다.
읽는 시간 2분최근 업데이트: 9일 전

Unity 빌드 프로세스는 Unity linker라는 툴을 사용하여 관리되는 코드 스트리핑합니다. Unity linker는 Unity와 작동하도록 사용자 지정된 IL Linker의 버전입니다. Unity 엔진 전용 Unity linker의 커스텀 부품은 공개되지 않습니다.
Unity linker는 관리되는 코드 스트리핑과 엔진 코드 스트리핑 프로세스의 일부를 모두 담당합니다. 이 프로세스는 사용되지 않는 엔진 코드를 제거하는 IL2CPP 스크립팅 백엔드를 통해 사용할 수 있는 별도의 프로세스입니다. 자세한 내용은
PlayerSettings.StripEngineCode
를 참조하십시오.

Unity linker가 어셈블리를 스트리핑하는 방법

Unity 프로젝트 빌드할 때 빌드 프로세스는 C# 코드를 일반 중간 언어(CIL)라는 .NET 바이트코드 포맷으로 컴파일합니다. Unity 이 CIL 바이트코드를 어셈블리라는 파일로 패키징합니다. 프로젝트에서 사용하는 플러그인의 .NET 프레임워크 라이브러리와 C# 라이브러리는 CIL 바이트코드 어셈블리로 사전 패키징됩니다.
관리되는 코드 스트리핑을 위해 어셈블리는 다음과 같이 분류됩니다.
  • .NET 클래스 라이브러리 어셈블리:
    mscorlib.dll
    및
    System.dll
    와 같은 Mono 클래스 라이브러리뿐만 아니라
    netstandard.dll
    와 같은 .NET 클래스 라이브러리 면적 어셈블리를 포함합니다.
  • Platform SDK 어셈블리: 플랫폼 SDK 전용 관리되는 어셈블리 포함됩니다. 예를 들어 유니버설 Windows 플랫폼 SDK의 일부인
    windows.winmd
    어셈블리입니다.
  • Unity 엔진 모듈 어셈블리: Unity 엔진을 구성하는 관리되는 어셈블리(예:
    UnityEngine.Core.dll
    )를 포함합니다.
  • 프로젝트 어셈블리: 다음과 같은 프로젝트 전용 어셈블리가 포함됩니다.
    • Assembly-CSharp.dll
      와 같은 스크립트 어셈블리.
    • 사전 컴파일된 어셈블리입니다.
    • 어셈블리 정의 어셈블리입니다.
    • 패키지 어셈블리。
일반적으로 이 카테고리에 속하지 않는 프로젝트의 어셈블리는 Unity linker에서 처리되지 않으며 플레이어 빌드 에서 제외됩니다.
빌드 중에 Unity linker는 해당되는 모든 타입의 어셈블리를 처리하고 다음을 수행합니다.
  1. 어셈블리 타입과 구성된 코드 스트리핑 레벨에 해당하는 루트 마킹 규칙에 따라 루트 타입, 메서드, 등록 정보 및 필드를 표시합니다.
  2. 이를 식별하기 위해 표시한 루트를 분석하고 해당 루트가 의존하는 관리되는 코드를 해당 종속성 마킹 규칙에 따라 마킹합니다.
  3. 애플리케이션 코드를 통해 실행 경로에서 도달할 수 없다고 표시되지 않은 나머지 코드를 어셈블리에서 삭제합니다.

메서드 바디 편집

높은 스트리핑 레벨에서 Unity linker는 코드 크기를 더 줄이기 위해 메서드 본문을 편집합니다. Unity linker는 .NET Class Library 어셈블리의 메서드 본문만 편집합니다.
Unity linker는 다음과 같은 방법으로 메서드 본문을 편집할 수 있습니다.
  • 도달할 수 없는 브랜치 제거:
    System.Environment.OSVersion.Platform
    를 확인하고 현재 타겟 플랫폼에 도달할 수 없는
    if
    문 블록.
  • 필드에만 액세스하는 인라인 메서드: 필드에 대한 직접 액세스 권한으로 필드를 가져오거나 설정하는 메서드에 대한 호출을 대체합니다. 이렇게 하면 종종 메서드를 완전히 제거할 수 있습니다. Mono 스크립팅 백엔드를 사용하는 경우 Unity linker는 필드 가시성에 따라 메서드의 호출자가 필드에 직접 액세스할 수 있는 경우에만 이 변경을 수행합니다. IL2CPP의 경우 가시성 규칙이 적용되지 않으므로 Unity linker는 적절한 경우 이 변경을 수행합니다.
  • const
    값만 반환하는 인라인 메서드입니다.
  • 메서드가 비어 있고
    void
    return type.가 있는 메서드에 대한 호출을 제거합니다.
  • finally
    블록이 비어있을 때
    try-finally
    블록을 제거합니다. 빈 호출을 제거하면 빈
    finally
    블록이 생성될 수 있습니다. 메서드 편집 중에 발생하면 Unity linker가 전체
    try-finally
    블록을 제거합니다. 이것이 발생할 수 있는 한 시나리오는 컴파일러가
    Dispose
    를 호출하기 위해
    foreach
    루프의 일부로
    try-finally
    블록을 생성하는 경우입니다.
참고
메서드 바디를 편집한 후 어셈블리의 소스 코드가 어셈블리의 컴파일된 코드와 더 이상 일치하지 않으므로 디버깅이 더 어려워질 수 있습니다.

추가 리소스