| 1 |
# Obtendo o Meson |
| 2 |
|
| 3 |
Meson é implementado em Python 3, e requer a versão 3.7 ou mais nova. |
| 4 |
se o seu sistema operacional provê um gerenciador de pacotes, você deve |
| 5 |
instalar o Meson com ele. Para plataformas que não tem um gerenciador de |
| 6 |
pacotes, você precisa baixa-lo da [página inicial do Python]. Veja abaixo |
| 7 |
[peculiaridades do Python3 específicas de plataformas](#platformspecific-install-quirks). |
| 8 |
|
| 9 |
## Baixando o Meson |
| 10 |
|
| 11 |
*Releases* do Meson podem ser baixadas da [página de releases do GitHub] |
| 12 |
e você pode executar `./meson.py` de dentro do *release* ou do próprio repositório |
| 13 |
do git sem fazer nada de especial. |
| 14 |
|
| 15 |
No Windows, se você não instalar o Python com a opção do instalador que fazem |
| 16 |
os *scripts* Python executáveis, você vai ter que executar `python |
| 17 |
/path/to/meson.py`, onde `python` é o Python 3.7 ou mais novo. |
| 18 |
|
| 19 |
O código de desenvolvimento mais recente pode ser obtido diretamente do [Git], |
| 20 |
e nós lutamos para garatir que ele vai estar sempre funcionando e usável. Todos |
| 21 |
*commits* passam por um processo de *pull-request* que executa CI e testam diversas |
| 22 |
plataformas. |
| 23 |
|
| 24 |
## Instalando o Meson com o pip |
| 25 |
|
| 26 |
O Meson está disponível no [Indice de Pacotes do Python] e pode ser instalado com |
| 27 |
`sudo pip3 install meson` que requer root e vai instala-lo para todo o sistema. |
| 28 |
|
| 29 |
Se você já baixou uma cópia do código do Meson, você pode instalar com |
| 30 |
`sudo pip3 install path/to/source/root/`. |
| 31 |
|
| 32 |
Como alternativa, você pode usar o `pip3 install --user meson` que vai instalar |
| 33 |
o Meson para o seu usuário e não requer nenhum privilégio especial. Esse comando |
| 34 |
vai instalar o pacote em `~/.local/`, então você terá que adicionar `~/.local/bin` |
| 35 |
para o seu `PATH`, e `sudo meson install` vai estar completamente quebrado já que |
| 36 |
o programa não vai estar disponível para o root. Apeas use uma cópia de usuário do Meson |
| 37 |
se você não se importa sobre instalar os projetos como root. |
| 38 |
|
| 39 |
## Instalando o Meson e o Ninja com o instalador MSI |
| 40 |
|
| 41 |
Nós provemos um instalador MSI na [página de *release* do GitHub] que pode ser usada |
| 42 |
para instalar tanto o Meson quanto o Ninja de uma vez para o Windows. O instalador também |
| 43 |
contém uma cópia integrada do Python, então scripts que usam o [módulo Python](Python-module.md) |
| 44 |
e não tem nenhuma dependência externa vão continuar funcionando como esperado. |
| 45 |
|
| 46 |
Por favor, note que essa é uma funcionalidade nova, então relatórios de bugs são esperados e bem-vindos! |
| 47 |
|
| 48 |
## Dependências |
| 49 |
|
| 50 |
Na maioria dos casos comums, você vai precisar do [executável do Ninja] para usar o *backend* do `ninja`, |
| 51 |
que é o padrão no Meson. Esse *backend* pode ser usado em todas plataformas e com todas **toolchains**, incluindo o GCC, |
| 52 |
Clang, Visual Studio, MinGW, ICC, ARMCC, etc. |
| 53 |
|
| 54 |
Você deve usar a versão provida pelo seu gerenciador de pacotes se possível, caso contrário, |
| 55 |
baixe o binário executável da [página de *release* do projeto Ninja](https://github.com/ninja-build/ninja/releases). |
| 56 |
|
| 57 |
Se você apenas usa o *backend* do Visual Studio (`--backend=vs`) para gerar soluções do Visual Studio no Windows ou o |
| 58 |
*backend* do XCode (`--backend=xcode`) para gerar projetos no macOS, você não precisa do Ninja. |
| 59 |
|
| 60 |
|
| 61 |
|
| 62 |
# Peculiaridades de instalação específicas de plataformas |
| 63 |
|
| 64 |
## Peculiaridades do Python 3 no Windows |
| 65 |
|
| 66 |
Quando estiver instalando o Python 3, é altamente recomendável (mas não obrigatório) |
| 67 |
que você selecione as opções do instalador como a seguir: |
| 68 |
|
| 69 |
 |
| 70 |
|
| 71 |
 |
| 72 |
|
| 73 |
 |
| 74 |
|
| 75 |
Com isso, você terá o `python` e o `pip` no `PATH`, e você poderá instalar o Meson com o pip. Você também vai poder |
| 76 |
executar o comando `meson` em qualquer shell no Windows ao invés de ter que executar `py -3` com o caminho completo para |
| 77 |
o *script* `meson.py`. |
| 78 |
|
| 79 |
## Peculiaridades do Python 3 no MSYS2 |
| 80 |
|
| 81 |
Se você está usando o MSYS2 no Windows como seu ambiente de desenvolvimento, |
| 82 |
por favor se certifique que você não esteja usando o pacote `msys/python` para |
| 83 |
fornecer o Python 3. Uso o `mingw32/mingw-w64-i686-python3` ou o |
| 84 |
If you are using MSYS2 on Windows as your development environment, |
| 85 |
please make sure that you **do not use** the `msys/python` package to |
| 86 |
provide Python 3. Use either `mingw32/mingw-w64-i686-python3` or `mingw64/mingw-w64-x86_64-python3` |
| 87 |
dependendo de para qual *target* do MinGW você está compilando. |
| 88 |
|
| 89 |
[página de *release* do GitHub]: https://github.com/mesonbuild/meson/releases |
| 90 |
[Indice de Pacotes do Python]: https://pypi.python.org/pypi/meson/ |
| 91 |
[Git]: https://github.com/mesonbuild/meson |
| 92 |
[página inicial do Python]: https://www.python.org/downloads/ |
| 93 |
[executável do Ninja]: https://ninja-build.org/ |