From 6c8529f9a2d2de37f7a4eaf21b1863a321f7979a Mon Sep 17 00:00:00 2001 From: Zen-CODE Date: Sun, 20 Apr 2014 21:29:20 +0200 Subject: [PATCH] Added instructions for forcing clean builds --- doc/sources/guide/packaging-ios-compile.rst | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/doc/sources/guide/packaging-ios-compile.rst b/doc/sources/guide/packaging-ios-compile.rst index 276307b5f..0d762fdca 100644 --- a/doc/sources/guide/packaging-ios-compile.rst +++ b/doc/sources/guide/packaging-ios-compile.rst @@ -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 `_. +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 ---------------