#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 <app2sd_interface.h>
- * @endcode
- *
- * @addtogroup app2sd
- * @{
- */
-
-
#ifdef __cplusplus
extern "C" {
#endif
-#include <app2ext_interface.h>
+#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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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 <app2sd_interface.h>
- 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
}
projects / platform / core / appfw / app2sd.git / blobdiff