X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=plugin%2Fapp2sd%2Finc%2Fapp2sd_interface.h;h=99c15651fedac7311f276e600b91ef65bd84fd48;hb=refs%2Ftags%2Fsubmit%2Ftizen%2F20160704.042542;hp=a59cb9a8d3b24f28bd03e22b4c0b4ac6a14b7140;hpb=ba26e013eef9209f9179d94784634379964fa307;p=platform%2Fcore%2Fappfw%2Fapp2sd.git diff --git a/plugin/app2sd/inc/app2sd_interface.h b/plugin/app2sd/inc/app2sd_interface.h old mode 100755 new mode 100644 index a59cb9a..99c1565 --- a/plugin/app2sd/inc/app2sd_interface.h +++ b/plugin/app2sd/inc/app2sd_interface.h @@ -24,379 +24,44 @@ #ifndef __APPTOSD_INTERFACE_H__ #define __APPTOSD_INTERFACE_H__ -/** - * @file app2sd_interface.h - * @version 0.2 - * @brief This file declares API of app2sd library - */ -/** - * @addtogroup APPLICATION_FRAMEWORK - * @{ - * - * @defgroup app2sd - * @version 0.2 - * - * @section Header to use them: - * @code - * #include - * @endcode - * - * @addtogroup app2sd - * @{ - */ - - #ifdef __cplusplus extern "C" { #endif -#include +#include "app2ext_interface.h" +#include "app2ext_utils.h" +int app2sd_usr_pre_app_install(const char *pkgid, + GList *dir_list, int size, uid_t uid); - /** - * @brief : This API prepares the setup for installation in SD card. - * It should be called before actual installation is done. - * @pre vfat type sd card must be present. - * @post Installation is done by package installer. - Encryption password is saved in db /opt/dbspace/.app2sd.db - * @param[in] appname application package name - * [Ex: com.samsung.calculator] - *This entry is parsed from application package control/manifest file. - * @param[in] dir_list directory structure of the application - * @param[in] size size of memory required by application(in MB). - *This entry is parsed from application package control/manifest file. - * @return 0 if success, error code(>0) if fail - * @remark None. - * - * - @code - #include - int ret = -1; - GList* dir_list = NULL; - // Package manager populates dir_list with directory structure information - ret= app2sd_pre_app_install - ("com.samsung.calculotor", dir_list, 10); - if(!ret) - { - printf("\n SUCCESS"); - // Package installer performs installation - // app2sd_post_app_install() API should be called - return; - } - else - printf("\n FAILURE"); - @endcode - */ - API int app2sd_pre_app_install(const char *appname, - GList* dir_list, int size); +int app2sd_usr_post_app_install(const char *pkgid, + app2ext_status install_status, uid_t uid); - /** - * @brief : This API does post installation operations after - * the installation in SD card - * @param[in] appname application package name - * [Ex: com.samsung.calculator] - * @param[in] install_status Status of installation of package - *[ enum app2ext_status].If package installation failed then - * install_status= APP2EXT_STATUS_FAILURE else if installation - * was successful then install_status = APP2EXT_ISTATUS_SUCCESS. - * @pre Installation should be done by package installer. - * @return 0 if success, error code(>0) if fail - * @remark @see enum app2sd_install_status - * - * - @code - #include - int ret = -1; - ret= app2sd_pre_app_install - ("com.samsung.calculotor", APP2EXT_NATIVE_APP, 10); - if(!ret) - { - printf("\n SUCCESS"); - // Package installer performs installation - //Package was installed successfully. - if(package_installation _success) - { - ret = app2sd_post_app_install - ("com.samsung.calculator",APP2EXT_STATUS_SUCCESS); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - return; - } - else - { - //Package installation failed - ret = app2sd_post_app_install - ("com.samsung.calculator",APP2EXT_STATUS_FAILURE); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - return; - } - } - else - printf("\n FAILURE"); - @endcode - */ - API int app2sd_post_app_install(const char *appname, - app2ext_status install_status); +int app2sd_usr_pre_app_upgrade(const char *pkgid, + GList *dir_list, int size, uid_t uid); - /** - * @brief : This API prepares the setup for upgradation of - * application package - * @pre vfat type sd card must be present. - * @post Upgradation is done by package installer. - * @param[in] appname application package name - * [Ex: com.samsung.calculator] - * @param[in] dir_list directory structure of the application - * @param[in] size size of memory required by application(in MB). - *This entry is parsed from application package control/manifest file. - * @return 0 if success, error code(>0) if fail - * @remark None. - * - * - @code - #include - int ret = -1; - GList* dir_list = NULL; - // Package manager populates dir_list with directory structure information - ret= app2sd_pre_app_upgrade - ("com.samsung.calculator", dir_list, 10); - if(!ret) - { - printf("\n SUCCESS"); - // Package installer performs upgradation - // app2sd_post_app_upgrade() API should be called - return; - } - else - printf("\n FAILURE"); - @endcode - */ - API int app2sd_pre_app_upgrade(const char *appname, - GList* dir_list, int size); +int app2sd_usr_post_app_upgrade(const char *pkgid, + app2ext_status upgrade_status, uid_t uid); - /** - * @brief : This API does post upgradation operations after - * the installation in SD card - * @param[in] appname application package name - * [Ex: com.samsung.calculator] - * @param[in] install_status Status of installation of package - *[ enum app2extl_status].If package upgradation failed then - * upgrade_status= APP2EXT_STATUS_FAILURE else if upgradation - * was successful then upgrade_status = APP2EXT_STATUS_SUCCESS. - * @pre Upgradation should be done by package installer. - * @return 0 if success, error code(>0) if fail - * @remark @see enum app2ext_status - * - * - @code - #include - int ret = -1; - ret= app2sd_pre_app_upgrade - ("com.samsung.calculator", APP2EXT_NATIVE_APP, 10); - if(!ret) - { - printf("\n SUCCESS"); - // Package installer performs upgradation - //Package was upgraded successfully. - if(package_upgradation _success) - { - ret = app2sd_post_app_upgrade - ("com.samsung.calculator",APP2EXT_STATUS_SUCCESS); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - return; - } - else - { - //Package upgradation failed - ret = app2sd_post_app_upgrade - ("com.samsung.calculator",APP2EXT_STATUS_FAILURE); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - return; - } - } - else - printf("\n FAILURE"); - @endcode - */ - API int app2sd_post_app_upgrade(const char *appname, - app2ext_status upgrade_status); +int app2sd_usr_pre_app_uninstall(const char *pkgid, uid_t uid); - /** - * @brief: This API prepares the setup for uninstallation - * @pre Package must be installed in sdcard. - * @post Package is uninstalled by the package installer. - * @param[in] appname application package name - * [Ex: com.samsung.calculator] - * @return 0 if success, error code(>0) if fail - * @remark None. - * - * - @code - #include - int ret = -1; - ret= app2sd_pre_app_uninstall - ("com.samsung.calculator"); - if(!ret) - { - printf("\n SUCCESS"); - // Package installer performs uninstallation - // app2sd_post_app_uninstall() API should be called - return; - } - else - printf("\n FAILURE"); - @endcode - */ - API int app2sd_pre_app_uninstall(const char *appname); +int app2sd_usr_post_app_uninstall(const char *pkgid, uid_t uid); - /** - * @brief This API removes the resources created during - app2sd setup.It is called after uninstallation. - * @pre Package must be uninstalled . - * @post Encryption password is removed from sqlite db. - * @param[in] appname application package name - * [Ex: com.samsung.calculator] - * @return 0 if success, error code(>0) if fail - * @remark None. - * - * - @code - #include - int ret = -1; - ret= app2sd_pre_app_uninstall - ("com.samsung.calculator"); - if(!ret) - { - printf("\n SUCCESS"); - // Package installer performs uninstallation - ret = app2sd_post_app_uninstall("com.samsung.calculator"); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - return; - } - else - printf("\n FAILURE"); - @endcode - */ - API int app2sd_post_app_uninstall(const char *appname); +int app2sd_usr_pre_move_installed_app(const char *pkgid, + GList *dir_list, app2ext_move_type move_type, uid_t uid); - /** - * @brief : This API moves the package from sd card - to internal memory and vice versa. - * @param[in] pkgid application package id - * [Ex: com.samsung.calculator] - * @param[in] move_type Move type[enum app2ext_move_type] - * [sd card to internal/internal to sd card] - * @param[in] dir_list directory structure of the application - * @pre Package must be installed and its installation - * location should be known.Use app2sd_get_app_install_location() - * to get installation location. - * @see app2sd_get_app_install_location(). - * @post Package is moved to new location. - * @return 0 if success, error code(>0) if fail - * @remark None. - * - * - @code - #include - int ret = -1; - GList* dir_list = NULL; - // Package manager populates dir_list with directory structure information - ret = app2sd_get_app_install_location("com.samsung.calculator"); - if(ret == APP2SD_INTERNAL_MEM) - { - ret= app2sd_move_installed_app("com.samsung.calculator", - dir_list, APP2EXT_MOVE_TO_EXT); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - } - else if(ret == APP2SD_EXTERNAL_MEM) - { - ret= app2sd_move_installed_app("com.samsung.calculator", - dir_list, APP2SD_MOVE_TO PHONE); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - } - @endcode - */ - API int app2sd_move_installed_app(const char *pkgid, - GList* dir_list, app2ext_move_type move_type); +int app2sd_usr_post_move_installed_app(const char *pkgid, + app2ext_move_type move_type, uid_t uid); - /** - * @brief : This API Enables the application in sd card - for use. This API should be called by AUL. - * @param[in] pkgid application package id - * [Ex: com.samsung.calculator] - * @pre Package must be installed - * @post application is enabled in SD card. - * @return 0 if success, error code(>0) if fail - * @remark None. - * - * - @code - #include - int ret = -1; - ret= app2sd_on_demand_setup_init("com.samsung.calculator"); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - } - @endcode - */ - API int app2sd_on_demand_setup_init(const char *pkgid); +int app2sd_usr_on_demand_setup_init(const char *pkgid, uid_t uid); +int app2sd_usr_on_demand_setup_exit(const char *pkgid, uid_t uid); - /** - * @brief : This API Disables the application in sd card - . This API should be called by Launchpad callback which will be registered - during app launch for exit action of the application - * @param[in] pkgid application package id - * [Ex: com.samsung.calculator] - * @pre Package must be installed and enabled - * and application must be running in SD card - * @post application is disabked in SD card. - * @return 0 if success, error code(>0) if fail - * @remark None. - * - * - @code - #include - int ret = -1; - ret= app2sd_on_demand_setup_exit("com.samsung.calculator"); - if(!ret) - printf("\n SUCCESS"); - else - printf("\n FAILURE"); - } - @endcode - */ - API int app2sd_on_demand_setup_exit(const char *pkgid); +int app2sd_usr_force_clean(const char *pkgid, uid_t uid); - /** - * @brief : This is the plug-in load function. - The plugin has to bind its functions to function pointers of storage handle - * @param[in/out] st_interface Specifies the storage interface. - * @return None - */ - API void app2ext_on_load(app2ext_interface *st_interface); +int app2sd_enable_full_pkg(void); +int app2sd_disable_full_pkg(void); #ifdef __cplusplus }