STPython 安装

STPython 可以运行在任何安装了 python 的平台上。可以使用安装包安装,STPython安装包在神通安装目录下的drivers/STPython目录中。 另外需要保证 ACI 和 STPython 版本一致,都是 32 位或都是 64 位。 STPython 的运行需要使用 ACI 动态库,用户应将 ACI 所在目录(一般为 神通 安装目录 中的 bin 目录)加入系统环境变量。

安装python

安装STPython

在$SZ_OSCAR_HOME/drivers/STPython目录中找到对应的whl文件,使用pip安装即可。

pip install xxx.whl

另外,如果用户不能用pip安装,可按照zip解压方式将whl文件解压,将STPython模块库拷贝到对应Python的对应模块目录

具体操作如下:

1、 将xxx.whl文件名后缀改成 rar或zip,即xxx.rar或xxx.zip,然后解压。

2、 找到解压缩文件夹里的STPython库文件。windows里是: STPython.xxx.pyd文件,linux里则是STPython.xxx.so文件。将STPython库文件复制进$python\Lib\site-packages(如: D:\Python38\Lib\site-packages)中。

安装aci

在$SZ_OSCAR_HOME/drivers/aci 中找到aci.dll(windows),libaci.so(linux)。Windows中将aci.dll 加入到系统的PATH里; linux的话,将libaci.so所在的文件夹路径加入到$LD_LIBRARY_PATH 变量里。

判断依赖的aci库的位置

Linux中,当多个aci库文件时,需要判断当前STPython依赖的哪个aci库文件。 首先找到STPython的库文件,(通过pip install xxx.whl方式安装的STPython,在python安装目录里的site-packages下有个STPython.xxx.so文件),再用ldd命令查看当前STPython包依赖的那个aci库文件。下列是个实际操作的例子

第一步: 找到STPython库文件

../../../../_images/install_stpython_1.png

第二步:ldd命令查看依赖库文件

../../../../_images/install_stpython_2.png

这里可以看到依赖的aci库文件路径。如果没找到aci库文件,会显示not find

../../../../_images/install_stpython_3.png

这种情况,需要把libaci.so路径加入到LD_LIBRARY_PATH环境变量中,如在当前终端中执行命令: export LD_LIBRARY_PATH=/opt/stpython/lib/linux64/release,会将LD_LIBRARY_PATH变量生效于当前会话中,如果想要永久生效,请把export LD_LIBRARY_PATH=xxx 写入到/etc/profile 或~/.bashrc中。

windows下,可用排除法判断STPython依赖的哪个aci 库文件 , 虽然通过排除法可以找到依赖的aci文件,但不建议系统中存多个版本的aci文件,避免不必要的麻烦。

验证STPython是否安装成功和查看版本

终端中输入python,进入python环境,导入STPython包,如下:

../../../../_images/verify_version.png