ZeroMix.PluginSDK 6.8.0

ZeroMix.PluginSDK

Universal plugin SDK untuk .NET — bisa dipakai untuk membuat plugin di ZeroMix maupun aplikasi .NET lain yang mengimplementasi IPluginHost.

⚠️ Penting: Kompatibilitas Aplikasi Host

SDK ini berbasis .NET 9 dan hanya kompatibel dengan aplikasi yang dibangun di atas .NET.

Singkatnya: SDK ini cocok untuk aplikasi desktop Windows yang dibangun dengan .NET/C#.

📦 Install

dotnet add package ZeroMix.PluginSDK

🚀 Cara Membuat Plugin untuk ZeroMix

Step 1 — Buat project baru

dotnet new classlib -n MyZeroMixPlugin -f net9.0-windows
cd MyZeroMixPlugin
dotnet add package ZeroMix.PluginSDK

Step 2 — Implementasi plugin

using ZeroMix.PluginSDK;

public class MyPlugin : IZeroMixPlugin
{
    public string Name        => "CPU Monitor Plugin";
    public string Version     => "1.0.0";
    public string Description => "Tampilkan CPU usage di status bar ZeroMix";

    private IPluginHost? _host;

    public void OnLoad(IPluginHost host)
    {
        _host = host;
        host.Log($"Plugin dimuat di {host.HostName} v{host.HostVersion}");

        // Akses system monitor (ZeroMix mendukung ini)
        var monitor = host.GetService<ISystemMonitor>();
        if (monitor != null)
        {
            double cpu = monitor.GetCpuUsage();
            double ram = monitor.GetRamUsage();
            host.Log($"CPU: {cpu}% | RAM: {ram}%");
        }

        // Tampilkan status
        var status = host.GetService<IStatusService>();
        status?.SetStatus("CPU Monitor Plugin aktif!");

        // Operasi UI — selalu pakai Dispatch
        host.Dispatch(() =>
        {
            // Contoh: buat window kustom
            var win = new System.Windows.Window
            {
                Title = "CPU Monitor",
                Width = 300,
                Height = 200
            };
            win.Show();
        });
    }

    public void OnUnload()
    {
        _host?.Log("Plugin dinonaktifkan.");
        _host = null;
    }
}

Step 3 — Build plugin

dotnet build -c Release

Step 4 — Deploy ke ZeroMix

Copy hasil build ke folder plugins ZeroMix:

C:\Program Files\ZeroMix\Tools\Plugins\MyZeroMixPlugin\
    MyZeroMixPlugin.dll
    MyZeroMixPlugin.deps.json

Step 5 — Aktifkan di ZeroMix

Buka ZeroMix → sidebar Plugins → plugin kamu muncul otomatis → klik Enable.

🔌 Cara Mengintegrasikan ke Aplikasi .NET Kamu (Jadi Host)

Kalau kamu punya aplikasi .NET sendiri dan ingin mendukung plugin dari SDK ini:

Step 1 — Install SDK di project kamu

dotnet add package ZeroMix.PluginSDK

Step 2 — Implementasi IPluginHost

using ZeroMix.PluginSDK;

// Contoh: aplikasi WPF sederhana sebagai host
public class MyAppHost : IPluginHost
{
    public string HostName    => "MyApp";
    public string HostVersion => "1.0.0";

    // Jalankan di UI thread (WPF)
    public void Dispatch(Action action) =>
        System.Windows.Application.Current.Dispatcher.Invoke(action);

    // Logging
    public void Log(string message) =>
        System.Diagnostics.Debug.WriteLine($"[Plugin] {message}");

    // Expose service yang kamu support
    public T? GetService<T>() where T : class
    {
        if (typeof(T) == typeof(IStatusService))   return new MyStatusService() as T;
        if (typeof(T) == typeof(ISystemMonitor))   return new MySystemMonitor() as T;
        if (typeof(T) == typeof(IStorageService))  return new MyStorageService() as T;
        return null;
    }
}

// Implementasi service status
public class MyStatusService : IStatusService
{
    public void SetStatus(string text) =>
        System.Diagnostics.Debug.WriteLine($"[Status] {text}");

    public void ShowNotification(string title, string message) =>
        System.Windows.MessageBox.Show(message, title);
}

Step 3 — Load dan jalankan plugin

var host   = new MyAppHost();
var plugin = new SomePlugin(); // plugin yang implement IZeroMixPlugin
plugin.OnLoad(host);

// Saat app tutup atau plugin di-disable:
plugin.OnUnload();

🌙 Lua Plugin (Khusus ZeroMix)

ZeroMix juga mendukung plugin berbasis Lua — tidak perlu compile, cukup buat file script.lua.

Struktur folder Lua plugin

Tools/Plugins/user.pub.NamaPlugin/
    script.lua
    config.json   (opsional)

Contoh script.lua

-- Dipanggil saat plugin diaktifkan
function OnLoad()
    CreateUI("My Lua Plugin", 400, 300)
    AddLabel("Halo dari Lua!")
    AddButton("Klik Aku", "OnButtonClick")
    Notify("Plugin", "Lua plugin aktif!")
end

-- Dipanggil setiap detik
function OnUpdate()
    local cpu = ZeroMix:GetCpuUsage()
    Log("CPU: " .. cpu .. "%")
end

-- Callback tombol
function OnButtonClick()
    Notify("Info", "Tombol diklik!")
end

Lua API yang tersedia

📋 API Reference (C#)

IZeroMixPlugin

IPluginHost

Services via GetService<T>()

🔗 Links

• ZeroMix Repository
• NuGet Package
• Plugin Guide Lengkap
• Issues / Feedback

Maintained by ZeroMix Team | License: MIT