iphone - What precisely happens when iOS installs an update to an app?

Question

What is the official, documented behavior when you install an update to an app?

This question asks the same thing, but the answer, which says that the app bundle is replaced but all other folders are untouched, does not provide any documentation. I have reason to believe that the app bundle, in fact, is not replaced, so I'd like to know for sure.

Please link to documentation!

Answer 1

From the iOS Application Programming Guide (see the "Files Saved During Application Updates" section within "The File System"):

When a user downloads an application update, iTunes installs the update in a new application directory. It then moves the user’s data files from the old installation over to the new application directory before deleting the old installation. Files in the following directories are guaranteed to be preserved during the update process:

• <Application_Home>/Documents
• <Application_Home>/Library

Although files in other user directories may also be moved over, you should not rely on them being present after an update.

What you're seeing in the Why isn't my iPhone app bundle replacing the old one during an update? question is an issue where Xcode doesn't correctly detect/push updated resources to the device, which is a very different scenario.