Debian Codegraph @

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

raw
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 ![passo 1 do instalador](images/py3-install-1.png "Ative 'Add Python 3.6 to PATH' e clique em 'Customize installation'")
70
71 ![passo 2 do instalador](images/py3-install-2.png "Funcionalidade Opcional: garanta que 'pip' está ativado")
72
73 ![passo 3 do instalador](images/py3-install-3.png "Opções Avançadas: ative 'Instalar para todos usuários'")
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/