From fdfa3668463eb2349dcad285157fd7b86b3174ec Mon Sep 17 00:00:00 2001 From: Kibum Kim Date: Sat, 7 Jan 2012 00:42:13 +0900 Subject: Git init --- AUTHORS | 2 + CMakeLists.txt | 88 +++++++ LICENSE | 206 +++++++++++++++ capi-appfw-app-manager.pc.in | 15 ++ debian/README | 0 debian/capi-appfw-app-manager-dev.install | 4 + debian/capi-appfw-app-manager-dev.postinst | 1 + debian/capi-appfw-app-manager.install | 1 + debian/capi-appfw-app-manager.postinst | 1 + debian/changelog | 5 + debian/compat | 1 + debian/control | 22 ++ debian/rules | 65 +++++ include/app_manager.h | 204 +++++++++++++++ include/app_manager_private.h | 32 +++ packaging/capi-appfw-app-manager.spec | 55 ++++ src/app_manager.c | 397 +++++++++++++++++++++++++++++ 17 files changed, 1099 insertions(+) create mode 100755 AUTHORS create mode 100755 CMakeLists.txt create mode 100755 LICENSE create mode 100755 capi-appfw-app-manager.pc.in create mode 100755 debian/README create mode 100755 debian/capi-appfw-app-manager-dev.install create mode 100755 debian/capi-appfw-app-manager-dev.postinst create mode 100755 debian/capi-appfw-app-manager.install create mode 100755 debian/capi-appfw-app-manager.postinst create mode 100755 debian/changelog create mode 100755 debian/compat create mode 100755 debian/control create mode 100755 debian/rules create mode 100755 include/app_manager.h create mode 100755 include/app_manager_private.h create mode 100755 packaging/capi-appfw-app-manager.spec create mode 100755 src/app_manager.c diff --git a/AUTHORS b/AUTHORS new file mode 100755 index 0000000..a228ba0 --- /dev/null +++ b/AUTHORS @@ -0,0 +1,2 @@ +junghyuk park + diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100755 index 0000000..65372e8 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,88 @@ + +CMAKE_MINIMUM_REQUIRED(VERSION 2.6) +SET(fw_name "capi-appfw-app-manager") + +PROJECT(${fw_name}) + +SET(CMAKE_INSTALL_PREFIX /usr) +SET(PREFIX ${CMAKE_INSTALL_PREFIX}) + +SET(INC_DIR include) +INCLUDE_DIRECTORIES(${INC_DIR}) + +SET(dependents "dlog vconf aul ail capi-base-common") + +INCLUDE(FindPkgConfig) +pkg_check_modules(${fw_name} REQUIRED ${dependents}) +FOREACH(flag ${${fw_name}_CFLAGS}) + SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}") +ENDFOREACH(flag) + +SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -fPIC -Wall -Werror") +SET(CMAKE_C_FLAGS_DEBUG "-O0 -g") + +IF("${ARCH}" STREQUAL "arm") + ADD_DEFINITIONS("-DTARGET") +ENDIF("${ARCH}" STREQUAL "arm") + +ADD_DEFINITIONS("-DPREFIX=\"${CMAKE_INSTALL_PREFIX}\"") +ADD_DEFINITIONS("-DSLP_DEBUG") + +SET(CMAKE_EXE_LINKER_FLAGS "-Wl,--as-needed -Wl,--rpath=/usr/lib") + +aux_source_directory(src SOURCES) +ADD_LIBRARY(${fw_name} SHARED ${SOURCES}) + +TARGET_LINK_LIBRARIES(${fw_name} ${${fw_name}_LDFLAGS}) + +INSTALL(TARGETS ${fw_name} DESTINATION lib) +INSTALL( + DIRECTORY ${INC_DIR}/ DESTINATION include/appfw + FILES_MATCHING + PATTERN "*_private.h" EXCLUDE + PATTERN "${INC_DIR}/*.h" + ) + +SET(PC_NAME ${fw_name}) +SET(PC_REQUIRED ${dependents}) +SET(PC_LDFLAGS -l${fw_name}) +SET(PC_CFLAGS -I\${includedir}/appfw) + +CONFIGURE_FILE( + capi-appfw-app-manager.pc.in + ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc + @ONLY +) +INSTALL(FILES ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc DESTINATION lib/pkgconfig) + +IF(UNIX) + +ADD_CUSTOM_TARGET (distclean @echo cleaning for source distribution) +ADD_CUSTOM_COMMAND( + DEPENDS clean + COMMENT "distribution clean" + COMMAND find + ARGS . + -not -name config.cmake -and \( + -name tester.c -or + -name Testing -or + -name CMakeFiles -or + -name cmake.depends -or + -name cmake.check_depends -or + -name CMakeCache.txt -or + -name cmake.check_cache -or + -name *.cmake -or + -name Makefile -or + -name core -or + -name core.* -or + -name gmon.out -or + -name install_manifest.txt -or + -name *.pc -or + -name *~ \) + | grep -v TC | xargs rm -rf + TARGET distclean + VERBATIM +) + +ENDIF(UNIX) + diff --git a/LICENSE b/LICENSE new file mode 100755 index 0000000..bbe9d02 --- /dev/null +++ b/LICENSE @@ -0,0 +1,206 @@ +Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved. + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + + diff --git a/capi-appfw-app-manager.pc.in b/capi-appfw-app-manager.pc.in new file mode 100755 index 0000000..0a03940 --- /dev/null +++ b/capi-appfw-app-manager.pc.in @@ -0,0 +1,15 @@ + +# Package Information for pkg-config + +prefix=@PREFIX@ +exec_prefix=/usr +libdir=/usr/lib +includedir=/usr/include/appfw + +Name: @PC_NAME@ +Description: @PACKAGE_DESCRIPTION@ +Version: @VERSION@ +Requires: @PC_REQUIRED@ +Libs: -L${libdir} @PC_LDFLAGS@ +Cflags: -I${includedir} @PC_CFLAGS@ + diff --git a/debian/README b/debian/README new file mode 100755 index 0000000..e69de29 diff --git a/debian/capi-appfw-app-manager-dev.install b/debian/capi-appfw-app-manager-dev.install new file mode 100755 index 0000000..761a28b --- /dev/null +++ b/debian/capi-appfw-app-manager-dev.install @@ -0,0 +1,4 @@ +/usr/include/* +/usr/include/*/* +/usr/lib/pkgconfig/*.pc + diff --git a/debian/capi-appfw-app-manager-dev.postinst b/debian/capi-appfw-app-manager-dev.postinst new file mode 100755 index 0000000..1a24852 --- /dev/null +++ b/debian/capi-appfw-app-manager-dev.postinst @@ -0,0 +1 @@ +#!/bin/sh diff --git a/debian/capi-appfw-app-manager.install b/debian/capi-appfw-app-manager.install new file mode 100755 index 0000000..4a755a4 --- /dev/null +++ b/debian/capi-appfw-app-manager.install @@ -0,0 +1 @@ +/usr/lib/lib*.so* diff --git a/debian/capi-appfw-app-manager.postinst b/debian/capi-appfw-app-manager.postinst new file mode 100755 index 0000000..1a24852 --- /dev/null +++ b/debian/capi-appfw-app-manager.postinst @@ -0,0 +1 @@ +#!/bin/sh diff --git a/debian/changelog b/debian/changelog new file mode 100755 index 0000000..2f7aaaa --- /dev/null +++ b/debian/changelog @@ -0,0 +1,5 @@ +capi-appfw-app-manager (0.1.0-4) unstable; urgency=low + + * Initial release. + + -- Kyuhun Jung Wed, 07 Dec 2011 05:33:23 +0300 diff --git a/debian/compat b/debian/compat new file mode 100755 index 0000000..7ed6ff8 --- /dev/null +++ b/debian/compat @@ -0,0 +1 @@ +5 diff --git a/debian/control b/debian/control new file mode 100755 index 0000000..611cf94 --- /dev/null +++ b/debian/control @@ -0,0 +1,22 @@ + +Source: capi-appfw-app-manager +Section: libs +Priority: extra +Maintainer: Woongsuk Cho , junghyuk park +Build-Depends: debhelper (>= 5), dlog-dev, libaul-1-dev, capi-base-common-dev, libail-0-dev, libvconf-dev + +Package: capi-appfw-app-manager +Architecture: any +Depends: ${shilbs:Depends}, ${misc:Depends} +Description: The Application Manager API provides functions to get information about running applications. + +Package: capi-appfw-app-manager-dev +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, capi-appfw-app-manager (= ${Source-Version}), dlog-dev, libaul-1-dev, capi-base-common-dev, libail-0-dev, libvconf-dev +Description: The Application Manager API provides functions to get information about running applications. (DEV) + +Package: capi-appfw-app-manager-dbg +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, capi-appfw-app-manager (= ${Source-Version}) +Description: The Application Manager API provides functions to get information about running applications. (DBG) + diff --git a/debian/rules b/debian/rules new file mode 100755 index 0000000..1c6c827 --- /dev/null +++ b/debian/rules @@ -0,0 +1,65 @@ +#!/usr/bin/make -f + +CFLAGS = -Wall -g + +ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) + CFLAGS += -O0 +else + CFLAGS += -O2 +endif +CMAKE_ROOT_DIR ?= $(CURDIR) +CMAKE_BUILD_DIR ?= $(CURDIR)/cmake_build_tmp + +configure: configure-stamp +configure-stamp: + dh_testdir + mkdir -p $(CMAKE_BUILD_DIR) && cd $(CMAKE_BUILD_DIR) && cmake .. + touch configure-stamp + + +build: build-stamp +build-stamp: configure-stamp + dh_testdir + cd $(CMAKE_BUILD_DIR) && $(MAKE) + touch $@ + +clean: + cd $(CMAKE_ROOT_DIR) + dh_testdir + dh_testroot + rm -f build-stamp configure-stamp + rm -f `find . -name *.pc` + rm -rf $(CMAKE_BUILD_DIR) + dh_clean + +install: build + dh_testdir + dh_testroot + dh_clean -k + dh_installdirs + + cd $(CMAKE_BUILD_DIR) && $(MAKE) DESTDIR=$(CURDIR)/debian/tmp install + +binary-indep: build install + +binary-arch: build install + dh_testdir + dh_testroot + dh_installchangelogs + dh_installdocs + dh_installexamples + dh_install --sourcedir=debian/tmp + dh_installman + dh_link + dh_strip --dbg-package=capi-appfw-app-manager-dbg + dh_fixperms + dh_makeshlibs + dh_installdeb + dh_shlibdeps + dh_gencontrol + dh_md5sums + dh_builddeb + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install configure + diff --git a/include/app_manager.h b/include/app_manager.h new file mode 100755 index 0000000..ed65d80 --- /dev/null +++ b/include/app_manager.h @@ -0,0 +1,204 @@ +/* + * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved + * + * Licensed under the Apache License, Version 2.0 (the License); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an AS IS BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + +#ifndef __TIZEN_APPFW_APP_MANAGER_H +#define __TIZEN_APPFW_APP_MANAGER_H + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @addtogroup CAPI_APPLICATION_MANAGER_MODULE + * @{ + */ + +/** + * @brief Enumerations of error code for Application Manager. + */ +typedef enum +{ + APP_MANAGER_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */ + APP_MANAGER_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */ + APP_MANAGER_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */ + APP_MANAGER_ERROR_DB_FAILED = TIZEN_ERROR_APPLICATION_CLASS | 0x03, /**< Database error */ + APP_MANAGER_ERROR_INVALID_PACKAGE = TIZEN_ERROR_APPLICATION_CLASS | 0x04, /**< Can not find the package */ +} app_manager_error_e; + +/** + * @brief Enumerations of event type for the list of the installed applications. + */ +typedef enum +{ + APP_MANAGER_EVENT_INSTALLED = 40, /**< Install event */ + APP_MANAGER_EVENT_UNINSTALLED = 41, /**< Uninstall event */ + APP_MANAGER_EVENT_UPDATED = 42, /**< Update event */ +} app_manger_event_type_e; + +/** + * @brief Called to get the package name once for each running application. + * @param[in] package The package name of each running application + * @param[in] user_data The user data passed from the foreach function + * @return @c true to continue with the next iteration of the loop, \n @c false to break out of the loop. + * @pre app_manager_foreach_app_running() will invoke this callback. + * @see app_manager_foreach_app_running() + */ +typedef bool (*app_manager_app_running_cb) (const char *package, void *user_data); + +/** + * @brief Called to get the package name once for each installed application. + * + * @param[in] package The package name of each installed application + * @param[in] user_data The user data passed from the foreach function + * @return @c true to continue with the next iteration of the loop, \n @c false to break out of the loop. + * @pre app_manager_foreach_app_installed() will invoke this callback. + * @see app_manager_foreach_app_installed() + */ +typedef bool (*app_manager_app_installed_cb) (const char *package, void *user_data); + +/** + * @brief Called when the list of the installed applications changes. + * + * @param[in] event_type The type of applist modification event + * @param[in] package The package name of application installed or uninstalled + * @param[in] user_data The user data passed from the callback registration function + * @pre An application registers this callback using app_manager_set_app_list_changed_cb() + * to detect change of list of the installed applications. + * @see app_manager_set_app_list_changed_cb() + * @see app_manager_unset_app_list_changed_cb() + */ +typedef void(*app_manager_app_list_changed_cb) (app_manger_event_type_e event_type, const char *package, void *user_data); + +/** + * @brief Retrieves the package names of all running applications + * by invoking the callback once for each running application to get their package names. + * + * @param [in] callback The callback function to invoke + * @param [in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #APP_MANAGER_ERROR_NONE Successful + * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post This function invokes app_manager_app_running_cb() repeatedly for each running application. + * @see app_manager_app_running_cb() + */ +int app_manager_foreach_app_running(app_manager_app_running_cb callback, void *user_data); + +/** + * @brief Retrieves the package names of all installed applications + * by invoking the callback once for each installed application to get their package names. + * + * @param [in] callback The callback function to invoke + * @param [in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #APP_MANAGER_ERROR_NONE Successful + * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory + * @post This function invokes app_manager_app_installed_cb() repeatedly for each installed application. + * @see app_manager_app_installed_cb() + */ +int app_manager_foreach_app_installed(app_manager_app_installed_cb callback, void *user_data); + +/** + * @brief Checks whether the application with the given package name is running. + * + * + * @param [in] package The package name of the application + * @param [out] is_running @c true if the application is running, \n @c false if not running. + * @return 0 on success, otherwise a negative error value. + * @retval #APP_MANAGER_ERROR_NONE Successful + * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + */ +int app_manager_is_running(const char *package, bool *is_running); + +/** + * @brief Gets the application name with the given package name. + * + * @remarks @a name must be released with free() by you. + * @param [in] package The package name of the application + * @param [out] name The application name + * @return 0 on success, otherwise a negative error value. + * @retval #APP_MANAGER_ERROR_NONE Successful + * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #APP_MANAGER_ERROR_INVALID_PACKAGE Package name is invalid, Can not find the package + * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred + * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory + */ +int app_manager_get_app_name(const char *package, char **name); + +/** + * @brief Gets the application icon path with the given package name. + * + * @remarks @a icon_path must be released with free() by you. + * @param [in] package The package name of the application + * @param [out] icon_path The icon path to represent the application + * @return 0 on success, otherwise a negative error value. + * @retval #APP_MANAGER_ERROR_NONE Successful + * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #APP_MANAGER_ERROR_INVALID_PACKAGE Package name is invalid, Can not find the package + * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred + * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory + */ +int app_manager_get_app_icon_path(const char *package, char **icon_path); + +/** + * @brief Gets the application version with the given package name. + * + * @remarks @a version must be released with free() by you. + * @param [in] package The package name of the application + * @param [out] version The version of the application + * @return 0 on success, otherwise a negative error value. + * @retval #APP_MANAGER_ERROR_NONE Successful + * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #APP_MANAGER_ERROR_INVALID_PACKAGE Package name is invalid, Can not find the package + * @retval #APP_MANAGER_ERROR_DB_FAILED Database error occurred + * @retval #APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory + */ +int app_manager_get_app_version(const char *package, char **version); + +/** + * @brief Registers a callback function to be invoked when the list of the installed applications changes. + * + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #APP_MANAGER_ERROR_NONE On Successful + * @retval #APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @post It will invoke app_manager_app_list_changed_cb() when the list of installed application changes. + * @see app_manager_unset_app_list_changed_cb() + * @see app_manager_app_list_changed_cb() + */ +int app_manager_set_app_list_changed_cb(app_manager_app_list_changed_cb callback, void *user_data); + +/** + * @brief Unregisters the callback function. + * + * @see app_manager_set_app_list_changed_cb() + * @see app_manager_app_list_changed_cb() + */ +void app_manager_unset_app_list_changed_cb(void); + +/** + * @} + */ + +#ifdef __cplusplus +} +#endif + +#endif /* __TIZEN_APPFW_APP_MANAGER_H */ diff --git a/include/app_manager_private.h b/include/app_manager_private.h new file mode 100755 index 0000000..17088da --- /dev/null +++ b/include/app_manager_private.h @@ -0,0 +1,32 @@ +/* + * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved + * + * Licensed under the Apache License, Version 2.0 (the License); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an AS IS BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + +#ifndef __TIZEN_APPFW_APP_MANAGER_PRIVATE_H__ +#define __TIZEN_APPFW_APP_MANAGER_PRIVATE_H__ + +#include +#include + + +#ifdef __cplusplus +extern "C" { +#endif + +#ifdef __cplusplus +} +#endif +#endif /* __TIZEN_APPFW_APP_MANAGER_PRIVATE_H__ */ diff --git a/packaging/capi-appfw-app-manager.spec b/packaging/capi-appfw-app-manager.spec new file mode 100755 index 0000000..cc9d0fa --- /dev/null +++ b/packaging/capi-appfw-app-manager.spec @@ -0,0 +1,55 @@ +Name: capi-appfw-app-manager +Summary: Application Manager API +Version: 0.0.1 +Release: 1 +Group: TO_BE/FILLED_IN +License: TO BE FILLED IN +Source0: %{name}-%{version}.tar.gz +BuildRequires: cmake +BuildRequires: pkgconfig(dlog) +BuildRequires: pkgconfig(vconf) +BuildRequires: pkgconfig(aul) +BuildRequires: pkgconfig(ail) +BuildRequires: pkgconfig(capi-base-common) +Requires(post): /sbin/ldconfig +Requires(postun): /sbin/ldconfig + +%description +The Application Manager API provides functions to get information about running applications. + +%package devel +Summary: Application Manager API (Development) +Group: TO_BE/FILLED_IN +Requires: %{name} = %{version}-%{release} + +%description devel +The Application Manager API provides functions to get information about running applications. (DEV) + + +%prep +%setup -q + + +%build +cmake . -DCMAKE_INSTALL_PREFIX=/usr + + +make %{?jobs:-j%jobs} + +%install +rm -rf %{buildroot} +%make_install + +%post -p /sbin/ldconfig + +%postun -p /sbin/ldconfig + + +%files +%{_libdir}/libcapi-appfw-app-manager.so + +%files devel +%{_includedir}/appfw/app_manager.h +%{_libdir}/pkgconfig/*.pc + + diff --git a/src/app_manager.c b/src/app_manager.c new file mode 100755 index 0000000..acd23ab --- /dev/null +++ b/src/app_manager.c @@ -0,0 +1,397 @@ +/* + * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved + * + * Licensed under the Apache License, Version 2.0 (the License); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an AS IS BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + +#include +#include +#include +#include + +#include +#include +#include +#include +#include + +#include +#include + +#ifdef LOG_TAG +#undef LOG_TAG +#endif + +#define LOG_TAG "TIZEN_N_APP_MANAGER" + +#define MENU_PKG_VCONF_KEY "memory/menuscreen/desktop" + +#define EVENT_CREATE "create" +#define EVENT_UPDATE "update" +#define EVENT_DELETE "delete" + +typedef struct { + app_manager_app_running_cb cb; + void *user_data; + bool *foreach_break; +} running_apps_foreach_cb_context; + +typedef struct { + app_manager_app_installed_cb cb; + void *user_data; +} installed_apps_foreach_cb_context; + +static app_manager_app_list_changed_cb app_list_changed_cb = NULL; + +static void app_manager_meun_pkg_changed(keynode_t* node, void *data); + +static int foreach_running_app_cb_broker(const aul_app_info * appcore_app_info, void *appcore_user_data) +{ + ail_appinfo_h handle; + ail_error_e ret; + bool task_manage = false; + running_apps_foreach_cb_context *foreach_cb_context = NULL; + + if (appcore_app_info == NULL || appcore_user_data == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid callback context", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return 0; + } + + ret = ail_package_get_appinfo(appcore_app_info->pkg_name, &handle); + if (ret != AIL_ERROR_OK) + { + LOGE("[%s] DB_FAILED(0x%08x) : failed to get the app-info", __FUNCTION__, APP_MANAGER_ERROR_DB_FAILED); + return 0; + } + + // do not call callback function when X-SLP-TaskManage is set to false + ret = ail_appinfo_get_bool(handle, AIL_PROP_X_SLP_TASKMANAGE_BOOL, &task_manage); + + ail_package_destroy_appinfo(handle); + + if (ret != AIL_ERROR_OK || task_manage == false) + { + return 0; + } + + foreach_cb_context = (running_apps_foreach_cb_context *)appcore_user_data; + + if (foreach_cb_context->cb != NULL && *(foreach_cb_context->foreach_break) == false) + { + if (foreach_cb_context->cb(appcore_app_info->pkg_name, foreach_cb_context->user_data) == false) + { + *(foreach_cb_context->foreach_break) = true; + } + } + + return 0; +} + +static ail_cb_ret_e foreach_installed_app_cb_broker(const ail_appinfo_h appinfo, void *ail_user_data) +{ + installed_apps_foreach_cb_context *foreach_cb_context = NULL; + char *package; + + if (appinfo == NULL || ail_user_data == NULL) + { + return AIL_CB_RET_CANCEL; + } + + foreach_cb_context = (installed_apps_foreach_cb_context *)ail_user_data; + + ail_appinfo_get_str(appinfo, AIL_PROP_PACKAGE_STR, &package); + + if (foreach_cb_context->cb(package, foreach_cb_context->user_data) == false) + { + return AIL_CB_RET_CANCEL; + } + + return AIL_CB_RET_CONTINUE; + +} + + +static int app_manager_ail_error_handler(ail_error_e ail_error, const char *func) +{ + int error_code; + char *error_msg; + + switch(ail_error) + { + case AIL_ERROR_FAIL: + error_code = APP_MANAGER_ERROR_INVALID_PARAMETER; + error_msg = "INVALID_PARAMETER"; + break; + + case AIL_ERROR_DB_FAILED: + error_code = APP_MANAGER_ERROR_DB_FAILED; + error_msg = "DB_FAILED"; + break; + + case AIL_ERROR_OUT_OF_MEMORY: + error_code = APP_MANAGER_ERROR_OUT_OF_MEMORY; + error_msg = "OUT_OF_MEMORY"; + break; + + case AIL_ERROR_INVALID_PARAMETER: + error_code = APP_MANAGER_ERROR_INVALID_PARAMETER; + error_msg = "INVALID_PARAMETER"; + break; + + case AIL_ERROR_OK: + error_code = APP_MANAGER_ERROR_NONE; + break; + + default: + error_code = APP_MANAGER_ERROR_INVALID_PARAMETER; + error_msg = "INVALID_PARAMETER"; + } + + if (error_code != APP_MANAGER_ERROR_NONE) + { + LOGE("[%s] %s(0x%08x)", func, error_msg, error_code); + } + + return error_code; +} + + +int app_manager_foreach_app_running(app_manager_app_running_cb callback, void *user_data) +{ + bool foreach_break = false; + + running_apps_foreach_cb_context foreach_cb_context = { + .cb = callback, + .user_data = user_data, + .foreach_break = &foreach_break + }; + + if (callback == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid callback", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + aul_app_get_running_app_info(foreach_running_app_cb_broker, &foreach_cb_context); + + return APP_MANAGER_ERROR_NONE; +} + +int app_manager_is_running(const char *package, bool *is_running) +{ + if (package == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid package", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + if (is_running == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid output param", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + *is_running = aul_app_is_running(package); + + return APP_MANAGER_ERROR_NONE; +} + + int app_manager_foreach_app_installed(app_manager_app_installed_cb callback, void *user_data) +{ + ail_filter_h filter; + ail_error_e ret; + + if (callback == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid callback", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + ret = ail_filter_new(&filter); + if (ret != AIL_ERROR_OK) + { + return app_manager_ail_error_handler(ret, __FUNCTION__); + } + + // Provide visible application to 3rd party developer + ret = ail_filter_add_bool(filter, AIL_PROP_NODISPLAY_BOOL, false); + if (ret != AIL_ERROR_OK) + { + ail_filter_destroy(filter); + return app_manager_ail_error_handler(ret, __FUNCTION__); + } + + // Provide task manageable app only to 3rd party developer + ret = ail_filter_add_bool(filter, AIL_PROP_X_SLP_TASKMANAGE_BOOL, true); + if (ret != AIL_ERROR_OK) + { + ail_filter_destroy(filter); + return app_manager_ail_error_handler(ret, __FUNCTION__); + } + + installed_apps_foreach_cb_context foreach_cb_context = { + .cb = callback, + .user_data = user_data, + }; + + ail_filter_list_appinfo_foreach(filter, foreach_installed_app_cb_broker, &foreach_cb_context); + + ail_filter_destroy(filter); + + return APP_MANAGER_ERROR_NONE; +} + +static int app_manager_get_appinfo(const char *package, ail_prop_str_e property, char **value) +{ + ail_error_e ail_error; + ail_appinfo_h appinfo; + char *appinfo_value; + char *appinfo_value_dup; + + ail_error = ail_package_get_appinfo(package, &appinfo); + if (ail_error != AIL_ERROR_OK) + { + return app_manager_ail_error_handler(ail_error, __FUNCTION__); + } + + ail_error = ail_appinfo_get_str(appinfo, property, &appinfo_value); + if (ail_error != AIL_ERROR_OK) + { + ail_package_destroy_appinfo(appinfo); + return app_manager_ail_error_handler(ail_error, __FUNCTION__); + } + + appinfo_value_dup = strdup(appinfo_value); + + ail_package_destroy_appinfo(appinfo); + + if (appinfo_value_dup == NULL) + { + LOGE("[%s] OUT_OF_MEMORY(0x%08x)", __FUNCTION__, APP_MANAGER_ERROR_OUT_OF_MEMORY); + return APP_MANAGER_ERROR_OUT_OF_MEMORY; + } + + *value = appinfo_value_dup; + + return APP_MANAGER_ERROR_NONE; +} + +int app_manager_get_app_name(const char *package, char** name) +{ + if (package == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid package", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + return app_manager_get_appinfo(package, AIL_PROP_NAME_STR, name); +} + +int app_manager_get_app_icon_path(const char *package, char** icon_path) +{ + if (package == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid package", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + return app_manager_get_appinfo(package, AIL_PROP_ICON_STR, icon_path); +} + +int app_manager_get_app_version(const char *package, char** version) +{ + if (package == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid package", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + return app_manager_get_appinfo(package, AIL_PROP_VERSION_STR, version); +} + +int app_manager_set_app_list_changed_cb(app_manager_app_list_changed_cb callback, void* user_data) +{ + if (callback == NULL) + { + LOGE("[%s] INVALID_PARAMETER(0x%08x) : invalid callback", __FUNCTION__, APP_MANAGER_ERROR_INVALID_PARAMETER); + return APP_MANAGER_ERROR_INVALID_PARAMETER; + } + + if (app_list_changed_cb == NULL) + { + vconf_notify_key_changed(MENU_PKG_VCONF_KEY, app_manager_meun_pkg_changed, user_data); + } + + app_list_changed_cb = callback; + + return APP_MANAGER_ERROR_NONE; +} + +void app_manager_unset_app_list_changed_cb() +{ + if (app_list_changed_cb != NULL) + { + vconf_ignore_key_changed(MENU_PKG_VCONF_KEY, app_manager_meun_pkg_changed); + } + + app_list_changed_cb = NULL; +} + +static void app_manager_meun_pkg_changed(keynode_t* node, void *data) +{ + char *pkg_event; + char type[10]; + char package[1024]; + + pkg_event = vconf_get_str(vconf_keynode_get_name(node)); + if(!pkg_event) { + LOGE("[%s] failed to get the package event"); + return; + } + + if (sscanf(pkg_event, "%10[^:]:%1023s", type, package) != 2) + { + LOGE("[%s] failed to parse the package event format : [%s], [%s]", __FUNCTION__, type, package); + } + + + if(app_list_changed_cb == NULL) + { + return; + } + + if(!strcasecmp(type, EVENT_CREATE)) + { + // A new application has been installed. + app_list_changed_cb(APP_MANAGER_EVENT_INSTALLED, package, data); + } + else if( !strcasecmp(type, EVENT_UPDATE)) + { + // An existing application has been updated. + app_list_changed_cb(APP_MANAGER_EVENT_UPDATED , package, data); + } + + else if( !strcasecmp(type, EVENT_DELETE)) + { + // An existing application has been uninstalled. + app_list_changed_cb(APP_MANAGER_EVENT_UNINSTALLED , package, data); + } + else + { + LOGE("[%s] invalid event : type(%s)", __FUNCTION__, type); + } + +} + -- cgit v1.2.3