Added instructions for forcing clean builds

This commit is contained in:
Zen-CODE 2014-04-20 21:29:20 +02:00
parent cddd5d17d0
commit 6c8529f9a2
1 changed files with 18 additions and 3 deletions

View File

@ -20,9 +20,7 @@ Using the "build_all.sh" script
-------------------------------
The kivy-ios package provides a generic script, "tools/build_all.sh", that
creates a complete distribution for you. The first time you run it, the script
will download the latest versions of the packages kivy-ios uses. This means it
might fail if any of them are not available.
creates a complete distribution for you.
You may want edit/copy this file in order to customize your distribution for
various reasons::
@ -35,6 +33,23 @@ The minimizing and customizing options are obviously desirable and relativly
simple as the build script is a standard
`bash shell script <http://en.wikipedia.org/wiki/Bash_%28Unix_shell%29>`_.
The build process
-----------------
Initially, your kivy-ios checkout will contain two folders: *tools* and *src*.
The first time you run it, the script will download the latest versions of
the packages kivy-ios uses. This means it might fail if any packages are not
available or cannot be downloaded.
These downloaded packages are stored in a hidden *.cache* subfolder. It may
happen that an interrupted download will leave corrupt files in your cache.
Additionally, the build process will also create various other subfolders,
such as *build* and *tmp*, in your *kivy-ios* folder.
If you wish to force a fresh build of all the packages, you should delete all
of these other folders (including *.cache*, but not *src* and *tools*) and
re-run the 'build_all.sh' script.
Troubleshooting
---------------