V0.19.0以及之前版本的求解器SDK,在安装时候需要手动设置些环境变量。请查阅本文档安装方法。
从V0.20.0开始,Linux和macOS的软件安装包设置了自动安装步骤简化流程。
如果您需要安装旧的版本,可参考如下动作更换掉2. 安装:基础安装,能支持C、C++接口APIs和 3. 配置环境变量安装步骤。
替换步骤2. 安装:基础安装,能支持C、C++接口APIs
安装前,请参考7. 卸载和重装来清除或备份之前的版本。请注意将后面的示例指令中的0.19.0版本号更换为自己要装的版本号。
Java和Python的安装需要完成此步骤后,再安装后文的对应支持。
Windows系统:
双击安装文件,根据指引安装。
安装时,如果需要为所有用户安装,需要按住 shift 同时右击安装包,选择“以管理员身份运行”,并在后续取消勾选“Install MindOpt for current user only”。或者以管理员身份运行“命令提示符”,然后目录切换到安装包所在文件夹,执行安装包文件。
Linux系统:
系统命令行中输入指令示意如下。
使用bash执行的:
bash mindopt-install-linux-0.19.0.sh --target $HOME/mindopt
或使用zsh执行的:
zsh mindopt-install-linux-0.19.0.sh --target $HOME/mindopt
macOS系统:
同Linux系统,系统命令行中输入指令示意如下,其中target地址可修改为自己想要的安装地址。
使用bash执行的:
bash mindopt-install-osx-0.19.0.sh --target $HOME/mindopt
或使用zsh执行的:
zsh mindopt-install-osx-0.19.0.sh --target $HOME/mindopt
求解器安装后的文件目录结构如下图示意,会包含:
0.19.0
根文件夹,代表不同的软件版本号,可以支持多版本同时存在安装。osx64-x86
子文件夹,里面是可执行文件、动态库等。这个文件夹名称有3种,对应不同系统版本:win64-x86
、linux64-x86
、osx64-x86
,便于查验是否安装了正确的系统版本。examples
文件夹,里面是多种编程语言、建模工具和示例输入数据data
,帮助您快速掌握。最后的
fl_client.ini
是用户要创建的鉴权文件,后文会讲述它。
替换步骤3. 配置环境变量
求解器的安装目录结构是<MDOHOME>/<VERSION>/<PLATFORM>/
,对应的<>中的内容需要修改为您的安装地址、版本号、系统号。请参考下面的配置添加环境变量,您如果重新安装或者安装多版本,可根据自己的情况来修改生效的版本号。
Linux系统:
环境变量添加内容如下示意(环境变量文件修改方式见后文):
export MINDOPT_HOME=$HOME/mindopt/0.19.0/
export LD_LIBRARY_PATH="$MINDOPT_HOME/linux64-x86/lib/"${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}
export PATH="$MINDOPT_HOME/linux64-x86/bin/"${PATH:+:$PATH}
macOS系统:
环境变量添加内容如下示意(环境变量文件修改方式见后文):
export MINDOPT_HOME=$HOME/mindopt/0.19.0/
export DYLD_LIBRARY_PATH="$MINDOPT_HOME/osx64-x86/lib/"${DYLD_LIBRARY_PATH:+:$DYLD_LIBRARY_PATH}
export PATH="$MINDOPT_HOME/osx64-x86/bin/"${PATH:+:$PATH}
Linux和macOS系统环境变量文件修改方式如下示意:
使用bash执行的:
nano ~/.bashrc
source ~/.bashrc
或使用zsh执行的:
nano ~/.zshrc
source ~/.zshrc
配置完环境变量后,可在命令行中输入mindopt来验证是否安装成功。截图示意如下:
运行失败的常见异常处理方式:
如果执行失败,很可能是权限问题,可通过以下方式更改可执行文件的权限:
Linux:
chmod u+x $MINDOPT_HOME/linux64-x86/bin/mindopt
macOS:
chmod u+x $MINDOPT_HOME/osx64-x86/bin/mindopt
有些系统可能会由于开发者安全校验不能同意运行mindopt,如macOS可在安全性与隐私可点击仍然允许。如下图所示。更多异常可查询常见问题FAQ中安装问题。