Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nihlus/advanceddlsupport
Delegate-based C# P/Invoke alternative - compatible with all platforms and runtimes.
https://github.com/nihlus/advanceddlsupport
c coreclr csharp dotnet hacktoberfest native netstandard pinvoke
Last synced: 3 days ago
JSON representation
Delegate-based C# P/Invoke alternative - compatible with all platforms and runtimes.
- Host: GitHub
- URL: https://github.com/nihlus/advanceddlsupport
- Owner: Nihlus
- License: lgpl-3.0
- Created: 2017-12-17T03:24:05.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-04T16:16:17.000Z (4 months ago)
- Last Synced: 2024-11-24T20:37:30.005Z (29 days ago)
- Topics: c, coreclr, csharp, dotnet, hacktoberfest, native, netstandard, pinvoke
- Language: C#
- Homepage:
- Size: 1.23 MB
- Stars: 494
- Watchers: 24
- Forks: 30
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Support: docs/supported_constructs.md
Awesome Lists containing this project
README
# AdvancedDLSupport
Alternative approach to your usual P/Invoke!
[](https://discord.gg/fDy5Vhb)
Use C# interfaces to bind to native code - quick and easy usage of C API in C# code, on any platform.
Gone are the days of broken `DllImport` and annoying workarounds for the different runtimes.
Fully compatible with Mono, .NET Framework, .NET Core, and .NET Standard. Compatible with Mono DLL mapping on all
platforms and runtimes. Configurable and adaptible.
## Why use ADL?
1) Modern API - no more static classes, no more `extern`. Use your native API as if it were first-class objects.
2) Flexibility - Inject your native API into your classes, change the library scanning logic, mix your managed and
native code.
3) [Speed][indirect-calls] - ADL is blazing fast, and gives your native interop an edge. See performance increases that
are at least 2 and up to 8 times faster than other, existing solutions.
4) [Easy to use][quickstart] - Not only is ADL simple to set up and get working, it's a breeze to maintain, and reduces
clutter in your codebase.
Read the [Docs][9], or install via NuGet and [get started][quickstart].
## Features
* Supports all the typical P/Invoke patterns and constructs
* Seamlessly mix native functions and managed code
* Use more complex types, such as `Nullable` and `string` without any extra code
* Select library architectures at runtime
* Select library names at runtime
* Swappable native library search algorithms
* Import global variables
* Optional lazy loaded symbols
* Optional Mono DllMap support
## Basic Usage
1. Declare your interface
```cs
public interface IMyNativeLibrary
{
long MyNativeGlobal { get; set; }
int MyNativeMultiply(int a, int b);
void MyOtherNativeFunction(MyStruct strct, ref MyStruct? maybeStruct);
}
```
2. Activate it
```cs
const string MyLibraryName = "MyLibrary";
var activator = new NativeLibraryBuilder();
var library = activator.ActivateInterface(MyLibraryName);
```
3. Use it
```cs
library.MyNativeGlobal = 10;
var result = library.MyNativeMultiply(5, 5);
var myStruct = new MyStruct();
MyStruct? myOtherStruct = null;
library.MyOtherNativeFunction(myStruct, ref myOtherStruct);
```
See the [Quickstart][quickstart] for more information.
## Installation
Get it on NuGet!
## Support me
[![Become a Patron][patreon-button]][patreon]
## License
If the library's license doesn't fit your project or product, please [contact us][14]. Custom licensing options are
available, and we are always open to working something out that fits you - be it modified, commercial, or otherwise.
AdvancedDLSupport's public release is licensed under the [GNU Lesser General Public License, Version 3 (LGPLv3)][12].
See the [LICENSE][13] for details. Without the support of the open-source movement, it would never have existed.
[2]: https://travis-ci.org/Firwood-Software/AdvancedDLSupport
[6]: https://ci.appveyor.com/project/Nihlus/advancedlsupport-dnwes
[9]: https://nihlus.github.io/AdvancedDLSupport
[quickstart]: docs/quickstart.md
[indirect-calls]: docs/indirect-calling.md
[12]: https://www.gnu.org/licenses/lgpl-3.0.txt
[13]: LICENSE
[14]: mailto:[email protected]
[patreon-button]: https://c5.patreon.com/external/logo/become_a_patron_button.png (Become a Patron)
[patreon]: https://www.patreon.com/jargon