Skip to content

Mechanizm wtyczek w języku C# (Plugins)

W dzisiejszym wpisie przedstawię wam jak stworzyć prosty mechanizm wtyczek w języku C#.

Stworzymy prostą aplikację do rysowania (coś jak mspaint), ale wszystkie narzędzia będą dokładane poprzez wtyczki – plugins.

W tym celu stwórzmy bazę, czyli główną aplikację. W tym przypadku będzie to aplikacja WPF.

Na sam początek dodajmy do naszej aplikacji menu:

        <Grid.RowDefinitions>
            <RowDefinition Height="25" />
            <RowDefinition Height="*" />
        </Grid.RowDefinitions>

        <Menu Grid.Row="0">
            <MenuItem Header="Program">
                <MenuItem Header="Close" Click="MenuItem_Click"/>
            </MenuItem>
        </Menu>

Będzie tam tylko jedna opcja pozwalająca zamknąć program.

        private void MenuItem_Click(object sender, RoutedEventArgs e)
        {
            this.Close();
        }

Żeby rysować trzeba mieć na czym, dodajmy więc „Canvas”:

 

<Canvas Grid.Row="1" Background="Transparent" />

I to w zasadzie cały nasz interfejs.

Od teraz drodzy fanatycy technologii WPF i MVVM, zamknijcie oczy, ponieważ nie będziemy tutaj bawić się w żadne wzorce projektowe. Nie o to w tym przykładzie chodzi.

Więc… nadamy nazwy naszym kontrolką 😉

odpowiednio:

<Menu Name="v_Menu" Grid.Row="0">

i

<Canvas Name="v_Canvas" Grid.Row="1" Background="Transparent" />

Teraz omówmy jak zrobić mechanizm wtyczek.

Chcemy umożliwić innym programistom pisanie wtyczek do naszego programu. Aby zapewnić obsługę tych wtyczek muszą one implementować znany naszej aplikacji interface. Interface powinien być zadeklarowany w zewnętrznym projekcie. Dzięki temu będziemy mogli udostępnić go innym.

W tym celu dodajemy do naszej solucji nowy projekt typu „Class Library” o nazwie „PluginInterface„.

W tym projekcie będziemy trzymać tylko jeden plik z interfejsem IPlugin:

    public interface IPlugin : IDisposable
    {
        MenuItem GetMenuItem();

        void Initialize(Canvas canvas, Color color, int thickness);

        void SetColor(Color color);

        void SetThickness(int thickness);
    }

Pomysł jest prosty, każdy plugin musi podać swój MenuItem – tak abyśmy mogli dodać go do menu naszej aplikacji (integracja z istniejącym interfejsem).

Metoda Initialize ma pozwolić przekazać do wtyczki kontrolkę „Canvas” oraz ustawić wartości początkowe takie jak kolor czy grubość (w końcu są to wtyczki z narzędziami do rysowania).

Dodajemy referencję do PluginInterface do naszego projektu.

Teraz należy zaimplementować obsługę przyszłych wtyczek.
Zakładam, że wszystkie wtyczki będą wsadzane do folderu „Plugins„, w miejscu gdzie leży program. Oto metoda, która przeszuka ten folder i załaduje listę obiektów typu Assembly.

        private List<Assembly> GetAssemblies(string directory)
        {
            var assemblies = new List<Assembly>();
            if (Directory.Exists(directory))
            {
                foreach (var file in Directory.GetFiles(directory, "*.dll"))
                {
                    assemblies.Add(Assembly.LoadFrom(file));
                }
            }
            return assemblies;
        }

Teraz dla każdego Assembly sprawdzamy czy zawiera on klasy implementujące IPlugin.
Jeśli tak, to tworzymy instancje tych klas.

W przypadku tej konkretnej aplikacji, na każdym z tych obiektów wykonywane są dodatkowe operacje w celu wkomponowania tych funkcjonalności w interfejs użytkownika. Dlatego wywołujemy metodę GetMenuItem, która zwróci nam obiekt gotowy do dodania do menu naszej aplikacji.

Cała metoda inicjująca wtyczki wygląda tak:

        private void InitializePlugins()
        {
            var assemblies = GetAssemblies("Plugins");

            List<MenuItem> menuItems = new List<MenuItem>();

            foreach (var assembly in assemblies)
            {
                var types = assembly.GetTypes();

                foreach (var type in types)
                {
                    if (type.IsClass && type.IsPublic && type.GetInterface(typeof(IPlugin).FullName) != null)
                    {
                        var item = Activator.CreateInstance(type) as IPlugin;
                        var menuItem = item.GetMenuItem();
                        menuItem.Tag = item;
                        menuItem.Click += pluginMenuItem_Click;
                        menuItems.Add(menuItem);
                    }
                }
            }

            if (menuItems.Any())
            {
                var tools = new MenuItem();
                tools.Header = "Tools";
                menuItems.ForEach((i) => { tools.Items.Add(i); });

                v_Menu.Items.Add(tools);
            }
        }

W obsłudze zdarzenia „Click„, podmieniamy aktualnie aktywną wtyczkę na nową (ukrytą we własności „Tag„):

        private void pluginMenuItem_Click(object sender, RoutedEventArgs e)
        {
            MenuItem menuItem = sender as MenuItem;

            if (menuItem == null)
                return;

            if (_currentActivePlugin != null)
                _currentActivePlugin.Dispose();

            IPlugin plugin = menuItem.Tag as IPlugin;
            if (plugin != null)
            {
                _currentActivePlugin = plugin;
                _currentActivePlugin.Initialize(v_Canvas, _currentColor, _currentThickness);
            }
        }

To tyle jeśli chodzi o obsługę wtyczek w naszej aplikacji. Jedyne co musimy teraz zrobić to napisać plugin i sprawdzić czy całość działa 😉

(W projekcie na GITHUB są napisane 3 pluginy, jednak w tym wpisie opiszę tylko jeden z nich).

Tworzymy nowy projekt „Class Library” w naszej solucji.
Naszą wtyczką będzie narzędzie do rysowania linii więc projekt nazwałem „LineToolPlugin„.
Pamiętajmy, że każdy plugin musi implementować interfejs IPlugin, więc należy dodać referencję do projektu „PluginInterface„.

Oto implementacja całej klasy LineTool:

    public class LineTool : IPlugin
    {
        private int _thickness = 3; // default value
        private Color _color = Colors.Black; //default color
        private Canvas _canvas;

        public MenuItem GetMenuItem()
        {
            MenuItem menuItem = new MenuItem();
            menuItem.Header = "Line";
            return menuItem;
        }

        public void Initialize(Canvas canvas, Color color, int thickness)
        {
            _canvas = canvas;
            _color = color;
            _thickness = thickness;
            if (_canvas != null)
            {
                _canvas.MouseLeftButtonDown += Canvas_MouseLeftButtonDown;
                _canvas.MouseLeftButtonUp += Canvas_MouseLeftButtonUp;
                _canvas.MouseMove += Canvas_MouseMove;
            }
        }

        public void SetColor(Color color)
        {
            if (color != null)
            {
                _color = color;
            }
        }

        public void SetThickness(int thickness)
        {
            if (thickness >= 0)
            {
                _thickness = thickness;
            }
        }

        public void Dispose()
        {
            if (_canvas != null)
            {
                _canvas.MouseLeftButtonDown -= Canvas_MouseLeftButtonDown;
                _canvas.MouseLeftButtonUp -= Canvas_MouseLeftButtonUp;
                _canvas.MouseMove -= Canvas_MouseMove;
            }
        }

        private void Canvas_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
        {
            var canvas = (Canvas)sender;

            if (canvas.CaptureMouse())
            {
                var startPoint = e.GetPosition(canvas);
                var line = new Line
                {
                    Stroke = new SolidColorBrush(_color),
                    StrokeThickness = _thickness,
                    X1 = startPoint.X,
                    Y1 = startPoint.Y,
                    X2 = startPoint.X,
                    Y2 = startPoint.Y,
                };

                canvas.Children.Add(line);
            }
        }

        private void Canvas_MouseMove(object sender, MouseEventArgs e)
        {
            var canvas = (Canvas)sender;

            if (canvas.IsMouseCaptured && e.LeftButton == MouseButtonState.Pressed)
            {
                var line = canvas.Children.OfType<Line>().LastOrDefault();

                if (line != null)
                {
                    var endPoint = e.GetPosition(canvas);
                    line.X2 = endPoint.X;
                    line.Y2 = endPoint.Y;
                }
            }
        }

        private void Canvas_MouseLeftButtonUp(object sender, MouseButtonEventArgs e)
        {
            ((Canvas)sender).ReleaseMouseCapture();
        }
    }

Budujemy naszą wtyczkę i dodajemy wygenerowany plik „LineToolPlugin.dll” do folderu Plugins

LineToolsPluin-dll-content

Ważne jest aby wybrać opcję „Copy always

PluginsExample-copyAlways

 

Pliki „*.pdb” to tzw. symbole, przydają się przy debugowaniu ale o tym przy okazji następnych wpisów 😉

 

Całość jak zawsze dostępna na GitHub 🙂

 

 

Published inProgramowanie

Be First to Comment

Dodaj komentarz

Twój adres e-mail nie zostanie opublikowany. Wymagane pola są oznaczone *