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

Материал из SMath Wiki
Перейти к навигации Перейти к поиску

Возможности программы 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 через Менеджер расширений, встроенный в программу.