Skip to content

Commit

Permalink
update android virtual machine documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
tito committed May 13, 2017
1 parent 0630b35 commit 242beb3
Showing 1 changed file with 9 additions and 20 deletions.
29 changes: 9 additions & 20 deletions doc/sources/guide/packaging-android-vm.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,10 @@
The Kivy Android Virtual Machine
================================

.. warning::
.. note::

The VM is old and not maintained, we do not reccomend it to be used and is
not likely to work. See :ref:`packaging_android` for the reccomended
approach to build apks.
The VM is now updated. Please check the `Kivy website <http://kivy.org/#download>`_
for the latest version.

Introduction
------------
Expand All @@ -25,29 +24,19 @@ If you are not familiar with virtualization, we encourage you to read the
Getting started
---------------

#. Download the disc image from `here <http://kivy.org/#download>`_, in the
*Virtual Machine* section. The download is >2GB (6GB after extracted).
Extract the file and remember the location of the extracted vdi file.
#. Download the `Kivy / Buildozer VM <http://kivy.org/#download>`_, in the
*Virtual Machine* section. The download is 1.2GB.
Extract the file and remember the location of the extracted directory.

#. Download the version of VirtualBox for your machine from the
`VirtualBox download area <https://www.virtualbox.org/wiki/Downloads>`_
and install it.

#. Start VirtualBox, click on "New" in the left top. Then select "linux" and
"Ubuntu 64-bit".
#. Start VirtualBox, click on "File", "Import Appliance".

#. Under "Hard drive", choose "Use an existing virtual hard drive file".
Search for your vdi file and select it.
#. Select the extracted directory, file should be named "Buildozer VM.ovf"

#. Go to the "Settings" for your virtual machine. In the
"Display -> Video" section, increase video ram to 32mb or above.
Enable 3d acceleration to improve the user experience.

#. Start the Virtual machine and follow the instructions in the readme file
on the desktop.

#. Go to https://github.com/kivy/buildozer#buildozer-virtual-machine to
see the current issues with the VM.
#. Start the Virtual machine and click on the "Buildozer" icon.

Building the APK
----------------
Expand Down

0 comments on commit 242beb3

Please sign in to comment.