diff options
Diffstat (limited to 'meson/docs/markdown/Getting-meson_zh.md')
-rw-r--r-- | meson/docs/markdown/Getting-meson_zh.md | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/meson/docs/markdown/Getting-meson_zh.md b/meson/docs/markdown/Getting-meson_zh.md new file mode 100644 index 000000000..4a4cb3431 --- /dev/null +++ b/meson/docs/markdown/Getting-meson_zh.md @@ -0,0 +1,56 @@ +# 获取Meson + +Meson基于Python3运行,要求Python版本3.5以上。 如果你的操作系统提供包管理器, 你应该用包管理器安装meson;如果没有包管理器,你应该在[Python主页]下载合适的Python3。相关请参阅[特殊平台的安装特例](#特殊平台的安装特例). + +## 下载Meson + +Meson发行版可在 [GitHub发行页面]下载, 你可以在release的解压目录或者git仓库目录里直接运行 `./meson.py` ,不需要进行任何特殊操作。 + +在Windows下,如果你安装Python时没有将Python路径添加到环境变量, 那你应该使用`python /path/to/meson.py`命令运行Meson,当然`python` 的版本应该大于3.5。 + +最新的开发版本的源码可以直接通过[Git]获得,我们尽可能保证它总是可以正常使用。所有的提交通过pull-request进行,此过程将运行 CI 并且会在多个平台进行测试。 + +## 使用pip安装Meson + +Meson在[Python包索引]中,可通过`pip3 install meson`命令安装,如果在root环境下,它会在系统范围内安装。 + +相反,你也可以使用 `pip3 install --user meson`命令来为`user`用户单独安装,此过程不需要任何特殊权限. Meson会被安装到`~/.local/`目录下,所以你需要将 `~/.local/bin`添加至你的`PATH`. + +## 使用MSI安装包安装Meson和Ninja + +我们也在[GitHub发行页面]提供MSI安装包,可以同时为Windows安装 Meson和Ninja。 它也包含一份嵌入性的Python拷贝, 所以[Python module](Python-module.md)可以不靠任何外部依赖的情况下正如期望般的正常工作。 + +因为这是新特性,请多留意,如果出现BUG欢迎反馈! + +## 所需依赖 + +最主要的, 你需要 [Ninja可执行程序] 来使用Meson默认的 +`ninja` 后端参数。这个参数可以用于所有平台和工具链包括 GCC, Clang, Visual Studio, MinGW,ICC, ARMCC. + +如果可能,你应该使用包管理器提供的版本,否则的话,你应该 +在[Ninja发行页面]下载可执行二进制文件。(https://github.com/ninja-build/ninja/releases). + +如果你只用Visual Studio后端参数 (`--backend=vs`)来生成Windows上的Visual Studio工程文件或者XCode后端参数 (`--backend=xcode`) 生成macOS上的 +XCode工程文件, 那么你不需要安装Ninja. + +# 特殊平台的安装特例 + +## Windows Python3 + +安装Python3时,强烈推荐以下安装器选项 (非必须,请结合实际) : + +![installer step 1](images/py3-install-1.png "Enable 'Add Python 3.6 to PATH' and click 'Customize installation'") +![installer step 2](images/py3-install-2.png "Optional Features: ensure 'pip' is enabled") +![installer step 3](images/py3-install-3.png "Advanced Options: enable 'Install for all users'") + +完成这个之后, `python` 和`pip`的路径会收录进`PATH`,你可以使用pip安装Meson. 你也可以在Windows任何终端下直接运行`meson`而不是不得不输入`py -3`完整路径去运行 `meson.py`脚本. + +## MSYS2 Python3 + +如果你使用MSYS2作为你的Windows开发环境,请确信你**没有**将 `msys/python` 当作你的默认Python使用. 请使用 `mingw32/mingw-w64-i686-python3` 或者 `mingw64/mingw-w64-x86_64-python3`,这取决于MinGW不同的构建对象. + + [GitHub发行页面]: https://github.com/mesonbuild/meson/releases + [Python包索引]: https://pypi.python.org/pypi/meson/ + [Git]: https://github.com/mesonbuild/meson + [Python主页]: https://www.python.org/downloads/ + [Ninja可执行程序]: https://ninja-build.org/ |