Caffeine

Compatibilidade de plugins

Reference Last updated:

Compatibilidade de ABI, flags de build e matriz de plataformas para plugins C++ legados.

Host legado. O Doppio atual em Rust/Iced não carrega plugins C++. Estas páginas documentam o SDK de plugins C++/ImGui e o seu host no editor C++ arquivado (doppio-archived/). A engine continua a compilar todos os plugins do submódulo, para que o SDK se mantenha testado na compilação.

Plugins são bibliotecas nativas partilhadas. A compatibilidade depende da ABI da engine, dos headers públicos do SDK e do toolchain de build.

Matriz#

Engine Plugin SDK caffeine/plugin/ Notas
main doppio-plugins/main estável Emparelhamento recomendado
Engine antiga Plugin mais recente pode quebrar Recompilar contra a engine
Engine mais recente Plugin antigo pode quebrar Recompilar contra a engine

Não há garantia de compatibilidade binária entre releases da engine. Recompile sempre os plugins ao atualizar a engine.

Flags de build obrigatórias#

Flag Porquê
CF_HAS_IMGUI=1 Os painéis usam o contexto ImGui do editor
CAFFEINE_PLUGIN_EXPORTS=1 Exporta CreatePlugin / DestroyPlugin
CAFFEINE_SOURCE_DIR=<engine> Paths usados por bridges de terreno/tooling

doppio_add_plugin() define estas flags automaticamente.

Notas por plataforma#

Plataforma Biblioteca Notas
Linux .so Usar o mesmo compilador e standard library do host C++
Windows .dll Tem de corresponder ao runtime MSVC (/MD vs /MT)
macOS .dylib Ainda não é alvo principal

Símbolos#

O host C++ legado carrega plugins com dlopen / LoadLibrary e resolve:

  • CreatePlugin(const PluginHostApi*)
  • DestroyPlugin(IPlugin*)

Ambos têm de ser exportados com linkage C.

Dependências em runtime#

Um plugin pode depender de bibliotecas de runtime já carregadas pelo host. Não deve trazer a sua própria cópia de ImGui ou da engine. Compile contra os mesmos headers.

Resolução de problemas#

Sintoma Causa
missing exports Falta extern "C" ou não foi compilado como shared library
dlopen failed Dependência em falta, arquitetura ou ABI errada
Crash durante OnLoad Header/ABI mismatch ou callback nulo do host
Painel vazio Compilado sem CF_HAS_IMGUI=1
Component drawer em falta Plugin desativado ou getComponentTypeId inválido

Relacionado#