Debian Codegraph @

subprojects/meson-docs/docs/markdown/Getting-meson_zh.md

raw
1 # 获取Meson
2
3 Meson基于Python3运行,要求Python版本3.5以上。 如果你的操作系统提供包管理器, 你应该用包管理器安装meson;如果没有包管理器,你应该在[Python主页]下载合适的Python3。相关请参阅[特殊平台的安装特例](#特殊平台的安装特例).
4
5 ## 下载Meson
6
7 Meson发行版可在 [GitHub发行页面]下载, 你可以在release的解压目录或者git仓库目录里直接运行 `./meson.py` ,不需要进行任何特殊操作。
8
9 在Windows下,如果你安装Python时没有将Python路径添加到环境变量, 那你应该使用`python /path/to/meson.py`命令运行Meson,当然`python` 的版本应该大于3.5。
10
11 最新的开发版本的源码可以直接通过[Git]获得,我们尽可能保证它总是可以正常使用。所有的提交通过pull-request进行,此过程将运行 CI 并且会在多个平台进行测试。
12
13 ## 使用pip安装Meson
14
15 Meson在[Python包索引]中,可通过`pip3 install meson`命令安装,如果在root环境下,它会在系统范围内安装。
16
17 相反,你也可以使用 `pip3 install --user meson`命令来为`user`用户单独安装,此过程不需要任何特殊权限. Meson会被安装到`~/.local/`目录下,所以你需要将 `~/.local/bin`添加至你的`PATH`.
18
19 ## 使用MSI安装包安装Meson和Ninja
20
21 我们也在[GitHub发行页面]提供MSI安装包,可以同时为Windows安装 Meson和Ninja。 它也包含一份嵌入性的Python拷贝, 所以[Python module](Python-module.md)可以不靠任何外部依赖的情况下正如期望般的正常工作。
22
23 因为这是新特性,请多留意,如果出现BUG欢迎反馈!
24
25 ## 所需依赖
26
27 最主要的, 你需要 [Ninja可执行程序] 来使用Meson默认的
28 `ninja` 后端参数。这个参数可以用于所有平台和工具链包括 GCC, Clang, Visual Studio, MinGW,ICC, ARMCC.
29
30 如果可能,你应该使用包管理器提供的版本,否则的话,你应该
31 在[Ninja发行页面]下载可执行二进制文件。(https://github.com/ninja-build/ninja/releases).
32
33 如果你只用Visual Studio后端参数 (`--backend=vs`)来生成Windows上的Visual Studio工程文件或者XCode后端参数 (`--backend=xcode`) 生成macOS上的
34 XCode工程文件, 那么你不需要安装Ninja.
35
36 # 特殊平台的安装特例
37
38 ## Windows Python3
39
40 安装Python3时,强烈推荐以下安装器选项 (非必须,请结合实际) :
41
42 ![installer step 1](images/py3-install-1.png "Enable 'Add Python 3.6 to PATH' and click 'Customize installation'")
43 ![installer step 2](images/py3-install-2.png "Optional Features: ensure 'pip' is enabled")
44 ![installer step 3](images/py3-install-3.png "Advanced Options: enable 'Install for all users'")
45
46 完成这个之后, `python` 和`pip`的路径会收录进`PATH`,你可以使用pip安装Meson. 你也可以在Windows任何终端下直接运行`meson`而不是不得不输入`py -3`完整路径去运行 `meson.py`脚本.
47
48 ## MSYS2 Python3
49
50 如果你使用MSYS2作为你的Windows开发环境,请确信你**没有**将 `msys/python` 当作你的默认Python使用. 请使用 `mingw32/mingw-w64-i686-python3` 或者 `mingw64/mingw-w64-x86_64-python3`,这取决于MinGW不同的构建对象.
51
52 [GitHub发行页面]: https://github.com/mesonbuild/meson/releases
53 [Python包索引]: https://pypi.python.org/pypi/meson/
54 [Git]: https://github.com/mesonbuild/meson
55 [Python主页]: https://www.python.org/downloads/
56 [Ninja可执行程序]: https://ninja-build.org/