|
dxFeed Graal Native SDK 3.14.0-rc2
|
A wrapper is built against the headers of one release and runs against the library that the application installs, which may be newer. This page states what it may rely on and how it checks the library at start-up. The tiers are defined in The v4 functions, the runtime queries in System (v4).
Before it binds anything else, a wrapper checks the library with three functions (3.13.0 and newer; a library without them is older than the wrapper supports):
A wrapper that links to the library instead of loading it at run time makes the same check at start-up, and stops before it calls an experimental function of another revision: such a call may crash.
Every archive has dxfg-api.json next to the library: the C API in a form a wrapper generator reads instead of parsing the headers. It lists every function, type and macro with its header, its tier, since, its parameters and their out flags, the release function of what it returns, and deprecated with the replacements. Its sdk_version, advanced_revision and features are what the three functions above report at run time. A generator that binds only what the description lists, and only the stable tier unless the revisions match, follows this page by construction.
The headers and the description of a release keep every stable declaration of the previous one: the build checks the headers against the description of the last release, so a wrapper built for an older release keeps working with a newer library of the same major version.