Дополнения к SMath Studio: различия между версиями

Материал из SMath Wiki
Перейти к навигации Перейти к поиску
 
(не показано 7 промежуточных версий этого же участника)
Строка 6: Строка 6:


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


Строка 23: Строка 23:
#* скачайте интересующие вас дополнения в ZIP формате;
#* скачайте интересующие вас дополнения в ZIP формате;
#* обратите внимание, что нет необходимости разархивировать скачанные ZIP файлы.
#* обратите внимание, что нет необходимости разархивировать скачанные ZIP файлы.
# На ПК с установленной программой SMath Studio без подключения к сети Интернет:
# На ПК с установленной программой [[SMath Studio]] без подключения к сети Интернет:
#* перенесите скачанные файлы на ПК;
#* перенесите скачанные файлы на ПК;
#* используя drag'n'drop перенесите дополнения по одному в основное окно программы;
#* используя drag'n'drop перенесите дополнения по одному в основное окно программы;
Строка 29: Строка 29:


== Разработка дополнений ==
== Разработка дополнений ==
Для сторонних разработчиков мы предоставляем возможность создания новых дополнений согласно требованиям заказчика. В качестве примера можно использовать дополнения, для которых доступны [[Открытый исходный код|открытые исходные коды]].
Для сторонних разработчиков мы предоставляем возможность создания новых дополнений согласно требованиям заказчика. Пожалуйста, ознакомьтесь с основной статьёй по [[Создание дополнений к SMath Studio|созданию дополнений к SMath Studio]].
 
=== Создание дополнения ===
Для работы с кодом дополнений на ОС Windows, пожалуйста, выполните следующие шаги:
# Установите текущую актуальную версию [https://smath.com/ru-RU/view/SMathStudio/download SMath Studio].
# Установите текущую актуальную версию [https://visualstudio.microsoft.com/ru/vs/community/ Visual Studio Community].
# Создайте проект "Class Library (.Net Framework)", указав .Net Framework 2.0 в поле Framework в диалоге создания проекта.
# Реализуйте один или несколько интерфейсов SMath Studio, унаследованных от IPlugin:
#* '''IPluginLowLevelEvaluationFast''' - перехват вычисления операторов и функций.
#* '''IPluginMathNumericEvaluation''' - перехват численных вычислений.
#* '''IPluginCustomRegion''' - создание типа элемента листа.
#* '''IPluginRegionDrawing''' - отрисовка элемента формулы в математической формуле.
#* '''IPluginSaveFileTypes''' - сохранение расчёта в файл.
#* '''IPluginOpenFileTypes''' - открытие расчёта из файла.
#* '''IPluginDataInputOutput''' - формат задания начальных данных и результатов расчёта для автоматизации и интеграции с другими приложениями.
#* '''IPluginMenuExtender''' - расширение главного меню программы.
 
=== Отладка дополнения ===
В процессе разработки возникает необходимость проверки работоспособности созданного исходного кода. Для того, чтобы выполнить код вашего дополнения в контексте процесса [[SMath Studio]] выполните следующие шаги:
# Создайте сборки вашего дополнения в Visual Studio в режиме ''Debug'' (при этом будут также сгенерированы отладочные *.pdb файлы).
# Скопируйте выходные результаты в папку plugins, находящуюся в установочной директории программы [[SMath Studio]].
# Запустите программу [[SMath Studio]].
# При необходимости отладки с использованием точек останова используйте следующую функцию Visual Studio: ''Attach to Process...'', доступную в меню ''Debug''.
# В открывшемся диалоговом окне в списке доступных процессов выберите программу [[SMath Studio]] (обычно это - Solver.exe) и нажмите кнопку ''Attach''.
 
Обратите внимание, что после любого изменения кода необходимо повторить все описанные действия.
 
=== Доставка созданного дополнения ===
Чтобы ваше дополнение стало частью стандартного процесса доставки дополнений пользователям, необходимо выполнить следующие шаги:
# Обратитесь по адресу [mailto:support@smath.com support@smath.com] для получения прав на запись в [[Открытый исходный код|публичный SVN репозиторий]].
# Зайдите в [[Менеджер релизов]] проекта по адресу https://smath.com/ReleaseManager/ и создайте в нём новое дополнение, указав путь к его исходным кодам в [[Открытый исходный код|публичном SVN репозитории]].
# Соберите (кнопка ''Build'') дополнение в [[Менеджер релизов|Менеджере релизов]], проверьте, что в логе нет никаких предупреждений и ошибок. Если предупреждения или ошибки были выявлены, то исправьте их и повторите сборку.
# После успешного прохождения этапа сборки опубликуйте (кнопка ''Publish'') дополнение в реестре дополнений.
# Первый результат публикации дополнения может потребовать проверки и подтверждение со стороны команды SMath. Для ускорения этой процедуры необходимо связаться с разработчиками по адресу e-mail: [mailto:support@smath.com support@smath.com].
# В итоге дополнение попадёт в реестр дополнений и будет доступно всем пользователям программы [[SMath Studio]] через [[Менеджер расширений]], встроенный в программу.


[[Category:Руководство]]
[[Category:Руководство]]

Текущая версия от 08:35, 11 января 2025

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

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

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

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

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

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

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

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

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

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

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

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