> For the complete documentation index, see [llms.txt](https://changkun.gitbook.io/leapmotion_v2_cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/cpp/ying-yong-cheng-xu-kai-fa/project_setup.md).

# 项目设置

## 项目设置

这篇文章讨论如何向 Python 程序中引入 Python 库。

### 库

LeapMotion 的 Python API 作为 Python 扩展模块提供了一个包含 Python本身及本地代码。Python API 支持 Python 2.7。

|          | Windows                                           | Mac                                           | Linux                                              |
| -------- | ------------------------------------------------- | --------------------------------------------- | -------------------------------------------------- |
| Python模块 | lib/Leap.py                                       | lib/Leap.py                                   | lib/Leap.py                                        |
| 32位本地库   | <p>lib/x86/LeapPython.pyd<br>lib/x86/Leap.dll</p> |                                               | <p>lib/x86/LeapPython.so<br>lib/x86/libLeap.so</p> |
| 64位本地库   | <p>lib/x64/LeapPython.pyd<br>lib/x64/Leap.dll</p> |                                               | <p>lib/x64/LeapPython.so<br>lib/x64/libLeap.so</p> |
| 通用二进制本地库 |                                                   | <p>lib/LeapPython.so<br>lib/libLeap.dylib</p> |                                                    |

你可以在下载的 LeapMotion SDK 包的`lib`文件夹中找到这些库文件。在 WIndows 和 Linux 上，32位 Python 需要使用 x86的库文件，64位的 Python 需要使用 x64 的库文件。

LeapMotion 没有把库作为一个标准的 Python 包直接安装到用户电脑上。而是把库作为你应用的一个内置模块，你应该吧库和你的应用程序一起发布。

### 包含 LeapMotion 模块

为了引入 Leap 模块，这些苦文件必须放置到和 Python 运行时可以找到的地方。最简单的方法就是把库文件和程序代码放到同一个目录中。Python 会在同一个目录里导入这个模块。

如果你想把库放在与你源码不同的目录，你可以在引入模块前把库文件的路径添加到`sys.path`中：

```python
import sys
sys.path.insert(0, "path/to/leap/libraries")
import Leap
```

例如，你项目的文件结构可以像这样：

```
SnakesAndLadders/
    src/
        Snakes.py
        Ladders.py
    lib/
```

你也可以将 LeapMotion 库文件拷贝到`lib`子文件夹中（确保复制的是适合你的平台架构的文件）。比如在 Mac 上，你的项目结构可以这样：

```
SnakesAndLadders/
    src/
        Snakes.py
        Ladders.py
    lib/
        Leap.py
        LeapPython.so
        libLeap.dylib
```

于是你可以使用下面的方法在`Snakes.py`或者`Ladders.py`中引入 Leap 模块：

```python
import sys
sys.path.insert(0, "../lib")
import Leap
```

这种引入的方式假设你的 Python 文件总是运行在当前工作目录下运行。为使得主程序能够从任何位置运行时都能正常工作，你可以使用 Python`inspect`模块获取包含源文件的路径并设置`sys.path`关联到那个文件件：

```python
import os, sys, inspect
src_dir = os.path.dirname(inspect.getfile(inspect.currentframe()))
lib_dir = os.path.abspath(os.path.join(src_dir, '../lib'))
sys.path.insert(0, lib_dir)
import Leap
```

**注意**：如果你开发的程序只为你自己使用，你可以把 Leap 模块和其他需要的库放在任何位置，比如其中一个文件夹放置`sys.path`变量，另一个文件夹是你的`PYTHONPATH`环境变量等等。只需在更新 SDK 的时候你还能记得你把它们放到哪儿了。然而，自从 Leap 模块目前不在 Python 包管理器有效，不推荐吧 LeapMotion 拷贝到 Python 标准模块索引的位置。这样做会导致多个程序尝试安装他们不同的 LeapMotion 库时而发生冲突。

### 支持 32 位和 64 位 Python 架构

要同时支持 Windows 和 Linux 32位及64位架构，你可以运行时检查然后用 `sys.path` 设置正确的文件即可。在 Mac 中，LeapMotion 库是通用二进制的，支持两种架构，这种技术是不需要的。

以 SnakeAndLadders 为例，在程序里你应该吧两种库都分别放到两个文件夹中，例如：

```
SnakesAndLadders/
    src/
        Snakes.py
        Ladders.py
    lib/
        x86/
            Leap.py
            LeapPython.so
            libLeap.so
        x64/
            Leap.py
            LeapPython.so
            libLeap.so
```

然后引入合适的 Leap 模块：

```python
import os, sys, inspect
src_dir = os.path.dirname(inspect.getfile(inspect.currentframe()))
arch_dir = '../lib/x64' if sys.maxsize > 2**32 else '../lib/x86'
sys.path.insert(0, os.path.abspath(os.path.join(src_dir, arch_dir)))

import Leap
```

相同的办法你可以同时支持更多平台。

### 使用不同的 Python 发行版

在 Mac、Linux、或者自荐的 Python 中使用 LeapMotion 的 Python 库，你必须更新 `LeapPython.so` 的加载路径到 Python 的相应实例。

首先，运行`otool`工具来显示当前的加载路径：

```bash
otool -L LeapPython.so
```

显示结果与下面很相似：

```
LeapPython.so:
    @loader_path/LeapPython.so (compatibility version 0.0.0, current version 0.0.0)
    /Library/Frameworks/Python.framework/Versions/2.7/Python (compatibility version 2.7.0, current version 2.7.0)
    @loader_path/libLeap.dylib (compatibility version 0.7.0, current version 2.0.1)
    /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 169.3.0)
    /usr/lib/libstdc++.6.dylib (compatibility version 7.0.0, current version 56.0.0)
```

Python位于 `/Library/Frameworks/Python.framework/Versions/2.7/Python` 这行，它需要用`install_name_tool`工具来修改。

其次，使用 `install_name_tool` 工具把 Python 的路径修改到你所需要的位置，例如：&#x20;

```python
install_name_tool -change /Library/Frameworks/Python.framework/Versions/2.7/Python \
/usr/local/Cellar/python/2.7.5/Frameworks/Python.framework/Versions/2.7/lib/libpython2.7.dylib \
LeapPython.so
```

**注意**：`otool`和`install_name_tool`都是标准的 Linux 和 OS X 命令行工具。

## 为 Python 3 重新编译 LeapPython

LeapMotion SDK 包含的 LeapPython 库文件只支持 Python2.7。然而 SDK 还包含 SWIG 结构文件，它可以用来生成 LeapPython 源代码。所以，高级用户可以生成并编译他们自己的 LeapPython。作为指导，请参考[使用 SWIG2.0.9 生成 Python3.3.0 包](https://support.leapmotion.com/entries/39433657-Generating-a-Python-3-3-0-Wrapper-with-SWIG-2-0-9)。