aboutsummaryrefslogtreecommitdiffstats
path: root/meson/docs/markdown/Getting-meson_zh.md
diff options
context:
space:
mode:
Diffstat (limited to 'meson/docs/markdown/Getting-meson_zh.md')
-rw-r--r--meson/docs/markdown/Getting-meson_zh.md56
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/