@@ -13,73 +13,28 @@ See :ref:`install-nightly-win-dist`. See also :ref:`upgrade-win-dist`.
13
13
.. warning ::
14
14
15
15
Python 3.5 is currently not supported on Windows due to issues with MinGW and
16
- Python 3.5.
16
+ Python 3.5. Support is not expected for some time. See
17
+ `here <http://bugs.python.org/issue4709 >`_ for details. If required,
18
+ 3.5 MSVC builds should be posssible, but have not been attempted.
17
19
18
- What are wheels, pip and wheel
19
- ------------------------------
20
-
21
- To install Kivy wheels, `Python <https://www.python.org/downloads/windows/ >`_ first
22
- needs to be installed. Multiple versions of Python can be installed side by side.
23
-
24
- In Python, packages such as Kivy can be installed with the python package
25
- manager, `pip <https://pip.pypa.io/en/stable/ >`_. Some packages such as Kivy
26
- require additional steps, such as compilation, when installing using the Kivy
27
- source code with pip. Wheels (with a ``.whl `` extension) are pre-built
28
- distributions of a package that has already been compiled and do not require
29
- additional steps to install.
30
-
31
- When hosted on `pypi <https://pypi.python.org/pypi >`_ one installs a wheel
32
- using ``pip ``, e.g. ``python -m pip install kivy ``. When downloading and installing
33
- a wheel directly, ``python -m pip install wheel_file_name `` is used, such as:
34
-
35
- ``python -m pip install C:\Kivy-1.9.1.dev-cp27-none-win_amd64.whl ``
36
-
37
-
38
- Kivy's dependencies
39
- -------------------
40
-
41
- We offer wheels for Kivy and its dependencies separately so only desired
42
- dependencies need be installed. The dependencies are offered as
43
- `namespace <https://www.python.org/dev/peps/pep-0420/ >`_
44
- packages of Kivy.deps, e.g. ``kivy.deps.sdl2 ``.
45
-
46
- Currently on Windows, we provide the following dependency
47
- wheels: ``gstreamer `` for audio and video and `glew ` and ``sdl2 `` for graphics
48
- and control. ``gstreamer `` is an optional dependency which only needs to be
49
- installed if video display is desired.
50
-
51
- Command line
52
- ------------
53
-
54
- Know your command line. To execute any of the ``pip ``
55
- or ``wheel `` commands, one needs a command line tool with python on the path.
56
- The default command line on Windows is
57
- `CMD <http://www.computerhope.com/issues/chusedos.htm >`_, but we recommend
58
- `Git for Windows <https://git-for-windows.github.io/ >`_ which offers a bash
59
- command line as `well <http://rogerdudler.github.io/git-guide/ >`_ as
60
- `git <https://try.github.io >`_. Note, CMD can still be used even if bash is
61
- installed.
62
-
63
- Walking the path! To add your python to the path, simply open your command line
64
- and then us the ``cd `` command to change the current directory to where python is
65
- installed, e.g. ``cd C:\Python27 ``. Alternatively if you only have one python
66
- version installed, permanently add the python directory to the path for
67
- `CMD <http://www.computerhope.com/issues/ch000549.htm >`_ for
68
- `bash <http://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux >`_.
20
+ To use Kivy you need `Python <https://www.python.org/downloads/windows/ >`_.
21
+ Multiple versions of Python can be installed side by side, but Kivy needs to
22
+ be installed for each Python version that you want to use Kivy.
69
23
70
24
.. _install-win-dist :
71
25
72
26
Installation
73
27
------------
74
28
75
- Now that python is available on the command line, which can checked by typing
76
- ``python --version ``, do the following to install.
29
+ Now that python is installed, open the :ref: ` Command line` and make sure python
30
+ is available by typing ``python --version ``. Then , do the following to install.
77
31
78
32
#. Ensure you have the latest pip and wheel::
79
33
80
34
python -m pip install --upgrade pip wheel setuptools
81
35
82
- #. Install the dependencies (skip gstreamer (~90MB) if not needed)::
36
+ #. Install the dependencies (skip gstreamer (~90MB) if not needed, see
37
+ :ref: `Kivy's dependencies `)::
83
38
84
39
python -m pip install docutils pygments pypiwin32 kivy.deps.sdl2 kivy.deps.glew \
85
40
kivy.deps.gstreamer --extra-index-url https://kivy.org/downloads/packages/simple/
@@ -101,7 +56,7 @@ Nightly wheel installation
101
56
issues during development. If you encounter any bugs, please report them.
102
57
103
58
Snapshot wheels of current Kivy master are created every night. They can be found
104
- `here <https://drive.google.com/drive/folders/ 0B1_HB9J8mZepOV81UHpDbmg5SWM >`_.
59
+ `here <https://drive.google.com/folderview?id= 0B1_HB9J8mZepOV81UHpDbmg5SWM&usp=sharing >`_.
105
60
To use them, instead of doing `python -m pip install kivy ` we'll install one of
106
61
these wheels as follows.
107
62
@@ -113,6 +68,59 @@ these wheels as follows.
113
68
#. Install it with ``python -m pip install wheel-name `` where ``wheel-name ``
114
69
is the name of the renamed file.
115
70
71
+
72
+ Kivy's dependencies
73
+ -------------------
74
+
75
+ We offer wheels for Kivy and its dependencies separately so only desired
76
+ dependencies need be installed. The dependencies are offered as
77
+ `namespace <https://www.python.org/dev/peps/pep-0420/ >`_
78
+ packages of Kivy.deps, e.g. ``kivy.deps.sdl2 ``.
79
+
80
+ Currently on Windows, we provide the following dependency
81
+ wheels: ``gstreamer `` for audio and video and `glew ` and ``sdl2 `` for graphics
82
+ and control. ``gstreamer `` is an optional dependency which only needs to be
83
+ installed if video display or audio is desired.
84
+
85
+ What are wheels, pip and wheel
86
+ ------------------------------
87
+
88
+ In Python, packages such as Kivy can be installed with the python package
89
+ manager, `pip <https://pip.pypa.io/en/stable/ >`_. Some packages such as Kivy
90
+ require additional steps, such as compilation, when installing using the Kivy
91
+ source code with pip. Wheels (with a ``.whl `` extension) are pre-built
92
+ distributions of a package that has already been compiled and do not require
93
+ additional steps to install.
94
+
95
+ When hosted on `pypi <https://pypi.python.org/pypi >`_ one installs a wheel
96
+ using ``pip ``, e.g. ``python -m pip install kivy ``. When downloading and installing
97
+ a wheel directly, ``python -m pip install wheel_file_name `` is used, such as::
98
+
99
+ python -m pip install C:\Kivy-1.9.1.dev-cp27-none-win_amd64.whl
100
+
101
+ Command line
102
+ ------------
103
+
104
+ Know your command line. To execute any of the ``pip ``
105
+ or ``wheel `` commands, one needs a command line tool with python on the path.
106
+ The default command line on Windows is
107
+ `CMD <http://www.computerhope.com/issues/chusedos.htm >`_, and the quickest way
108
+ to open it is to press `Win+R ` on your keyboard, type ``cmd ``
109
+ in the window that opens, and then press enter.
110
+
111
+ Alternate linux style command shells that we reccomend is
112
+ `Git for Windows <https://git-for-windows.github.io/ >`_ which offers a bash
113
+ command line as `well <http://rogerdudler.github.io/git-guide/ >`_ as
114
+ `git <https://try.github.io >`_. Note, CMD can still be used even if bash is
115
+ installed.
116
+
117
+ Walking the path! To add your python to the path, simply open your command line
118
+ and then us the ``cd `` command to change the current directory to where python is
119
+ installed, e.g. ``cd C:\Python27 ``. Alternatively if you only have one python
120
+ version installed, permanently add the python directory to the path for
121
+ `CMD <http://www.computerhope.com/issues/ch000549.htm >`_ for
122
+ `bash <http://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux >`_.
123
+
116
124
.. _dev-install-win :
117
125
118
126
Use development Kivy
0 commit comments