Migrate from v2
- Update the host to Dear ImGui
dockingcommit367b2c24f399988ddafc0bb4628da0106bcc09be, including matching official backends and Test Engine sources. - Include
<imkit/preview_opengl3.h>forGLFunctionsandOpenGL3Renderer.<imkit/preview.h>now contains renderer-neutral types only. On macOS linkimkit::preview_metaland pass borrowedMTLDevice/command buffers. - Replace
Win32ActionSinkwithNativeActionSink. The callback returnsbooland receives an optional UTF-8 value. Link the matchingaccessibility_win32oraccessibility_macostarget. - Remove
IMKIT_BUILD_WINDOW_FRAME_LEGACY_IMGUIand legacy target references. All consumers use the normal v3 targets and the exact pinned Dear ImGui ABI. - Installed consumers set
IMKIT_SDK_ABI_CONFIRMED=ONonly after matching the recorded OS, architecture, compiler, ImGui revision andimconfigABI. - Link
imkit::node_editorexplicitly when adopting the new Node Editor. Move graph data, revision checks, edit application, Undo, evaluation and persistence into the host; do not treat the companion Material Graph model as library state.
Moving on to 4.0
Section titled “Moving on to 4.0”The spellings deprecated after 3.3, the changed default tokens and the other changes that can affect hosts are listed in the 4.0 migration guide.