kivy/doc/sources/guide/packaging-ios-prerequisites...

60 lines
2.0 KiB
ReStructuredText

.. _packaging_ios_prerequisites:
IOS Prerequisites
=================
The following guide assumes:
* XCode 5.1
* MacOSX 10.9
Your experience may vary with different versions.
Getting started
---------------
In order to submit any application to the iTunes store, you will need an
`iOS Developer License <https://developer.apple.com/programs/ios/>`_. For
testing, you will need an actual device as kivy does not yet support the
iOS emulators that Apple supplies.
Please note that in order to test on the device, you need to register these
devices and install your "provisioning profile" on them. Please refer to the
Apple's
`Getting started <https://developer.apple.com/programs/ios/gettingstarted/>`_
guide for more information.
Homebrew
--------
We use the `Homebrew <http://brew.sh/>`_ package mananger for OSX to install
some of the dependencies and tools used by Kivy. It's a really helpful tool and
is an Open Source project hosted on
`Github <https://github.com/Homebrew/homebrew>`_.
Due to the nature of package management (complications with versions and
Operating Systems), this process can be error prone and cause
failures in the build process. The **Missing requirement: <pkg> is not
installed!** message is typically such an error.
The first thing is to ensure you have run the following commands::
brew install autoconf automake libtool pkg-config mercurial
brew link libtool
brew link mercurial
sudo easy_install pip
sudo pip install cython
If you still receive build errors, check your Homebrew is in a healthy state::
brew doctor
For further help, please refer to the `Homebrew wiki <https://github.com/Homebrew/homebrew/wiki>`_.
The last, final and desperate step to get things working might be to remove
Homebrew altogether, get the lastest version, install that and then re-install
the dependencies.
`How to Uninstall and Remove Homebrew for Mac OSX <http://www.curvve.com/blog/guides/2013/uninstall-homebrew-mac-osx/>`_