Criação de extensões

Os programadores externos podem criar por sua conta qualquer tipo de extensão do SMath Studio e, sobretudo, Plugins próprios escritos de acordo com os requisitos específicos de um cliente. Um Plugin pode acrescentar à aplicação novas funções, novos tipos de dados, novos elementos de interface ou integração com sistemas externos, o que faz dele a forma mais poderosa de adaptar o SMath Studio a um fluxo de trabalho específico. Como ponto de partida, pode estudar os Plugins cujo código-fonte é público.

Criar um plugin próprio

Para trabalhar com o código de um plugin próprio no Windows, siga estes passos:

1. Instale a versão atual do SMath Studio.
2. Instale a versão atual do Visual Studio Community.
3. Crie um projeto Class Library (.NET Framework), indicando .NET Framework 2.0 no campo Framework da caixa de diálogo de criação do projeto.
4. Implemente uma ou mais interfaces do SMath Studio que herdam de IPlugin:
   • IPluginLowLevelEvaluationFast - interceção de operadores e funções.
   • IPluginMathNumericEvaluation - interceção do cálculo numérico.
   • IPluginCustomRegion - interceção da criação de um tipo de elemento do documento.
   • IPluginRegionDrawing - interceção de um elemento de fórmula no desenho de uma fórmula matemática.
   • IPluginSaveFileTypes - interceção da gravação do cálculo num ficheiro.
   • IPluginOpenFileTypes - interceção da abertura de um ficheiro de cálculo.
   • IPluginDataInputOutput - personalização do formato dos dados iniciais e dos resultados do cálculo para automatização e integração com outras aplicações.
   • IPluginMenuExtender - extensão do menu principal do programa.
5. Para garantir a máxima compatibilidade do plugin entre plataformas, recomenda-se utilizar a biblioteca SMath Studio Drawing sempre que seja necessário desenhar gráficos.

Depurar um plugin próprio

Durante o desenvolvimento pode ser necessário verificar o funcionamento do código gerado. Para executar o código do plugin no contexto do processo do SMath Studio, siga estes passos:

1. Compile o plugin no Visual Studio no modo Debug (isto também gera os ficheiros de depuração *.pdb).
2. Copie o resultado para a pasta plugins do diretório de instalação do SMath Studio.
3. Execute o programa SMath Studio.
4. Quando precisar de depurar o código, utilize a função do Visual Studio Attach to Process..., disponível no menu Debug.
5. Na caixa de diálogo que se abre, selecione o SMath Studio (normalmente apresentado como Solver.exe) na lista de processos disponíveis e clique no botão Attach.

Tenha em atenção que, após qualquer alteração ao código, é necessário repetir todos os passos descritos.

Distribuir um plugin próprio

Para que o plugin faça parte do processo padrão de distribuição a outros utilizadores, siga estes passos:

1. Carregue o código-fonte do plugin para o repositório SVN público.
2. Abra o Release Manager do projeto em https://smath.com/ReleaseManager/ (é necessário ter iniciado sessão com a conta SMath) e crie aí um novo plugin, indicando o caminho para o respetivo código-fonte no repositório SVN público.
3. Compile o plugin no Release Manager (clique em Build) e verifique se o registo não contém avisos nem erros. Se forem encontrados avisos ou erros, corrija-os e repita a compilação.
4. Depois de concluída com êxito a fase de compilação, publique o plugin (clique em Publish) no registo de plugins.
5. A primeira publicação do plugin pode exigir verificação e aprovação pela equipa SMath. Para acelerar este procedimento, contacte os programadores através do seguinte endereço de correio eletrónico: support@smath.com.
6. Como resultado, o plugin será adicionado ao registo de plugins e ficará disponível para todos os utilizadores do programa SMath Studio através do Gerenciador de extensões integrado no programa.