MacOS下从源码编译

Python 版本 2.7.15+/3.5.1+/3.6/3.7/3.8 (64 bit)
pip 或 pip3 版本 20.2.2+ (64 bit)

目前仅支持在MacOS环境下编译安装CPU版本的PaddlePaddle

在MacOS系统下有2种编译方式：

本机源码编译

是一个开源的应用容器引擎。使用Docker，既可以将PaddlePaddle的安装&使用与系统环境隔离，也可以与主机共享GPU、网络等资源

使用Docker编译PaddlePaddle，您需要：

在本地主机上安装Docker
使用Docker ID登陆Docker，以避免出现错误

请您按照以下步骤安装：

进入Mac的终端
请选择您希望储存PaddlePaddle的路径，然后在该路径下使用以下命令将PaddlePaddle的源码从github克隆到本地当前目录下名为Paddle的文件夹中：
进入Paddle目录下：
```
cd Paddle
```

创建并进入满足编译环境的Docker容器：

docker run --name paddle-test -v $PWD:/paddle --network=host -it hub.baidubce.com/paddlepaddle/paddle:latest-dev /bin/bash

进入Docker后进入paddle目录下：
```
cd paddle
```
切换到较稳定版本下进行编译：
```
git checkout [分支名]
```
例如：
```
git checkout release/2.0
```
注意：python3.6、python3.7版本从release/1.2分支开始支持, python3.8版本从release/1.8分支开始支持

创建并进入/paddle/build路径下：

mkdir -p /paddle/build && cd /paddle/build

使用以下命令安装相关依赖：

For Python2:
```
pip install protobuf==3.1.0
```
For Python3:
注意：以上用Python3.5命令来举例，如您的Python版本为3.6/3.7/3.8，请将上述命令中的Python3.5改成Python3.6/Python3.7/Python3.8

安装protobuf 3.1.0。
```
apt install patchelf
```
安装patchelf，PatchELF 是一个小而实用的程序，用于修改ELF可执行文件的动态链接器和RPATH。
执行cmake：

具体编译选项含义请参见请注意修改参数-DPY_VERSION为您希望编译使用的python版本, 例如-DPY_VERSION=3.5表示python版本为3.5.x
- 对于需要编译CPU版本PaddlePaddle的用户：
```
cmake .. -DPY_VERSION=3.5 -DWITH_GPU=OFF -DWITH_TESTING=OFF -DWITH_AVX=OFF -DCMAKE_BUILD_TYPE=Release
```
```
make -j$(nproc)
```
使用多核编译
编译成功后进入/paddle/build/python/dist目录下找到生成的.whl包：
```
cd /paddle/build/python/dist
```
在当前机器或目标机器安装编译好的.whl包：

For Python2:

For Python3:
```
pip3.5 install -U（whl包的名字)
```
注意：以上涉及Python3的命令，用Python3.5来举例，如您的Python版本为3.6/3.7/3.8，请将上述命令中的Python3.5改成Python3.6/Python3.7/Python3.8

恭喜，至此您已完成PaddlePaddle的编译安装。您只需要进入Docker容器后运行PaddlePaddle，即可开始使用。更多Docker使用请参见Docker官方文档

注：PaddlePaddle Docker镜像为了减小体积，默认没有安装，您可以在容器中执行 apt-get install -y vim 来安装

本机编译

请严格按照以下指令顺序执行

检查您的计算机和操作系统是否符合我们支持的编译标准：
```
uname -m
```
并且在关于本机中查看系统版本。并提前安装
安装Python以及pip：

请不要使用MacOS中自带Python，我们强烈建议您使用Homebrew安装python(对于Python3请使用pythonpython3.5.x、python3.6.x、python3.7.x、python3.8), pip以及其他的依赖，这将会使您高效编译。

For python2:
```
brew install python@2
```
For python3: 使用Python官网安装

(Only For Python2)设置Python相关的环境变量：

请使用

find / -name libpython2.7.dylib

找到您当前使用python的libpython2.7.dylib路径，并使用

export LD_LIBRARY_PATH=[libpython2.7.dylib的路径] && export DYLD_LIBRARY_PATH=[libpython2.7.dylib所在的目录的上两级目录]

(Only For Python3)设置Python相关的环境变量：
- a. 首先使用
```
find `dirname $(dirname $(which python3))` -name "libpython3.*.dylib"
```
  找到Pythonlib的路径（弹出的第一个对应您需要使用的python的dylib路径），然后（下面[python-lib-path]替换为找到文件路径）
- b. 设置PYTHON_LIBRARIES：
```
export PYTHON_LIBRARY=[python-lib-path]
```
- c. 其次使用找到PythonInclude的路径（通常是找到[python-lib-path]的上一级目录为同级目录的include,然后找到该目录下python3.x或者python2.x的路径），然后（下面[python-include-path]替换为找到路径）
- d. 设置PYTHON_INCLUDE_DIR:
```
export PYTHON_INCLUDE_DIRS=[python-include-path]
```
- e. 设置系统环境变量路径：
```
export PATH=[python-bin-path]:$PATH
```
  （这里[python-bin-path]为将[python-lib-path]的最后两级目录替换为/bin/后的目录)
- f. 设置动态库链接：
```
export LD_LIBRARY_PATH=[python-ld-path]
```
  以及
  （这里[python-ld-path]为[python-bin-path]的上一级目录)
执行编译前请您确认您的环境中安装有编译依赖表中提到的相关依赖，否则我们强烈推荐使用Homebrew安装相关依赖。

MacOS下如果您未自行修改或安装过“编译依赖表”中提到的依赖，则仅需要使用pip安装numpy，protobuf，wheel，使用homebrew安装wget，swig, unrar，另外安装cmake即可
- a. 这里特别说明一下CMake的安装：
  
  CMake我们支持3.10以上版本,推荐使用CMake3.16,请根据以下步骤安装：
  1. 从CMake下载CMake镜像并安装
  2. 在控制台输入
```
sudo "/Applications/CMake.app/Contents/bin/cmake-gui" –install
```
- b. 如果您不想使用系统默认的blas而希望使用自己安装的OPENBLAS请参见FAQ
将PaddlePaddle的源码clone在当下目录下的Paddle的文件夹中，并进入Padde目录下：
切换到较稳定release分支下进行编译：
```
git checkout [分支名]
```
例如：
```
git checkout release/2.0
```
注意：python3.6、python3.7版本从release/1.2分支开始支持, python3.8版本从release/1.8分支开始支持
并且请创建并进入一个叫build的目录下：
```
mkdir build && cd build
```

执行cmake：

具体编译选项含义请参见

对于需要编译CPU版本PaddlePaddle的用户：

For Python2:

cmake .. -DWITH_GPU=OFF -DWITH_TESTING=OFF  -DCMAKE_BUILD_TYPE=Release

For Python3:

cmake .. -DPY_VERSION=3.5 -DPYTHON_INCLUDE_DIR=${PYTHON_INCLUDE_DIRS} \
-DPYTHON_LIBRARY=${PYTHON_LIBRARY} -DWITH_GPU=OFF -DWITH_TESTING=OFF  -DCMAKE_BUILD_TYPE=Release

-DPY_VERSION=3.5请修改为安装环境的Python版本

使用以下命令来编译：
```
make -j4
```
编译成功后进入/paddle/build/python/dist目录下找到生成的.whl包：
```
cd /paddle/build/python/dist
```

在当前机器或目标机器安装编译好的.whl包：

pip install -U（whl包的名字）

或

pip3 install -U（whl包的名字）

恭喜，至此您已完成PaddlePaddle的编译安装

安装完成后您可以使用 python 或 python3 进入python解释器，输入

import paddle

再输入

paddle.utils.run_check()

如果出现PaddlePaddle is installed successfully!，说明您已成功安装。

请使用以下命令卸载PaddlePaddle

CPU版本的PaddlePaddle:

或
```
pip3 uninstall paddlepaddle
```