# Additional files for Roslyn analyzers and source generators

> Define additional text files for Roslyn analyzers or source generators to use.

You can add [additional files](https://github.com/dotnet/roslyn/blob/main/docs/analyzers/Using%20Additional%20Files.md) to your project for a Roslyn analyzer or source generator to consume. The Unity Editor recognizes files as additional files for Roslyn analyzers if they have the .additionalfile extension and are somewhere in the `Assets` folder or one of its subfolders.

## Naming additional files

To be passed to the compilation pipeline, files must be named according to the format `Filename.[Analyzer Name].additionalfile`. Files that lack the `[Analyzer Name]` component are imported but not passed to the compilation pipeline. The `[Analyzer Name]` component is case-sensitive and must match the name of the analyzer the additional file targets. The `Filename` component must not contain a period (`.`) character.

## Additional file filtering

Each compiled assembly receives a list of additional files based on the analyzers running for that [assembly definition](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/assembly-definition-files.md), filtered by the `[Analyzer Name]`. For example, consider a project with the following assemblies and analyzers:

* Assembly1 uses an analyzer named `Analyzer1`
* Assembly2 uses an analyzer named `Analyzer2`
* Assembly3 uses both `Analyzer1` and `Analyzer2`

If the project contains four additional files named `FileA.Analyzer1.additionalfile`, `FileB.Analyzer2.additionalfile`, `FileC.additionalfile`, and `FileD.Analyzer3.additionalfile`, then Unity passes the following list of additional files with the respective assemblies:

* Assembly1: `FileA.Analyzer1.additionalfile`
* Assembly2: `FileB.Analyzer2.additionalfile`
* Assembly3: `FileA.Analyzer1.additionalfile`, `FileB.Analyzer2.additionalfile`

Since `FileC` has no `[Analyzer Name]` component and `FileD` references an analyzer that isn't present in the project, Unity doesn't pass either one to the compilation pipeline.

## Retrieving available additional files from code

Analyzers can retrieve the full list of additional files included in the compiled assembly from the analyzer context. This list comprises all additional files included in the assembly, not just the ones matching the name of the current analyzer. The following example demonstrates this:

```lang-cs
using System.IO;
using System.Linq;
using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.CSharp.Syntax;

namespace SourceGeneratorTest1;


[Generator]
public class SG2 : ISourceGenerator
{
    public void Execute(GeneratorExecutionContext context)
    {
        var pathOfFileWithTypeName = context.AdditionalFiles.FirstOrDefault(file => file.Path.Contains("GenerateType.SourceGenerator.Test.2.additionalfile"));
        if (pathOfFileWithTypeName == null)
        {
            // no additional file found, do not generate a type.
            return;
        }

        var @namespace = context.Compilation.SyntaxTrees.First().GetRoot().DescendantNodes().OfType<NamespaceDeclarationSyntax>().FirstOrDefault()?.Name?.ToString() ?? "NoNamespace";

        // an additional file has been passed; read the type name from the file.
        string generatedTypeName = File.ReadAllText(pathOfFileWithTypeName.Path);

        context.AddSource(
            "SG2.generated.cs", 
            $$"""
            namespace {{@namespace}}
            {
                public partial class {{generatedTypeName}}
                {
                }
            }
            """);
    }

    public void Initialize(GeneratorInitializationContext context)
    {
    }
}
```

> **Note:**
>
> This example is only intended to demonstrate using the analyzer context to check for additional files. A production-ready source generator requires more comprehensive code to handle errors and ensure correct function and performance.

In the previous [filtering example](#filtering), `Analyzer1` and `Analyzer2` can both retrieve additional files for Assembly3 that are named after either of them. Each analyzer is responsible for checking if there is any data it can use in the additional files.

You can also retrieve the list of additional files included for a given assembly by using the [ScriptCompilerOptions.RoslynAdditionalFilePaths](/engine/6000.0/script-reference/unityeditor/compilation/scriptcompileroptions/roslynadditionalfilepaths.md) property in Editor code.

## Additional resources

* [ScriptCompilerOptions.RoslynAdditionalFilePaths](/engine/6000.0/script-reference/unityeditor/compilation/scriptcompileroptions/roslynadditionalfilepaths.md)
* [Create and use a source generator](/engine/6000.0/manual/scripting/debugging-and-diagnostics/roslyn-analyzers/create-source-generator.md)
* [Install and use an existing analyzer or source generator](/engine/6000.0/manual/scripting/debugging-and-diagnostics/roslyn-analyzers/install-existing-analyzer.md)