From 9a37aac00b13b8f69ea9c1c3a9f2024ceec6dce7 Mon Sep 17 00:00:00 2001 From: dolphin8 Date: Thu, 28 Jun 2018 14:49:08 +0800 Subject: [PATCH] add build doc --- Dockerfile | 5 +- doc/build.md | 59 +++++++++++++++++++ ...-arm-neon.cmake => arm-android-neon.cmake} | 0 tools/toolchains/arm-linux-gnueabi.cmake | 2 +- 4 files changed, 63 insertions(+), 3 deletions(-) create mode 100644 doc/build.md rename tools/toolchains/{android-arm-neon.cmake => arm-android-neon.cmake} (100%) diff --git a/Dockerfile b/Dockerfile index 594ee31dd6..82a08b3a27 100644 --- a/Dockerfile +++ b/Dockerfile @@ -28,5 +28,6 @@ RUN apt-get autoremove -y && apt-get clean RUN pip install --upgrade pip RUN pip install wheel && pip install pre-commit RUN ln -s clang-format-5.0 /usr/bin/clang-format -#RUN cd /tmp && curl -O http://mirrors.neusoft.edu.cn/android/repository/android-ndk-r17b-linux-x86_64.zip -#RUN cd /opt && unzip /tmp/android-ndk-r17b-linux-x86_64.zip +# RUN cd /tmp && curl -O http://mirrors.neusoft.edu.cn/android/repository/android-ndk-r17b-linux-x86_64.zip +# RUN cd /opt && unzip /tmp/android-ndk-r17b-linux-x86_64.zip +# ENV NDK_ROOT /opt/android-ndk-r17b diff --git a/doc/build.md b/doc/build.md new file mode 100644 index 0000000000..6a8521b593 --- /dev/null +++ b/doc/build.md @@ -0,0 +1,59 @@ +# 环境搭建 +## 使用 docker +### 1. 安装 docker +安装 docker 的方式，参考官方文档 [https://docs.docker.com/install/](https://docs.docker.com/install/) +### 2. 使用 docker 搭建构建环境 +首先进入 paddle-mobile 的目录下，执行 `docker build` +以 Linux/Mac 为例 (windows 建议在 'Docker Quickstart Terminal' 中执行) +``` +$ docker build -t paddle-mobile:dev - < Dockerfile +``` +使用 `docker images` 可以看到我们新建的 image +``` +$ docker images +REPOSITORY TAG IMAGE ID CREATED SIZE +paddle-mobile dev 33b146787711 45 hours ago 372MB +``` +### 3. 使用 docker 构建 +进入 paddle-mobile 目录，执行 docker run +``` +$ docker run -it --mount type=bind,source=$PWD,target=/paddle-mobile paddle-mobile:dev +root@5affd29d4fc5:/ # cd /paddle-mobile +# 生成构建 android 产出的 Makefile +root@5affd29d4fc5:/ # rm CMakeCache.txt +root@5affd29d4fc5:/ # cmake -DCMAKE_TOOLCHAIN_FILE=tools/toolchains/arm-android-neon.cmake +# 生成构建 linux 产出的 Makefile +root@5affd29d4fc5:/ # rm CMakeCache.txt +root@5affd29d4fc5:/ # cmake -DCMAKE_TOOLCHAIN_FILE=tools/toolchains/arm-linux-gnueabi.cmake +``` +### 4. 设置编译选项 +可以通过 ccmake 设置编译选项 +``` +root@5affd29d4fc5:/ # ccmake . + Page 1 of 1 + CMAKE_ASM_FLAGS + CMAKE_ASM_FLAGS_DEBUG + CMAKE_ASM_FLAGS_RELEASE + CMAKE_BUILD_TYPE + CMAKE_INSTALL_PREFIX /usr/local + CMAKE_TOOLCHAIN_FILE /paddle-mobile/tools/toolchains/arm-android-neon.cmake + CPU ON + DEBUGING ON + FPGA OFF + LOG_PROFILE ON + MALI_GPU OFF + NET googlenet + USE_EXCEPTION ON + USE_OPENMP OFF +``` +修改选项后，按 `c`, `g` 更新 Makefile +### 5. 构建 +使用 make 命令进行构建 +``` +root@5affd29d4fc5:/ # make +``` +### 6. 查看构建产出 +构架产出可以在 host 机器上查看，在 paddle-mobile 的目录下，build 以及 test/build 下，可以使用 adb 指令或者 scp 传输到 device 上执行 + +## 不使用 docker +不使用 docker 的方法，可以直接用 cmake 生成 makefile 后构建。使用 ndk 构建 android 应用需要正确设置 NDK_ROOT。构建 linux 应用需要安装 arm-linux-gnueabi-gcc 或者类似的交叉编译工具，可能需要设置 CC，CXX 环境变量，或者在 tools/toolchains/ 中修改 arm-linux-gnueabi.cmake，或者增加自己需要的 toolchain file。 \ No newline at end of file diff --git a/tools/toolchains/android-arm-neon.cmake b/tools/toolchains/arm-android-neon.cmake similarity index 100% rename from tools/toolchains/android-arm-neon.cmake rename to tools/toolchains/arm-android-neon.cmake diff --git a/tools/toolchains/arm-linux-gnueabi.cmake b/tools/toolchains/arm-linux-gnueabi.cmake index 71e54edd08..ee3cb50796 100644 --- a/tools/toolchains/arm-linux-gnueabi.cmake +++ b/tools/toolchains/arm-linux-gnueabi.cmake @@ -13,4 +13,4 @@ set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) -include("${CMAKE_CURRENT_LIST_DIR}/arm-platform.cmake") +include("${CMAKE_CURRENT_LIST_DIR}/../arm-platform.cmake") -- GitLab