From 4c00fb43042a1e8d1a4e2d29827d00ed3144575f Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Wed, 9 Dec 2009 20:27:09 +0100 Subject: Documentation cleanup and a new error code [#96 state:resolved] Signed-off-by: Matt Colyer --- include/libiphone/notification_proxy.h | 1 + 1 file changed, 1 insertion(+) (limited to 'include') diff --git a/include/libiphone/notification_proxy.h b/include/libiphone/notification_proxy.h index 66b7a80..96af5fd 100644 --- a/include/libiphone/notification_proxy.h +++ b/include/libiphone/notification_proxy.h @@ -33,6 +33,7 @@ extern "C" { #define NP_E_SUCCESS 0 #define NP_E_INVALID_ARG -1 #define NP_E_PLIST_ERROR -2 +#define NP_E_CONN_FAILED -3 #define NP_E_UNKNOWN_ERROR -256 -- cgit v1.1-32-gdbae From c6982451d82c340ee8a57c76e39db160c625a1a3 Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Tue, 15 Dec 2009 00:02:50 +0100 Subject: Support for new SBServices interface This lockdown service has been introduced in firmware 3.1 and allows to re-arrange the Spr*ngboard icons from the computer. [#99 state:resolved] Signed-off-by: Matt Colyer --- include/Makefile.am | 1 + include/libiphone/sbservices.h | 56 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 57 insertions(+) create mode 100644 include/libiphone/sbservices.h (limited to 'include') diff --git a/include/Makefile.am b/include/Makefile.am index df7b823..5e25a58 100644 --- a/include/Makefile.am +++ b/include/Makefile.am @@ -2,4 +2,5 @@ nobase_include_HEADERS = libiphone/libiphone.h \ libiphone/lockdown.h \ libiphone/afc.h \ libiphone/notification_proxy.h \ + libiphone/sbservices.h \ libiphone/mobilesync.h diff --git a/include/libiphone/sbservices.h b/include/libiphone/sbservices.h new file mode 100644 index 0000000..6ea8189 --- /dev/null +++ b/include/libiphone/sbservices.h @@ -0,0 +1,56 @@ +/** + * @file libiphone/sbservices.h + * @brief Implementation to talk to com.apple.springboardservices on a device + * \internal + * + * Copyright (c) 2009 Nikias Bassen All Rights Reserved. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +#ifndef SB_SERVICES_H +#define SB_SERVICES_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +/* Error Codes */ +#define SBSERVICES_E_SUCCESS 0 +#define SBSERVICES_E_INVALID_ARG -1 +#define SBSERVICES_E_PLIST_ERROR -2 +#define SBSERVICES_E_CONN_FAILED -3 + +#define SBSERVICES_E_UNKNOWN_ERROR -256 + +typedef int16_t sbservices_error_t; + +struct sbservices_client_int; +typedef struct sbservices_client_int *sbservices_client_t; + +/* Interface */ +sbservices_error_t sbservices_client_new(iphone_device_t device, int dst_port, sbservices_client_t *client); +sbservices_error_t sbservices_client_free(sbservices_client_t client); +sbservices_error_t sbservices_get_icon_state(sbservices_client_t client, plist_t *state); +sbservices_error_t sbservices_set_icon_state(sbservices_client_t client, plist_t newstate); +sbservices_error_t sbservices_get_icon_pngdata(sbservices_client_t client, const char *bundleId, char **pngdata, uint64_t *pngsize); + +#ifdef __cplusplus +} +#endif + +#endif -- cgit v1.1-32-gdbae From dd3d8700dcdc7acc28e2db58405f247bb98228ab Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Thu, 31 Dec 2009 03:19:43 +0100 Subject: New installation_proxy interface. Allows enumeration, install, uninstall, upgrade, and some other stuff with apps. --- include/Makefile.am | 1 + include/libiphone/installation_proxy.h | 73 ++++++++++++++++++++++++++++++++++ include/libiphone/libiphone.h | 1 + 3 files changed, 75 insertions(+) create mode 100644 include/libiphone/installation_proxy.h (limited to 'include') diff --git a/include/Makefile.am b/include/Makefile.am index 5e25a58..54dae0e 100644 --- a/include/Makefile.am +++ b/include/Makefile.am @@ -2,5 +2,6 @@ nobase_include_HEADERS = libiphone/libiphone.h \ libiphone/lockdown.h \ libiphone/afc.h \ libiphone/notification_proxy.h \ + libiphone/installation_proxy.h \ libiphone/sbservices.h \ libiphone/mobilesync.h diff --git a/include/libiphone/installation_proxy.h b/include/libiphone/installation_proxy.h new file mode 100644 index 0000000..dcf668f --- /dev/null +++ b/include/libiphone/installation_proxy.h @@ -0,0 +1,73 @@ +/** + * @file libiphone/installation_proxy.h + * @brief Implementation to talk to the installation proxy on a device + * \internal + * + * Copyright (c) 2009 Nikias Bassen All Rights Reserved. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +#ifndef INSTALLATION_PROXY_H +#define INSTALLATION_PROXY_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +/* Error Codes */ +#define INSTPROXY_E_SUCCESS 0 +#define INSTPROXY_E_INVALID_ARG -1 +#define INSTPROXY_E_PLIST_ERROR -2 +#define INSTPROXY_E_CONN_FAILED -3 +#define INSTPROXY_E_OP_IN_PROGRESS -4 +#define INSTPROXY_E_OP_FAILED -5 + +#define INSTPROXY_E_UNKNOWN_ERROR -256 + +typedef int16_t instproxy_error_t; + +typedef enum { + INSTPROXY_APPTYPE_ALL = 0, + INSTPROXY_APPTYPE_SYSTEM = 1, + INSTPROXY_APPTYPE_USER = 2 +} instproxy_apptype_t; + +struct instproxy_client_int; +typedef struct instproxy_client_int *instproxy_client_t; + +typedef void (*instproxy_status_cb_t) (const char *operation, plist_t status); + +/* Interface */ +instproxy_error_t instproxy_client_new(iphone_device_t device, int dst_port, instproxy_client_t *client); +instproxy_error_t instproxy_client_free(instproxy_client_t client); + +instproxy_error_t instproxy_browse(instproxy_client_t client, instproxy_apptype_t apptype, plist_t *result); +instproxy_error_t instproxy_install(instproxy_client_t client, const char *pkg_path, plist_t sinf, plist_t metadata, instproxy_status_cb_t status_cb); +instproxy_error_t instproxy_upgrade(instproxy_client_t client, const char *pkg_path, plist_t sinf, plist_t metadata, instproxy_status_cb_t status_cb); +instproxy_error_t instproxy_uninstall(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); + +instproxy_error_t instproxy_lookup_archives(instproxy_client_t client, plist_t *result); +instproxy_error_t instproxy_archive(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); +instproxy_error_t instproxy_restore(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); +instproxy_error_t instproxy_remove_archive(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/libiphone/libiphone.h b/include/libiphone/libiphone.h index 6b95edc..923bc58 100644 --- a/include/libiphone/libiphone.h +++ b/include/libiphone/libiphone.h @@ -53,6 +53,7 @@ typedef struct iphone_connection_int *iphone_connection_t; #define DBGMASK_NONE 0x0000 #define DBGMASK_LOCKDOWND (1 << 1) #define DBGMASK_MOBILESYNC (1 << 2) +#define DBGMASK_INSTPROXY (1 << 3) /* generic */ void iphone_set_debug_mask(uint16_t mask); -- cgit v1.1-32-gdbae From daee8be013dae3821463fd85f4076ca2ab3adce6 Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Thu, 31 Dec 2009 14:29:05 +0100 Subject: Add options to instproxy_archive function This change allows to specify the following options: INSTPROXY_ARCHIVE_APP_ONLY - Archive only the application data INSTPROXY_ARCHIVE_SKIP_UNINSTALL - Do not uninstall the application. Combine these options with logical OR to specify both. These two options combined are used by iTunes to create app archives of on-device downloaded apps that are later copied as *.ipa files to the computer. [#104 state:resolved] Signed-off-by: Matt Colyer --- include/libiphone/installation_proxy.h | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'include') diff --git a/include/libiphone/installation_proxy.h b/include/libiphone/installation_proxy.h index dcf668f..f432e8a 100644 --- a/include/libiphone/installation_proxy.h +++ b/include/libiphone/installation_proxy.h @@ -47,6 +47,9 @@ typedef enum { INSTPROXY_APPTYPE_USER = 2 } instproxy_apptype_t; +#define INSTPROXY_ARCHIVE_APP_ONLY (1 << 0) +#define INSTPROXY_ARCHIVE_SKIP_UNINSTALL (1 << 1) + struct instproxy_client_int; typedef struct instproxy_client_int *instproxy_client_t; @@ -62,7 +65,7 @@ instproxy_error_t instproxy_upgrade(instproxy_client_t client, const char *pkg_p instproxy_error_t instproxy_uninstall(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); instproxy_error_t instproxy_lookup_archives(instproxy_client_t client, plist_t *result); -instproxy_error_t instproxy_archive(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); +instproxy_error_t instproxy_archive(instproxy_client_t client, const char *appid, uint32_t options, instproxy_status_cb_t status_cb); instproxy_error_t instproxy_restore(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); instproxy_error_t instproxy_remove_archive(instproxy_client_t client, const char *appid, instproxy_status_cb_t status_cb); -- cgit v1.1-32-gdbae