Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Linux native library resolution no longer uses
Starting in .NET 8, Linux applications no longer search the netcoredeps subdirectory for native libraries.
Version introduced
.NET 8
Previous behavior
In earlier versions of .NET, Linux applications searched for native libraries in a netcoredeps subdirectory located next to the application executable. This behavior applied to all native library loads, including user-defined platform invokes (p/invokes).
New behavior
In .NET 8 and later, Linux applications no longer search the netcoredeps subdirectory for native libraries. Native library resolution now follows standard mechanisms without relying on this subdirectory.
Type of breaking change
This is a behavioral change.
Reason for change
The netcoredeps behavior was originally introduced to handle complex dependencies on third-party libraries in earlier .NET versions. .NET 8+ no longer requires this behavior due to improved dependency handling. Additionally, the mechanism isn't aligned with recommended practices for ELF platforms.
For more information, see GitHub issue #114393.
Recommended action
If your application relied on the netcoredeps subdirectory for p/invokes or custom native library resolution, use the following alternatives:
- Implement a custom resolution mechanism using one of the following:
- If an
RPATHis required in your deployment, modify the ELF file explicitly using thepatchelfutility.
Affected APIs
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
