소스 제너레이터 생성 및 사용
간단한 소스 제너레이터를 생성하고 Unity 에디터 Unity 프로젝트 코드에 사용할 수 있도록 설정합니다.
읽는 시간 2분최근 업데이트: 9일 전
스크립트 컴파일 프로세스의 추가 단계로 소스 제너레이터를 사용하여 기존 코드를 컴파일하는 동안 새 코드를 추가할 수 있습니다. 코드 분석기와 마찬가지로 기존 소스 제너레이터를 사용하거나 직접 생성할 수 있습니다.
Visual Studio에서 소스 제너레이터를 생성한 다음 Unity 프로젝트 사용할 수 있도록 적용하는 방법은 다음과 같습니다.
-
Visual Studio에서 .NET Standard 2.0을 대상으로 하는 C# 클래스 라이브러리 프로젝트를 생성하고 프로젝트의 이름을로 지정합니다.
ExampleSourceGenerator -
프로젝트에 대한NuGet 패키지를 설치합니다. 소스 제너레이터가 Unity와 작동하려면 Microsoft.CodeAnalysis.Csharp 4.3을 사용해야 합니다.
Microsoft.CodeAnalysis.Csharp -
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) { } }}
-
릴리스할 소스 제너레이터를 구축하십시오. 이렇게 하려면 Build로 이동하여 Batch Build 옵션을 선택한 다음 Release 옵션과 Build 옵션을 선택합니다.
-
소스 제너레이터의 프로젝트 폴더에서파일을 찾습니다.
bin/Release/netstandard2.0/ExampleSourceGenerator.dll -
이 파일을 Unity 프로젝트 Assets 폴더에 복사합니다.
-
에셋 브라우저에서 .dll 파일을 클릭하여 플러그인 인스펙터 창을 엽니다.
-
플러그인 플랫폼 선택에서 모든 플랫폼을 비활성화합니다.
-
Include Platforms에서 Editor 및 Standalone을 비활성화합니다.
-
에셋 레이블에서 레이블 아이콘을 클릭하여 에셋 레이블 하위 메뉴를 엽니다.
-
RoslynAnalyzer라는 새 레이블을 만들고 할당합니다. 이렇게 하려면 Asset labels 하위 메뉴의 텍스트 입력 필드에를 입력하고 enter 키를 누릅니다. 이 레이블은 정확히 일치해야 하며 대소문자를 구분합니다. 생성되면 레이블이 에셋 레이블 하위 메뉴에 나타납니다. 메뉴에서 레이블 이름을 클릭 수 다른 분석기에 할당할 수 있습니다.
RoslynAnalyzer -
소스 제너레이터가 작동하는지 테스트하려면 다음 코드를 사용하여 에디터에서 새로운 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); }}
-
소스 제너레이터를 두 개 이상의 어셈블리에 삽입하면 IDE에 충돌에 대한 컴파일러 경고(CS0436)가 표시됩니다. 다음 중 하나를 수행하여 이 경고를 제거할 수 있습니다.
- 예제
ExampleSourceGenerator에서internal클래스를 만듭니다. 중요: 이 경우 동일한 어셈블리 내에서 생성된 클래스에만 액세스할 수 있습니다.ExampleSourceGenerated - 특정 어셈블리에 고유하도록 클래스의 이름을 변경합니다(예:
ExampleSourceGenerated).ExampleSourceGenerated_MyAssembly
-
이 스크립트를 씬의 게임 오브젝트에 추가하고 플레이 모드로 전환합니다. 소스 제너레이터의 메시지가 시간 스탬프를 포함하여 콘솔 창 나타납니다.
소스 제너레이터에 대한 자세한 내용은 Microsoft의 소스 제너레이터 문서를 참조하십시오.