release/v2.3 源码编译

说明： release/v2.3 之前版本（包括v2.3版本）的源码编译请参考本文档

注意： OpenCL、华为NPU、FPGA、CUDA、X86预测库、CV模块的编译，请见进阶使用指南的对应章节。

如果您还没有配置好相应的源码编译环境，请先根据编译环境准备中的内容，根据您的开发环境安装源码编译所需的编译环境。

下载代码

git clone https://github.com/PaddlePaddle/Paddle-Lite.git
cd Paddle-Lite
git checkout <release-version-tag>

编译模式与参数

编译脚本./lite/tools/build.sh，支持三种编译模式：

编译模式	介绍	适用对象
tiny_publish	编译移动端部署库，无第三方库依赖	用户
full_publish	编译移动端部署库，有第三方依赖如protobuf、glags等，含有可将模型转换为无需protobuf依赖的naive buffer格式的工具，供tiny_publish库使用	用户
test	编译指定arm_os、arm_abi下的移动端单元测试	框架开发者

编译脚本./lite/tools/build.sh，追加参数说明：

参数	介绍	值
--arm_os	必选，选择安装平台	android、ios、ios64、armlinux
--arm_abi	必选，选择编译的arm版本，其中armv7hf为ARMLinux编译时选用	armv8、armv7、armv7hf(仅armlinux支持)
--arm_lang	arm_os=android时必选，选择编译器	gcc、clang(clang当前暂不支持)
--android_stl	arm_os=android时必选，选择静态链接STL或动态链接STL	c++_static、c++_shared
--build_java	可选，是否编译java预测库（默认为ON）	ON、OFF
--build_extra	可选，是否编译全量预测库（默认为OFF）。详情可参考with_extra参数说明。	ON、OFF
target	必选，选择编译模式，tiny_publish为编译移动端部署库、full_publish为带依赖的移动端部署库、test为移动端单元测试、ios为编译ios端tiny_publish	tiny_publish、full_publish、test、 ios

编译代码

提示： 编译过程中，如出现源码编译耗时过长，通常是第三方库下载过慢或失败导致。请在git clone完Paddle-Lite仓库代码后，手动删除本地仓库根目录下的third-party目录。编译脚本会自动下载存储于国内 CDN 的第三方依赖的压缩包，节省从git repo同步第三方库代码的时间。

编译tiny publish动态库

Android

./lite/tools/build.sh \
  --arm_os=android \
  --arm_abi=armv8 \
  --build_extra=OFF \
  --arm_lang=gcc \
  --android_stl=c++_static \
  tiny_publish

iOS

注意： mac环境编译iOS 时，cmake版本需要高于cmake 3.15；mac环境上编译Android时，cmake版本需要设置为cmake 3.10。

./lite/tools/build.sh \
  --arm_os=ios64 \
  --arm_abi=armv8 \
  --build_extra=OFF \
  ios

# 编译选项说明
--arm_os   可选ios或者ios64
--arm_abi  可选armv7和armv8
          （注意：当arm_os=ios时只能选择arm_abi=armv7，当arm_os=ios64时只能选择arm_abi=armv8）

如果mac编译过程中报错：”Invalid CMAKE_DEVELOPER_ROOT: does not exist”, 运行：

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

ARMLinux

./lite/tools/build.sh \
  --build_extra=OFF \
  --arm_os=armlinux \
  --arm_abi=armv7hf \
  --arm_lang=gcc \
  tiny_publish

# 编译选项说明
--arm_abi     树莓派3b使用armv7hf，RK3399使用armv8

编译full publish动态库

Android

./lite/tools/build.sh \
  --arm_os=android \
  --arm_abi=armv8 \
  --build_extra=OFF \
  --arm_lang=gcc \
  --android_stl=c++_static \
  full_publish

ARMLinux

./lite/tools/build.sh \
  --arm_os=armlinux \
  --arm_abi=armv7hf \
  --arm_lang=gcc \
  --build_extra=OFF \
  full_publish

# 编译选项说明
--arm_abi     树莓派3b使用armv7hf，RK3399使用armv8

编译结果说明

编译最终产物位置在 build.lite.xxx.xxx.xxx 下的 inference_lite_lib.xxx.xxx ，如 Android 下 ARMv8 的产物位于inference_lite_lib.android.armv8：

目录内容（可能）如下：

Full_publish编译结果:

Tiny_publish结果:

IOS编译结果:

具体内容说明 (供参考)：

inference_lite_lib.xxx.xxx
├── bin                                           可执行工具文件
│   ├── paddle_code_generator
│   └── test_model_bin
├── cxx                                           C++ 预测库和头文件
│   ├── include                                   C++ 头文件
│   │   ├── paddle_api.h
│   │   ├── paddle_image_preprocess.h
│   │   ├── paddle_lite_factory_helper.h
│   │   ├── paddle_place.h
│   │   ├── paddle_use_kernels.h
│   │   ├── paddle_use_ops.h
│   │   └── paddle_use_passes.h
│   └── lib                                       C++ 库文件
│       ├── libpaddle_api_full_bundled.a          包含 full_api 和 light_api 功能的静态库
│       ├── libpaddle_api_light_bundled.a         只包含 light_api 功能的静态库
│       ├── libpaddle_full_api_shared.so          包含 full_api 和 light_api 功能的动态库
│       └── libpaddle_light_api_shared.so         只包含 light_api 功能的动态库
│
├── demo                                          C++ 和 Java 示例代码
│   ├── cxx                                       C++ 预测库demo
│   └── java                                      Java 预测库demo
│
├── java                                          Java 预测库
│   ├── jar
│   │   └── PaddlePredictor.jar                   Java JAR 包
│   ├── so
│   │   └── libpaddle_lite_jni.so                 Java JNI 动态链接库
│   └── src
│
└── third_party                                   第三方库文件gflags

注意：

• 只有当--arm_os=android 时才会编译出：

  • Java库文件与示例：Java和demo/java

  • 动态库文件:libpaddle_full_api_shared.so,libpaddle_light_api_shared.so

• tiny_publish编译结果不包括 C++ demo和 C++ 静态库，但提供 C++ 的 light_api 动态库、 Jni 动态库和Java demo