Дополнения к SMath Studio
Возможности программы SMath Studio могут быть расширены путём установки дополнений. Дополнения делятся на коммерческие и сторонние и могут влиять на следующий функционал:
- Импорт и экспорт документов в формате файлов сторонних приложений.
- Символьное и численное вычисление.
- Поддержку дополнительных элементов листа расчётов.
- Добавление элементов в интерфейс программы (боковую панель и главное меню).
Установка дополнений
Дополнения могут быть загружены и установлены в программу SMath Studio различными способами, при этом способ установки не влияет на предоставляемый функционал. Некоторые дополнения могут требовать подключения к сети Интернет или дополнительных библиотек/программ, установленных в операционной системе. Для доступа к информации о технических требованиях и ограничениях, пожалуйста, ознакомьтесь с инструкцией к самим дополнениям.
Онлайн установка
Для онлайн установки дополнений необходимо:
- Открыть Менеджер расширений (используя главное меню "Сервис" > "Дополнения...");
- Перейдите на закладку "Дополнения" и переключите источник с "Локальное хранилище" в "Галерея онлайн";
- Выберите необходимое дополнение из списка и нажмите "Установить";
- Дополнения будут установлены и готовы к использованию.
Офлайн установка
Для установки дополнений в офлайн режиме необходимо:
- Используя любой ПК с подключенной сетью Интернет:
- перейдя на страницу Профиль пользователя - SMath убедитесь, что вы используете учётную запись, указанную в электронной лицензии;
- перейдите на страницу: Дополнения SMath Studio;
- скачайте интересующие вас дополнения в ZIP формате;
- обратите внимание, что нет необходимости разархивировать скачанные ZIP файлы.
- На ПК с установленной программой SMath Studio без подключения к сети Интернет:
- перенесите скачанные файлы на ПК;
- используя drag'n'drop перенесите дополнения по одному в основное окно программы;
- дополнения будут установлены.
Разработка дополнений
Для сторонних разработчиков мы предоставляем возможность создания новых дополнений согласно требованиям заказчика. В качестве примера можно использовать дополнения, для которых доступны исходные коды. Репозиторий доступен по адресу SVN репозиторий SMath.
Получение доступа к репозиторию
Инструкция для получения исходного кода открытых дополнений:
- Скачайте SVN клиента: TortoiseSVN.
- Установите скачанную программу (может потребоваться перезагрузка).
- Создайте на своем ПК папку, в которой вы хотите хранить исходники.
- Щелкните правой кнопкой мыши по созданной папке и выберите пункт "SVN Checkout..." из контекстного меню папки.
- Заполните текстовые поля в появившемся диалоговом окне (обычно требуется указать только URL-адрес репозитория) и нажмите кнопку ОК.
- Доступные исходные файлы будут загружены.
Создание дополнения
Для работы с кодом дополнений на ОС Windows, пожалуйста, выполните следующие шаги:
- Установите текущую актуальную версию SMath Studio.
- Установите текущую актуальную версию Visual Studio Community.
- Создайте проект "Class Library (.Net Framework)", указав .Net Framework 2.0 в поле Framework в диалоге создания проекта.
- Реализуйте один или несколько интерфейсов SMath Studio, унаследованных от IPlugin:
- IPluginLowLevelEvaluationFast - перехват вычисления операторов и функций.
- IPluginMathNumericEvaluation - перехват численных вычислений.
- IPluginCustomRegion - создание типа элемента листа.
- IPluginRegionDrawing - отрисовка элемента формулы в математической формуле.
- IPluginSaveFileTypes - сохранение расчёта в файл.
- IPluginOpenFileTypes - открытие расчёта из файла.
- IPluginDataInputOutput - формат задания начальных данных и результатов расчёта для автоматизации и интеграции с другими приложениями.
- IPluginMenuExtender - расширение главного меню программы.
Доставка созданного дополнения
Чтобы ваше дополнение стало частью стандартного процесса доставки дополнений пользователям, необходимо выполнить следующие шаги:
- Обратитесь по адресу support@smath.com для получения прав на запись в публичный SVN репозиторий.
- Зайдите в Менеджер релизов проекта по адресу https://smath.com/ReleaseManager/ и создайте в нём новое дополнение, указав путь к его исходным кодам в публичном SVN репозитории.
- Соберите (кнопка Build) дополнение в Менеджере релизов, проверьте, что в логе нет никаких предупреждений и ошибок. Если предупреждения или ошибки были выявлены, то исправьте их и повторите сборку.
- После успешного прохождения этапа сборки опубликуйте (кнопка Publish) дополнение в реестре дополнений.
- Первый результат публикации дополнения может потребовать проверки и подтверждение со стороны команды SMath. Для ускорения этой процедуры необходимо связаться с разработчиками по адресу e-mail: support@smath.com.
- В итоге дополнение попадёт в реестр дополнений и будет доступно всем пользователям программы SMath Studio через Менеджер расширений, встроенный в программу.