기술 자료

Unity 엔진

Unity 엔진

Roslyn 분석기 생성 및 사용

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

코드 분석기를 사용하여 코드에 오류, 규칙 위반, 코딩 스타일 문제를 검사할 수 있습니다. 소스 제너레이터와 마찬가지로 기존 분석기를 사용하거나 직접 생성할 수 있습니다.
IDE에서 Roslyn 분석기를 생성한 다음 Unity 프로젝트 사용할 수 있도록 적용하는 방법은 다음과 같습니다.
  1. IDE에서 .NET Standard 2.0을 대상으로 하는 C# 클래스 라이브러리 프로젝트를 생성하고 프로젝트 이름을
    ExampleAnalyzer
    로 지정합니다.
  2. 프로젝트에 대한
    Microsoft.CodeAnalysis.Csharp
    NuGet 패키지를 설치합니다. 분석기는 Unity에서 작동하려면 Microsoft.CodeAnalysis.Csharp 4.3을 사용해야 합니다.
  3. IDE 프로젝트에서 새 C# 파일을 생성하고 다음 코드를 추가합니다.
    using System.Collections.Immutable;using Microsoft.CodeAnalysis;using Microsoft.CodeAnalysis.CSharp;using Microsoft.CodeAnalysis.CSharp.Syntax;using Microsoft.CodeAnalysis.Diagnostics;네임스페이스 ExampleAnalyzer{[DiagnosticAnalyzer(LanguageNames.CSharp)]public class DebugLogAnalyzer : DiagnosticAnalyzer{ public const string DiagnosticId = "EX0001"; private static readonly LocalizableString Title = "Debug.Log 사용 피하기"; private static readonly LocalizableString MessageFormat = "Debug.Log 호출이 감지되었습니다. 배송 전에 제거해야 함"; private static readonly LocalizableString Description = "Debug.Log 호출은 프로덕션 빌드에서 성능에 영향을 미치고 콘솔을 혼란스럽게 할 수 있습니다."; private const 문자열 Category = "사용"; private static readonly DiagnosticDescriptor 규칙 = 새로운 DiagnosticDescriptor( DiagnosticId, 제목: MessageFormat, 카테고리 DiagnosticSeverity.Warning, isEnabledByDefault: true, description: 설명 public override ImmutableArray<DiagnosticDescriptor> SupportedDiagnostics => ImmutableArray.Create(Rule); public override void Initialize(AnalysisContext context) { context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.None); context.EnableConcurrentExecution(); context.RegisterSyntaxNodeAction(AnalyzeInvocation, SyntaxKind.InvocationExpression); } private static void AnalyzeInvocation(SyntaxNodeAnalysisContext 컨텍스트) { var invocation = (InvocationExpressionSyntax)context.Node; if (!(invocation.Expression is MemberAccessExpressionSyntax memberAccess)) 반환; // Match calls where the method name is "Log" if (memberAccess.Name.Identifier.Text != "Log") 반환; // Verify the symbol belongs to UnityEngine.Debug var symbolInfo = context.SemanticModel.GetSymbolInfo(memberAccess); if (!(symbolInfo.Symbol is IMethodSymbol methodSymbol)) 반환; var containingType = methodSymbol.ContainingType; if (containingType?.ToDisplayString() != "UnityEngine.Debug") 반환; var diagnostic = Diagnostic.Create(Rule, memberAccess.GetLocation()); context.ReportDiagnostic(diagnostic); }}}
  4. 릴리스 빌드 구성으로 분석기를 구축합니다.
  5. 분석기의 프로젝트 폴더에서
    bin/Release/netstandard2.0/ExampleAnalyzer.dll
    파일을 찾습니다.
  6. 이 파일을
    Assets
    폴더 안에 있는 Unity 프로젝트에 복사합니다.
  7. 에셋 브라우저에서 .dll 파일을 클릭하여 플러그인 인스펙터 창을 엽니다.
  8. 플러그인 플랫폼 선택에서 모든 플랫폼을 선택 해제합니다.
  9. Include Platforms에서 Editor 및 Standalone 및 다른 선택된 플랫폼을 선택 해제합니다.
  10. 에셋 레이블에서 레이블 아이콘을 클릭하여 에셋 레이블 하위 메뉴를 엽니다.
  11. RoslynAnalyzer라는 새 레이블을 만들고 할당합니다. 이렇게 하려면 Asset labels 하위 메뉴의 텍스트 입력 필드에
    RoslynAnalyzer
    를 입력하고 Enter 키를 누릅니다. 이 레이블은 정확히 일치해야 하며 대소문자를 구분합니다. 생성되면 레이블이 에셋 레이블 하위 메뉴에 나타납니다. 메뉴에서 레이블 이름을 클릭 수 다른 분석기에 할당할 수 있습니다.
  12. 분석기가 작동하는지 테스트하려면 다음 코드를 사용하여 에디터에서 새로운 MonoBehaviour 스크립트를 생성합니다.
    using UnityEngine;public class TestScript : MonoBehaviour{ void Start() { Debug.Log("Hello world"); // Should trigger EX0001 warning }}
Unity 스크립트를 다시 컴파일하면 콘솔에 다음과 같은 경고가 나타납니다.
TestScript.cs(8,9): warning EX0001: Debug.Log 호출이 감지되었습니다. 배송 전에 제거하는 것이 좋습니다.
Roslyn 분석기 제작에 대한 자세한 내용은 튜토리얼을 참조하십시오. 첫 번째 분석기와 코드 수정을 Microsoft 문서에 작성하십시오.

리포트 분석기 진단

분석기 및 소스 제너레이터의 총 실행 시간 또는 각 분석기 또는 소스 제너레이터의 상대 실행 시간과 같은 정보를 보려면 편집 > 환경 설정(macOS: Unity > 설정) > 에디터 진단 기능 > 코어로 이동하여 EnableDomainReloadTimings를 활성화합니다. 활성화하면 정보가 콘솔 창 표시됩니다.

추가 리소스