Guia de migração de plugins
A mudança de plugins na árvore para o submódulo doppio-plugins e o loader opt-in.
Host legado. O Doppio ativo em Rust/Iced não carrega plugins C++.
Estas páginas documentam o SDK C++/ImGui e o seu host em
caffeine-runtime / doppio-archived. A engine continua a
compilar todos os plugins do submódulo para manter o SDK testado.
Esta página documenta a passagem de plugins dentro da árvore do Doppio para o
repositório autónomo doppio-plugins e para o carregamento opt-in.
O que mudou#
| Antes | Agora |
|---|---|
apps/plugins/<nome> dentro da engine |
doppio-plugins/plugins/<nome> (submódulo) |
Targets CMake hello_plugin, terrain_plugin, … |
doppio_add_plugin() no repo de plugins |
Todos os .so descobertos carregados no arranque |
Só bibliotecas ativadas no Plugin Manager |
| Core referenciava identificadores de plugins | Core expõe apenas callbacks genéricos do host |
| UI do plugin usava internals do Doppio | UI usa caffeine/plugin/PluginUI.hpp + Caffeine::UIKit |
Migrar um plugin#
-
Mover as fontes
bashdoppio-plugins/ └── plugins/ └── my-plugin/ ├── CMakeLists.txt ├── README.md └── src/ └── main.cpp -
Compilar contra o SDK
cmakeinclude(DoppioPlugin) doppio_add_plugin(my_plugin OUTPUT_NAME my_plugin SOURCES src/main.cpp)Configure com
-DCAFFEINE_ROOT=/caminho/para/caffeinee-DIMGUI_DIR=/caminho/para/caffeine/build/_deps/imgui-src. -
Usar a API pública
cpp#include "caffeine/plugin/PluginAPI.hpp" #include "caffeine/plugin/PluginUI.hpp"Não inclua headers
editor/…. O audit de coupling falha nesses casos. -
Registar UI com
PluginUI.hppcppCaffeine::Editor::PluginPanelInfo info; info.id = "plugin.my.panel"; info.title = "My Tool"; info.icon = "settings"; info.defaultOpen = false; info.dock = Caffeine::Editor::PluginDockArea::Right; Caffeine::Editor::RegisterPluginPanel(m_host, GetName(), info, &render, this); -
Instalar e ativar
Copie a biblioteca compilada para um diretório
plugins/e ative-a em Plugins → Plugin Manager. O Doppio guarda a escolha em~/.config/caffeine/plugins.cfg.
Versionamento#
Mantenha o repositório de plugins e a engine em sincronia. Um plugin compilado contra uma ABI diferente pode falhar ao carregar ou crashear. O CI deve compilar a matriz de plugins contra o commit da engine que visa.
Validação#
python3 scripts/audit_plugin_coupling.py
# errors: 0, warnings: 0, info: 0