Skip to main content

Frequently asked questions and answers

Here you can find answers to frequently asked questions and common problems about Mapperly.

Mapperly does not work when I use source generator X.​

Chaining source generators is not supported by Roslyn.

I updated the Mapperly version, but the generated code still looks the same.​

Restart the IDE to make it load the new version of Mapperly. This is a bug of the IDE.

Everything is configured correctly and dotnet build works, but the IDE shows the error "[Mapper method] must have an implementation part because it has accessibility modifiers"​

Make sure your project meets the requirements. Try rebuilding the solution or restarting the IDE. This is a bug in the IDE.

My advanced use case isn't supported by Mapperly or needs lots of configuration. What should I do?​

Write the mapping for that class manually. You can mix automatically generated mappings and user implemented mappings without problems.

My code throws FileNotFoundException with Riok.Mapperly.Abstractions. What should I do?​

Are you using reference handling or have you enabled the preservation of Mapperly attributes at runtime? Make sure ExcludeAssets on the PackageReference does not include runtime as these features require runtime assets.

Can I get professional help or consulting for Mapperly?​

Yes! The riok team offers professional consulting and support services for Mapperly. Whether you need help with architecture consultation, implementation support, custom feature development the team is here to assist. Reach out through [email protected] for professional services. You can also support the project through GitHub Sponsors to get priority support.