Essential macros for native extensions

To install, run:

haxelib install inthebox-macros 1.2.0 

See using Haxelib in Haxelib documentation for more information.


The native mirror macro, permit to call native methods (JNI/CPP) from the haxe side easily.

The metas:

Each meta support 2 arguments: the package / lib name, and the method name

Both are optionals for JNI (it uses the haxe package & class name / method name by default) Both are needed for iOS & CPP.

After the version 1.0.1 conditional compilation is no more needed, the call check itself if the Context defined the required flags (ios for iOS ...)

JNI calls:

It support both type of methods : static or non-static.

In case of a static method it's easy:

function toto(arg1:String, arg2:Int, arg3:String):Bool{}

In the case of a non-static method, you have to set as first argument of the method a dynamic value which is the java instance of the class (than you can by example get by calling a static java singleton method)

function toto(instance:Dynamic, arg2:Int , arg2:String):Bool{}

The JNI signature of the method is automatically created.

And the JNI method is called at the same time you call the method on the haxe side.

Like said earlier you can add additional arguments to the @JNI tag:

To call a method named differently:

function toto(instance:Dynamic, arg2:Int , arg2:String):Bool{}

To class a method from another class:

function toto(instance:Dynamic, arg2:Int , arg2:String):Bool{}

CPP & iOS calls:

They both behave the same way.

The first argument is the name of library (in the case of a OpenFL native extension if the ".a" filename)

The second argument is the name of the primitive (in the case of a Open native extension, the primitive is defined into the ExternalInterface.cpp class)

function toto(arg1:String, arg2:Int, arg3:String):Bool{}

Developed by :

Johann Martinache @shoe_box


This work is under BSD simplified License. Apache License, Version 2.0

3 years ago

All libraries are free

Every month, more than thousand developers use haxelib to find, share, and reuse code — and assemble it in powerful new ways. Enjoy Haxe; It is great!

Explore Haxe

Haxe Manual

Haxe Code Cookbook

Haxe API documentation

You can try Haxe in the browser!

Join us on Github!

Haxe is being developed on GitHub. Feel free to contribute or report issues to our projects.

Haxe on Github