기술 자료

Unity 엔진

Unity 엔진

소스 제너레이터 생성 및 사용

간단한 소스 제너레이터를 생성하고 Unity 에디터 Unity 프로젝트 코드에 사용할 수 있도록 설정합니다.
읽는 시간 2분최근 업데이트: 9일 전

스크립트 컴파일 프로세스의 추가 단계로 소스 제너레이터를 사용하여 기존 코드를 컴파일하는 동안 새 코드를 추가할 수 있습니다. 코드 분석기와 마찬가지로 기존 소스 제너레이터를 사용하거나 직접 생성할 수 있습니다.
참고
Unity는
System.Text.Json
네임스페이스의 6.0.0-preview 버전만 지원합니다. 애플리케이션에서 이 네임스페이스를 사용하려면 버전
6.0.0-preview
를 사용해야 합니다.
System.Text.Json
에 대한 자세한 내용은 Microsoft의 System.Text.Json 네임스페이스 문서를 참조하십시오.
Visual Studio에서 소스 제너레이터를 생성한 다음 Unity 프로젝트 사용할 수 있도록 적용하는 방법은 다음과 같습니다.
  1. Visual Studio에서 .NET Standard 2.0을 대상으로 하는 C# 클래스 라이브러리 프로젝트를 생성하고 프로젝트의 이름을
    ExampleSourceGenerator
    로 지정합니다.
  2. 프로젝트에 대한
    Microsoft.CodeAnalysis.Csharp
    NuGet 패키지를 설치합니다. 소스 제너레이터가 Unity와 작동하려면 Microsoft.CodeAnalysis.Csharp 4.3을 사용해야 합니다.
  3. Visual Studio 프로젝트에서 새 C# 파일을 생성하고 다음 코드를 추가합니다.
    using Microsoft.CodeAnalysis;using Microsoft.CodeAnalysis.Text;using System.Text;네임스페이스 ExampleSourceGenerator{ [제너레이터] public class ExampleSourceGenerator : ISourceGenerator { public void Execute(GeneratorExecutionContext context) { System.Console.WriteLine(System.DateTime.Now.ToString()); var sourceBuilder = new StringBuilder( @" using System; namespace ExampleSourceGenerated { public static class ExampleSourceGenerated { public static string GetTestText() { return ""이것은 소스 제너레이터에서 온 것입니다."); sourceBuilder.Append(System.DateTime.Now.ToString()); sourceBuilder.Append( @"""; } }}"); context.AddSource("exampleSourceGenerator", SourceText.From(sourceBuilder.ToString(), Encoding.UTF8)); } public void Initialize(GeneratorInitializationContext context) { } }}
  4. 릴리스할 소스 제너레이터를 구축하십시오. 이렇게 하려면 Build로 이동하여 Batch Build 옵션을 선택한 다음 Release 옵션과 Build 옵션을 선택합니다.
  5. 소스 제너레이터의 프로젝트 폴더에서
    bin/Release/netstandard2.0/ExampleSourceGenerator.dll
    파일을 찾습니다.
  6. 이 파일을 Unity 프로젝트 Assets 폴더에 복사합니다.
  7. 에셋 브라우저에서 .dll 파일을 클릭하여 플러그인 인스펙터 창을 엽니다.
  8. 플러그인 플랫폼 선택에서 모든 플랫폼을 비활성화합니다.
  9. Include Platforms에서 Editor 및 Standalone을 비활성화합니다.
  10. 에셋 레이블에서 레이블 아이콘을 클릭하여 에셋 레이블 하위 메뉴를 엽니다.
  11. RoslynAnalyzer라는 새 레이블을 만들고 할당합니다. 이렇게 하려면 Asset labels 하위 메뉴의 텍스트 입력 필드에
    RoslynAnalyzer
    를 입력하고 enter 키를 누릅니다. 이 레이블은 정확히 일치해야 하며 대소문자를 구분합니다. 생성되면 레이블이 에셋 레이블 하위 메뉴에 나타납니다. 메뉴에서 레이블 이름을 클릭 수 다른 분석기에 할당할 수 있습니다.
  12. 소스 제너레이터가 작동하는지 테스트하려면 다음 코드를 사용하여 에디터에서 새로운 MonoBehaviour 스크립트를 생성합니다.
    using UnityEngine;public class HelloFromSourceGenerator : MonoBehaviour{ static string GetStringFromSourceGenerator() { return ExampleSourceGenerated.ExampleSourceGenerated.GetTestText(); } // Start is called before the first frame update void Start() { var output = "Test"; output = GetStringFromSourceGenerator(); Debug.Log(output); }}
  13. 소스 제너레이터를 두 개 이상의 어셈블리에 삽입하면 IDE에 충돌에 대한 컴파일러 경고(CS0436)가 표시됩니다. 다음 중 하나를 수행하여 이 경고를 제거할 수 있습니다.
    • ExampleSourceGenerator
      예제
      internal
      에서
      ExampleSourceGenerated
      클래스를 만듭니다. 중요: 이 경우 동일한 어셈블리 내에서 생성된 클래스에만 액세스할 수 있습니다.
    • 특정 어셈블리에 고유하도록
      ExampleSourceGenerated
      클래스의 이름을 변경합니다(예:
      ExampleSourceGenerated_MyAssembly
      ).
  14. 이 스크립트를 씬의 게임 오브젝트에 추가하고 플레이 모드로 전환합니다. 소스 제너레이터의 메시지가 시간 스탬프를 포함하여 콘솔 창 나타납니다.
소스 제너레이터에 대한 자세한 내용은 Microsoft의 소스 제너레이터 문서를 참조하십시오.

추가 리소스