Skip to content

Latest commit

 

History

History
116 lines (88 loc) · 3.87 KB

build-from-source.zh.md

File metadata and controls

116 lines (88 loc) · 3.87 KB
Raw

Building from Source

一、安装依赖

安装 Rust

$ sudo apt install curl
$ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

成功后，cargo 应该可以正常执行

$ cargo --version
cargo 1.53.0 (4369396ce 2021-04-27)

如果不成功，提示Command 'cargo' not found，可以按照提示加载一下环境变量(重新连接或打开终端也可以)：

source $HOME/.cargo/env

cargo 是 Rust 的包管理器兼编译辅助工具。类似 Java maven/go pkg/C++ CMake 的角色，更易使用。

安装 python3.x （推荐 conda）

打开 miniconda 官网 下载 miniconda 安装包，修改权限并安装。

$ wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
$ chmod a+x Miniconda3-latest-Linux-x86_64.sh
$ ./Miniconda3-latest-Linux-x86_64.sh

安装时接受 conda 修改默认 .bashrc 环境变量（zsh 用户还需自行修改 .zshrc 中的 conda initialize 配置）。成功后 conda 可正常运行

$ conda --version
conda 4.10.3

创建一个 Python3.x（这里以 3.8 为例） 的环境，激活。

$ conda create --name py38 python=3.8
$ conda activate py38

二、编译

MegFlow 需要编译 ffmpeg。考虑到 ffmpeg 依赖较多、本身又是常用工具，最简单的办法就是直接装 ffmpeg 把编译依赖装上

$ sudo apt install yasm git build-essential ffmpeg
$ ffmpeg 
ffmpeg version 3.4.8...
$ sudo apt install clang
$ clang --version
clang version 6.0.0-1ubuntu2...

编译底层 Rust 组件，安装 Python module

$ git clone --recursive https://github.com/MegEngine/MegFlow --depth=1
$ cd MegFlow
$ cargo build
waiting ...
$ cd flow-python
$ python3 setup.py install --user

常见问题：error while loading shared libraries: libpython3.8.xxx，意为 libpython.so 找不到。如果使用 conda 就在 miniconda 安装目录下面，只需要设置环境变量

$ export LD_LIBRARY_PATH=`conda info --base`/pkgs/python-3.8.11-xxx/lib:${LD_LIBRARY_PATH}

P.S. 默认 ffmpeg 依赖自动从 github 上拉取源码构建，这会使得首次构建的时间较长。若希望缩短首次构建时间，或者希望依赖一个指定版本的 ffmpeg，可以启用环境变量CARGO_FEATURE_PREBUILD并参考rust-ffmpeg自行构建

三、Python“开机自检”

$ cd examples
$ cargo build --example run_with_plugins --release # 编译出 megflow bin
$ ln -s ../../target/example/run_with_plugins
$ ./run_with_plugins -p logical_test

logical_test 是 examples 下最基础的计算图测试用例，运行能正常结束表示 MegFlow 编译成功、基本语义无问题。

run_with_plugins 是计算图的实现。编译完成之后不再需要 cargo 和 Rust，使用者只需要

  • import megflow成功
  • run_with_plugins -h 正常

四、Python Built-in Applications

接下来开始运行好玩的 Python 应用

  • 猫猫围栏运行手册
    • 图片注册猫猫
    • 部署视频围栏，注册的猫离开围栏时会发通知
    • 未注册的不会提示
  • 电梯电瓶车告警
    • 电梯里看到电瓶车立即报警
  • Comming Soon
    • OCR： 通用字符识别

五、其他选项

$ cargo run --example graph -- ${args} # 测试 MegFlow 的延迟/吞吐/调度开销, 更多使用说明通过--help 查看
$ cargo run --example run_with_plugins -- ${args} # 基于插件 + 参数文件形式运行 MegFlow, 更多说明通过--help 查看
$ export RUST_LOG=LOG_LEVEL // 设置日志级别, 例如 INFO, TRACE..
$ cargo build [--release] // 编译
$ cargo check // 快速编译，不执行 link
$ cargo test [target] // 执行单元测试