Todos os produtos
Search
Central de documentação

Optimization Solver:Baixe e instale o SDK do Optimization Solver

Última atualização: Sep 06, 2026

O kit de desenvolvimento de software (SDK) do Optimization Solver, chamado MindOpt, é um solver local que você executa na própria máquina. Esta página explica como baixe o pacote correto para sua plataforma, instale-o, configure uma licença e adicionar suporte a Java ou Python.

Importante

Ao baixe o SDK, você concorda com os Alibaba Cloud International Website Terms of Use.

Instalação rápida apenas para Python ou Java

Se precisar apenas da biblioteca Python, instale-a com pip:

pip install mindoptpy

Para usar apenas a biblioteca Java (V2.1 e posteriores), adicione uma dependência Maven ao seu pom.xml. Consulte Instalar suporte a Java para ver as opções de classificador.

Ambas as abordagens dispensam a instalação completa. Para usar o solver de linha de comando, as APIs C, C++, C# ou MATLAB, ou múltiplas APIs de linguagem simultaneamente, baixe o pacote de instalação completo descrito abaixo.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Um sistema operacional compatível (consulte Requisitos do sistema)

  • Acesso de administrador ou permissão de gravação suficiente na máquina de destino

  • Uma conta Alibaba Cloud (necessária para autenticação em cloud)

Baixe o SDK

Versão mais recente: V2.3.0 (lançada em 02/02/2026).

As APIs das versões V0.x e V2.x são majoritariamente incompatíveis. Consulte a documentação da API correspondente à versão instalada.

Plataforma

Arquitetura

V2.3.0

V0.25.1

Linux

linux64x86

Arquivo: mindopt-install-linux64x86-2.3.0.sh — Concordar com os termos e baixe

Arquivo: mindopt-install-linux64x86-0.25.1.sh — Concordar com os termos e baixe

linux64aarch

Arquivo: mindopt-install-linux64aarch-2.3.0.sh — Concordar com os termos e baixe

Arquivo: mindopt-install-linux64aarch-0.25.1.sh — Concordar com os termos e baixe

Windows

windows64

Arquivo: mindopt-2.3.0.msi — Concordar com os termos e baixe

Arquivo: mindopt-0.25.1.msi — Concordar com os termos e baixe

macOS

osx64x86 (Intel)

Arquivo: mindopt-install-osx64x86-2.3.0.sh — Concordar com os termos e baixe

Arquivo: mindopt-install-osx64x86-0.25.1.sh — Concordar com os termos e baixe

osx64aarch (Apple Silicon)

Arquivo: mindopt-install-osx64aarch-2.3.0.sh — Concordar com os termos e baixe

Arquivo: mindopt-install-osx64aarch-0.25.1.sh — Concordar com os termos e baixe

Para logs de alterações e versões anteriores, consulte Download history.

Requisitos do sistema

Sistema operacional

Sistema operacional

Versão mínima

Windows

Windows 10 ou posterior

Linux x86_64

Glibc >= 2,14

Linux aarch64

Glibc >= 2,17

macOS x86_64

macOS 11.0 ou posterior

macOS arm64

macOS 12.0 ou posterior

Versões de linguagem e compilador

Linguagem

Versões/compiladores compatíveis

C

Visual Studio 2019 ou posterior, GCC 4.9 ou posterior, Clang++

C++

Visual Studio 2019 ou posterior, GCC 4.9 ou posterior, Clang++

C#

.NET SDK 8.0 ou posterior

Python

3,8, 3,9, 3,10, 3,11, 3,12, 3,13

Java

JDK 1.8 ou posterior

MATLAB

MATLAB 2021b ou posterior

Instale o SDK

Importante

Antes da instalação, remova ou faça backup de qualquer versão anterior. Consulte Uninstall and reinstall.

Você também pode acompanhar o Video overview.

Windows

Clique duas vezes no arquivo de instalação .msi e siga as instruções na tela.

Para instale para todos os usuários, execute o Prompt de Comando como administrador, acesse a pasta que contém o instalador e execute o arquivo.

Linux

Não sabe qual arquitetura possui? Execute uname -m. A saída x86_64 indica o uso do instalador x86; já aarch64 indica o instalador ARM.

Execute o comando abaixo e siga as instruções:

# x86_64 systems
bash mindopt-install-linux64x86-2.3.0.sh

# ARM (aarch64) systems
bash mindopt-install-linux64aarch-2.3.0.sh

docker

Adicione o seguinte conteúdo ao seu Dockerfile:

# The admin user is used as an example.
RUN cd /home/admin/mindopt/ && \
    bash mindopt-install-linux64x86-2.3.0.sh --target /home/admin/mindopt && \
    rm -rf mindopt-install-linux64x86-2.3.0.sh

# Set the MindOpt environment variables.
ENV MINDOPT_HOME /home/admin/mindopt/2.3.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:$PATH
ENV LD_LIBRARY_PATH $MINDOPT_HOME/linux64-x86/lib:$LD_LIBRARY_PATH

Apenas para instalações docker da versão V0.x.x, adicione também:

# MDO_NATIVE_LIBRARY is required for the Java SDK in V0.x.x. Not needed for V1.0.0 or later.
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1

macOS

Execute o comando abaixo e siga as instruções:

# Intel (x86_64) systems
bash mindopt-install-osx64x86-2.3.0.sh

# Apple Silicon (arm64) systems
bash mindopt-install-osx64aarch-2.3.0.sh

Estrutura de diretórios após a instalação

Após a conclusão da instalação, o diretório conterá os seguintes itens:

Caminho

Descrição

2.3.0/

Pasta raiz nomeada conforme a versão instalada. Várias versões podem coexistir no mesmo diretório pai.

<platform>/

Subpasta com executáveis, bibliotecas de link dinâmico e arquivos relacionados. O nome reflete o sistema operacional e a arquitetura: win64-x86, linux64-x86, osx64-x86, linux64-aarch ou osx64-aarch.

examples/

Exemplos de código para várias linguagens, ferramentas de modelagem e dados de entrada de amostra na subpasta data/. Comece por aqui.

docs/

Arquivo Readme.txt, Contrato de Licença de Usuário Final (EULA) e outros documentos.

fl_client.ini

Arquivo de autenticação criado na próxima etapa.

Directory structure after installation

Verifique a instalação

Verifique as variáveis de ambiente

Windows: O instalador adiciona MINDOPT_HOME e Path automaticamente. Para alternar entre versões instaladas, atualize o valor de MINDOPT_HOME.

Windows environment variables example

Linux e macOS: O instalador adiciona source ~/.mdo_profile aos arquivos ~/.bashrc e ~/.zshrc. As alterações entram em vigor após reiniciar o terminal.

Para aplicá-las imediatamente sem reiniciar:

cat ~/.mdo_profile   # view the current settings
source ~/.mdo_profile

Para alternar entre versões instaladas, edite diretamente o arquivo ~/.mdo_profile:

nano ~/.mdo_profile

Em um container docker, use export para verificar as variáveis.

Execute um teste rápido

Após carregar as variáveis de ambiente, execute mindopt na linha de comando:

mindopt

Uma instalação bem-sucedida exibe informações de versão e uso no terminal, semelhante à saída mostrada aqui:

mindopt command output confirming successful installation

Solução de problemas

Erro de permissão: Se mindopt falhar ao executar, corrija a permissão do executável:

# Linux
chmod u+x $MINDOPT_HOME/linux64-x86/bin/mindopt

# macOS
chmod u+x $MINDOPT_HOME/osx64-x86/bin/mindopt

Bloqueio de segurança do macOS: O macOS pode impedir a execução do binário devido a verificações de segurança do desenvolvedor. Em Security & Privacy, clique em Allow Anyway.

macOS Allow Anyway dialog

Para outros problemas, consulte a seção Installation issues no FAQ.

Configure uma licença

O MindOpt requer um arquivo de licença para funcionar. Escolha um dos dois métodos de autenticação:

Autenticação em cloud (recomendada)

Autenticação offline

Como funciona

Chave de licença vinculada à sua conta Alibaba Cloud; internet necessária apenas para autenticação

Arquivo de licença vinculado a um ID de máquina específico; totalmente offline

Mais indicado para

Maioria dos usuários; especialmente ao usar em múltiplas máquinas

Ambientes isolados ou implantações em máquina única

Múltiplas máquinas

Uma chave funciona em várias máquinas

Apenas máquina única

Renovação

Renove no console sem alterar o arquivo de licença; lembrete por SMS antes do vencimento

Compra de nova licença

Durante a autenticação, o MindOpt busca primeiro o arquivo mindopt.lic e depois o fl_client.ini , com base nas configurações das variáveis de ambiente. Ele valida o primeiro arquivo encontrado. Os nomes dos arquivos de licença são fixos e não podem ser alterados.

Opção 1: Autenticação em cloud (recomendada)

Siga as etapas em Configure an Alibaba Cloud account for authentication para obter uma chave de licença e crie o arquivo de licença fl_client.ini. O solver executa localmente na sua máquina. A conexão com a internet é necessária apenas para autenticação — nenhuma outra informação é enviada.

Opção 2: Autenticação offline

A partir de 2024, o console oferecerá suporte à aquisição de licença de autenticação local para modo standalone offline com concorrência ilimitada. Para mais detalhes, consulte Get a machine fingerprint for the unnetworked single machine unlimited concurrency license.

Defina o local do arquivo de licença

Recomendado: Defina a variável de ambiente MINDOPT_LICENSE_PATH para a pasta que contém o arquivo de licença.

Linux e macOS:

export MINDOPT_LICENSE_PATH=$HOME/mindopt

Windows — defina a variável de ambiente nas Propriedades do Sistema:

Setting MINDOPT_LICENSE_PATH on Windows

Para mais detalhes, consulte License configuration.

Local padrão (se MINDOPT_LICENSE_PATH não estiver definido):

SO

Caminho padrão

Windows

C:\Users\<username>\mindopt\fl_client.ini

Linux

~/mindopt/fl_client.ini

macOS

~/mindopt/fl_client.ini

Instale o suporte a Java

Importante

Conclua a instalação base acima antes de instale o suporte a Java. O SDK Java depende das bibliotecas de link dinâmico do solver.

Escolha o método correspondente à versão do seu SDK:

V2.1 e posteriores — Dependência Maven (recomendada)

Adicione a seguinte dependência ao seu pom.xml. Defina o classifier para corresponder à sua plataforma:

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.1.0-SNAPSHOT</version>
  <classifier>osx-x64</classifier>
  <!-- macOS arm64  : osx-aarch -->
  <!-- linux arm64  : linux-aarch -->
  <!-- linux x86    : linux-x64 -->
  <!-- windows      : win-x64 -->
  <!-- all platforms: portable -->
  <type>jar</type>
</dependency>

V1.0 e posteriores — JAR integrado

O pacote de instalação inclui mindoptj.jar em <MDOHOME>/<VERSION>/<PLATFORM>/lib/mindoptj.jar. Referencie-o diretamente no pom.xml:

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.0.0</version>
  <scope>system</scope>
  <systemPath>${env.MINDOPT_HOME}/osx64-x86/lib/mindoptj.jar</systemPath>
</dependency>

V0.x.x — Dependência Maven

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>[0.24.0, 1.0.0)</version>
</dependency>
Importante

Algumas IDEs (por exemplo, CLion) bloqueiam variáveis de ambiente relacionadas a rpath durante a execução, causando erros quando o programa busca bibliotecas dinâmicas. Especifique o caminho da biblioteca manualmente na configuração de execução da sua IDE. Para CLion no macOS, adicione o seguinte em Run/Debug Configurations: DYLD_LIBRARY_PATH=<MDOHOME>/<VERSION>/<PLATFORM>/lib

Instale o suporte a Python

Importante

A partir da V0.24.1, o comando pip install mindoptpy fornece uma biblioteca Python independente com licença inclusa (válida de 01/01/2023 a 28/02/2025). Esta instalação inclui apenas a biblioteca Python — não contempla o solver de linha de comando, APIs C/C++ ou ferramentas de modelagem. Para esses recursos, conclua a instalação completa acima.

Após a instalação completa, acesse a pasta da biblioteca Python e instale-a:

cd <MDOHOME>/<VERSION>/<PLATFORM>/lib/python
pip install .
A partir da V2.1, Python 3.6 e 3.7 não são mais suportados. Para soluções de erros de importação do módulo mindoptpy ou instruções detalhadas de instalação, consulte o Guia do Usuário .

Desinstale e reinstale

Desinstalação

Windows: Acesse Control Panel > Programs and Features, localize a versão do MindOpt e clique em com o botão direito para desinstalar. Cada versão instalada aparece como uma entrada separada. Se você instalou como administrador, o desinstalador pode não ter permissão para remover as variáveis de ambiente MINDOPT_HOME e Path — remova-as manualmente ou execute o desinstalador como administrador.

Linux e macOS:

  1. Exclua o diretório de instalação (por exemplo, $HOME/mindopt).

  2. Remova a linha source ~/.mdo_profile dos arquivos ~/.bashrc e ~/.zshrc, e então exclua ~/.mdo_profile.

APIs Python:

pip3 uninstall mindoptpy
Se planeja reinstalar posteriormente, faça backup dos seus arquivos de licença antes de exclua o diretório de instalação. Locais padrão de licença: $HOME/mindopt (Linux/macOS) e C:\Users\<username>\mindopt (Windows). A execução de comandos de exemplo pode gerar arquivos de resultado .bas e .sol no diretório de instalação — exclua-os conforme necessário.

Reinstalação

Várias versões do SDK podem coexistir em pastas separadas. Defina as variáveis de ambiente para a versão desejada — nenhuma alteração no arquivo de licença é necessária.

Windows: Clique duas vezes no instalador. As novas configurações de variáveis de ambiente substituem as anteriores. Para alternar entre versões, atualize o diretório na variável de ambiente MINDOPT_HOME.

Linux e macOS: Siga as etapas de instalação acima. Em seguida, atualize o caminho da versão em ~/.mdo_profile ou em ~/.bashrc/~/.zshrc.

Importante

Após reinstalar, feche e reabra a janela do prompt de comando para que as novas variáveis de ambiente entrem em vigor.

Próximos passos