Дополнения к SMath Studio

Возможности программы SMath Studio могут быть расширены путём установки дополнений. Дополнения делятся на коммерческие и сторонние и могут влиять на следующий функционал:

1. Импорт и экспорт документов в формате файлов сторонних приложений.
2. Символьное и численное вычисление.
3. Поддержку дополнительных элементов листа расчётов.
4. Добавление элементов в интерфейс программы (боковую панель и главное меню).

Установка дополнений

Дополнения могут быть загружены и установлены в программу SMath Studio различными способами, при этом способ установки не влияет на предоставляемый функционал. Некоторые дополнения могут требовать подключения к сети Интернет или дополнительных библиотек/программ, установленных в операционной системе. Для доступа к информации о технических требованиях и ограничениях, пожалуйста, ознакомьтесь с инструкцией к самим дополнениям.

Онлайн установка

Для онлайн установки дополнений необходимо:

1. Открыть Менеджер расширений (используя главное меню "Сервис" > "Дополнения...");
2. Перейдите на закладку "Дополнения" и переключите источник с "Локальное хранилище" в "Галерея онлайн";
3. Выберите необходимое дополнение из списка и нажмите "Установить";
4. Дополнения будут установлены и готовы к использованию.

Офлайн установка

Для установки дополнений в офлайн режиме необходимо:

1. Используя любой ПК с подключенной сетью Интернет:
   • перейдя на страницу Профиль пользователя - SMath убедитесь, что вы используете учётную запись, указанную в электронной лицензии;
   • перейдите на страницу: Дополнения SMath Studio;
   • скачайте интересующие вас дополнения в ZIP формате;
   • обратите внимание, что нет необходимости разархивировать скачанные ZIP файлы.
2. На ПК с установленной программой SMath Studio без подключения к сети Интернет:
   • перенесите скачанные файлы на ПК;
   • используя drag'n'drop перенесите дополнения по одному в основное окно программы;
   • дополнения будут установлены.

Разработка дополнений

Для сторонних разработчиков мы предоставляем возможность создания новых дополнений согласно требованиям заказчика. В качестве примера можно использовать дополнения, для которых доступны исходные коды. Репозиторий доступен по адресу SVN репозиторий SMath.

Получение доступа к репозиторию

Инструкция для получения исходного кода открытых дополнений:

1. Скачайте SVN клиента: TortoiseSVN.
2. Установите скачанную программу (может потребоваться перезагрузка).
3. Создайте на своем ПК папку, в которой вы хотите хранить исходники.
4. Щелкните правой кнопкой мыши по созданной папке и выберите пункт "SVN Checkout..." из контекстного меню папки.
5. Заполните текстовые поля в появившемся диалоговом окне (обычно требуется указать только URL-адрес репозитория) и нажмите кнопку ОК.

   https://smath.com/svn/public

6. Доступные исходные файлы будут загружены.

Создание дополнения

Для работы с кодом дополнений на ОС Windows, пожалуйста, выполните следующие шаги:

1. Установите текущую актуальную версию SMath Studio.
2. Установите текущую актуальную версию Visual Studio Community.
3. Создайте проект "Class Library (.Net Framework)", указав .Net Framework 2.0 в поле Framework в диалоге создания проекта.
4. Реализуйте один или несколько интерфейсов SMath Studio, унаследованных от IPlugin:
   • IPluginLowLevelEvaluationFast - перехват вычисления операторов и функций.
   • IPluginMathNumericEvaluation - перехват численных вычислений.
   • IPluginCustomRegion - создание типа элемента листа.
   • IPluginRegionDrawing - отрисовка элемента формулы в математической формуле.
   • IPluginSaveFileTypes - сохранение расчёта в файл.
   • IPluginOpenFileTypes - открытие расчёта из файла.
   • IPluginDataInputOutput - формат задания начальных данных и результатов расчёта для автоматизации и интеграции с другими приложениями.
   • IPluginMenuExtender - расширение главного меню программы.

Доставка созданного дополнения

Чтобы ваше дополнение стало частью стандартного процесса доставки дополнений пользователям, необходимо выполнить следующие шаги:

1. Обратитесь по адресу support@smath.com для получения прав на запись в публичный SVN репозиторий.
2. Зайдите в Менеджер релизов проекта по адресу https://smath.com/ReleaseManager/ и создайте в нём новое дополнение, указав путь к его исходным кодам в публичном SVN репозитории.
3. Соберите (кнопка Build) дополнение в Менеджере релизов, проверьте, что в логе нет никаких предупреждений и ошибок. Если предупреждения или ошибки были выявлены, то исправьте их и повторите сборку.
4. После успешного прохождения этапа сборки опубликуйте (кнопка Publish) дополнение в реестре дополнений.
5. Первый результат публикации дополнения может потребовать проверки и подтверждение со стороны команды SMath. Для ускорения этой процедуры необходимо связаться с разработчиками по адресу e-mail: support@smath.com.
6. В итоге дополнение попадёт в реестр дополнений и будет доступно всем пользователям программы SMath Studio через Менеджер расширений, встроенный в программу.