Embeddinator-4000

Tools to turn .NET libraries into native libraries that can be consumed on Android, iOS, Mac, Linux and other platforms.

android bindings c c-plus-plus cplusplus cppsharp csharp dotnet interop java mobile mono monodroid monotouch objective-c xamarin

Перейти к файлу

Sebastien Pouliot 1bdeef1dd8 [objc][generator] Use metadata token lookup when building release (#91 ) * [objc][generator] Use metadata token lookup when building release where release is non-debug. https://github.com/mono/Embeddinator-4000/issues/82 * [tests] Run test-cli and perf-cli in release (non debug) mode		2017-04-11 17:21:54 +02:00
binder	[c] Move the generated __method_exception_thrown to support API as mono_embeddinator_throw_exception.	2017-03-28 17:38:14 +01:00
build	[objc] Merge master. (#46 )	2017-04-02 13:37:16 -05:00
docs	[objc] Get the Xcode location using 'xcode-select -p' to use for our clang compiler flags. (#98 )	2017-04-11 10:34:19 -04:00
external	Bump to latest IKVM.	2017-03-22 20:58:23 +00:00
objcgen	[objc][generator] Use metadata token lookup when building release (#91 )	2017-04-11 17:21:54 +02:00
support	[objc] Use _NSGetExecutablePath instead of proc_pidpath to get the executable path. (#96 )	2017-04-11 14:51:15 +02:00
tests	[objc][generator] Use metadata token lookup when building release (#91 )	2017-04-11 17:21:54 +02:00
.gitignore	[objc] Add support for building the native library with debug information. (#53 )	2017-04-03 10:55:50 -05:00
.gitmodules	Change Xamarin.Android.Tools sub-module to use HTTPS Git URL.	2017-01-25 13:46:12 +00:00
.travis.yml	[objc] Merge master. (#46 )	2017-04-02 13:37:16 -05:00
LICENSE	Pushed initial work-in-progress code for managed-to-native bindings generator.	2016-07-25 16:34:57 +01:00
README.md	[objc][README] Recommend usage of objcgen.exe instead of MonoEmbeddinator4000.exe (#92 )	2017-04-11 08:33:38 +02:00
e4000-logo.png	Add Logo	2016-11-09 15:13:18 -08:00
generator.sln	[objc] Add memory leak tests, and fix a few issues those found. (#65 )	2017-04-06 15:50:43 +02:00

README.md

windows-vs-x86	osx-clang-x86

Embeddinator-4000 is a tool to turn existing .NET libraries into libraries that can be consumed by other languages.

It is a tool that takes a .NET assembly and generates the necessary glue to surface the .NET API as a native API. The goal is to surface .NET libraries to all ecosystems where Mono/Xamarin run, and for each platform we provide an interface that is native to that platform as well as the tools needed to turn a .NET library into something that can be consumed on that platform.

This is a work in progress, the initial goals for this project are to surface .NET to C, C++, Objective-C (across the various Apple platforms) and Java (Android and regular Java).

The project is still under heavy development. Usage under mission-critical production scenarios is not advised. Please report any bugs or suggestions so we can improve the tool.

Community

Feel free to join us at our #managed-interop Gitter discussion channel.

Building

Clone this repository and initialize/update submodules as well as solution depends on them.

Open the solution in build/MonoEmbeddinator4000.sln with Visual Studio or Xamarin Studio and press F7.

Usage

To generate bindings for a managed library you invoke the MonoEmbeddinator4000.exe command line tool.

Important: please follow the instructions in objcgen's README to use the new and improved Objective-C generator (will eventually fusion with MonoEmbeddinator4000.exe.

If you do not pass any arguments, you will get a list of the tool options:

MonoEmbeddinator4000.exe [options]+ ManagedAssembly.dll
Generates target language bindings for interop with managed code.

      --gen=VALUE            target language: c, c++, obj-c (defaults to c)
      --platform=VALUE       target platform: android, windows, macos, ios, watchos, tvos
  -o, --out=VALUE            output directory
  -c, --compile              compiles the generated output
      --dll, --shared        compiles as a shared library / DLL
      --vs=VALUE             Visual Studio version for compilation: 2012, 2013, 2015, Latest (defaults to Latest)
  -v, --verbose              generates diagnostic verbose output
  -h, --help                 show this message and exit

To generate C bindings for a Xamarin.Foo.dll assembly you would call the tool like:

MonoEmbeddinator4000.exe -gen=c -out=foo Xamarin.Foo.dll