libimobiledevice  1.3.0
API Documentation - Return to Homepage

◆ instproxy_archive()

instproxy_error_t instproxy_archive ( instproxy_client_t  client,
const char *  appid,
plist_t  client_options,
instproxy_status_cb_t  status_cb,
void *  user_data 
)

Archive an application on the device.

This function tells the device to make an archive of the specified application. This results in the device creating a ZIP archive in the 'ApplicationArchives' directory and uninstalling the application.

Parameters
clientThe connected installation proxy client
appidApplicationIdentifier of the app to archive.
client_optionsThe client options to use, as PLIST_DICT, or NULL. Valid options include: "SkipUninstall" -> Boolean "ArchiveType" -> "ApplicationOnly"
status_cbCallback function for progress and status information. If NULL is passed, this function will run synchronously.
user_dataCallback data passed to status_cb.
Returns
INSTPROXY_E_SUCCESS on success or an INSTPROXY_E_* error value if an error occurred.
Note
If a callback function is given (async mode), this function returns INSTPROXY_E_SUCCESS immediately if the status updater thread has been created successfully; any error occuring during the command has to be handled inside the specified callback function.