Rooba
/
pyjnius
mirror of https://github.com/kivy/pyjnius.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #361 from kivy/docs_win_install 

Update installation instructions
This commit is contained in:
Mathieu Virbel 2018-10-24 13:55:11 +02:00 committed by GitHub
parent fdd7e00a4b 15eb4fa069
commit 5e19dbe425
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 53 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
docs/source/installation.rst
View File

@ -3,15 +3,16 @@
Installation
============
Pyjnius depends on `Cython <http://cython.org/>`_ and `Java
<http://www.oracle.com/javase>`_.
PyJNIus depends on `Cython <http://cython.org/>`_ and `Java
<http://www.oracle.com/javase>`_ Development Kit (includes Java Runtime
Environment).
Installation on the Desktop
---------------------------
Installation on GNU/Linux distributions
---------------------------------------
You need the Java JDK and JRE installed (openjdk will do), and Cython. Then,
just type::
You need GNU Compiler Collection (GCC), the JDK and JRE installed (openjdk will
do), and Cython. Then, just type::
sudo python setup.py install
@ -49,30 +50,61 @@ pyjnius to the requirements argument when creating a dist or apk::
Installation for Windows
------------------------
Python and pip must be installed and present in PATH.
Python and pip must be installed and present in ``PATH`` environment variable.
1. Download and install JDK and JRE:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
1. Download and install JDK containing JRE:
2. Edit your system and environment variables (use the appropriate Java version):
Add to Environment Variables:
* ``JDK_HOME``: C:\\Program Files\\Java\\jdk1.7.0_79\\
* ``PATH``: C:\\Program Files\\Java\\jdk1.7.0_79\\jre\\bin\\server\\
Add to System Variables:
* ``PATH``: C:\\Program Files\\Java\\jdk1.7.0_79\\bin\\`
http://www.oracle.com/technetwork/java/javase/downloads/index.html
3. Download and install Microsoft Visual C++ Compiler for Python 2.7:
http://aka.ms/vcpython27
2. Edit your system and environment variables (use the appropriate Java bitness
and version in paths):
4. Update pip and setuptools::
Add to `Environment Variables
<https://en.wikipedia.org/wiki/Environment_variable>`_:
python -m pip install --upgrade pip setuptools
* ``JAVA_HOME``: C:\\Program Files\\Java\\jdk1.7.0_79\\bin
* ``PATH``: C:\\Program Files\\Java\\jdk1.7.0_79\\jre\\bin\\server
contains ``jvm.dll`` necessary for importing and using PyJNIus.
.. note::
set PATH=%PATH%;C:\\Program Files\\Java\\jdk1.7.0_79\\jre\\bin\\server
Add to System Variables or have it present in your ``PATH``:
* ``PATH``: C:\\Program Files\\Java\\jdk1.7.0_79\\bin`
3. Download and install C compiler:
a) Microsoft Visual C++ Compiler for Python 2.7:
http://aka.ms/vcpython27
b) MinGWPy for Python 2.7:
https://anaconda.org/carlkl/mingwpy
c) Microsoft Visual C++ Build Tools (command-line tools subset of Visual
Studio) for Python 3.5 and 3.6:
https://visualstudio.microsoft.com/downloads/
For other versions see Python's `Windows Compilers wiki
<https://wiki.python.org/moin/WindowsCompilers>`_.
4. Update `pip <https://pip.pypa.io/en/stable/installing>`_ and setuptools::
python -m pip install --upgrade pip setuptools
5. Install Cython::
python -m pip install --upgrade Cython
python -m pip install --upgrade cython
6. Install Pyjnius::
pip install pyjnius
pip install pyjnius
.. note::
In case of MinGWPy's GCC returning a ``CreateProcess failed: 5`` error
you need to run the command prompt with elevated permissions, so that
the compiler can access JDK in ``C:\Program Files\Java\jdkx.y.z_b`` or
``C:\Program Files (x86)\Java\jdkx.y.z_b``.