Enable build with iniparser v 3.1
[platform/framework/native/appfw.git] / inc / FAppPkgPackageAppInfo.h
index 3a10c76..db74266 100755 (executable)
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
 #include <FAppTypes.h>
 #include <FAppPkgPackageManager.h>
 
+namespace Tizen { namespace Graphics
+{
+class Bitmap;
+} }
+
 namespace Tizen { namespace App { namespace Package
 {
 
 /**
  * @class              PackageAppInfo
- * @brief              This class represents the information of the application in package.
+ * @brief              This class represents the information of an application in a package.
  *
  * @since      2.0
  *
  * @final              This class is not intended for extension.
  *
- * The %PackageAppInfo class provides the information of the application in package.
+ * The %PackageAppInfo class provides the information of an application in a package.
  *
  */
 class _OSP_EXPORT_ PackageAppInfo
@@ -55,11 +59,11 @@ public:
        virtual ~PackageAppInfo(void);
 
        /**
-        * Gets an application ID.
+        * Gets the application ID.
         *
         * @since       2.0
         *
-        * @return An application ID
+        * @return      The application ID
         */
        AppId GetAppId(void) const;
 
@@ -68,7 +72,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The name of an application
+        * @return      The name of the application
         */
        Tizen::Base::String GetAppName(void) const;
 
@@ -77,53 +81,70 @@ public:
         *
         * @since       2.0
         *
-        * @return      The display name of an application
+        * @return      The display name of the application
         */
        Tizen::Base::String GetAppDisplayName(void) const;
 
        /**
-        * @if VISPARTNER-MANUFACTURER
-        * Gets the menu icon path of an application.
-        *
-        * @since       2.0
-        * @visibility  partner-manufacturer
-        * @privilege   %http://tizen.org/privilege/packagesetting
-        *
-        * @return      The menu icon path of an application, @n
-        *          else an empty string is returned if there is no value
-        * @endif
-        */
+       * Gets the menu icon path of an application.
+       *
+       * @since         2.1
+       *
+       * @return        The menu icon path of the application, @n
+       *                else an empty string is returned if there is no value
+       */
        Tizen::Base::String GetAppMenuIconPath(void) const;
 
        /**
-        * @if VISPARTNER-MANUFACTURER
-        * Gets the setting icon path of an application.
-        *
-        * @since       2.0
-        * @visibility  partner-manufacturer
-        * @privilege   %http://tizen.org/privilege/packagesetting
-        *
-        * @return      The setting icon path of an application, @n
-        *          else an empty string is returned if there is no value
-        * @endif
-        */
+       * Gets the setting icon path of an application.
+       *
+       * @since         2.1
+       *
+       * @return        The setting icon path of the application, @n
+       *                        else an empty string is returned if there is no value
+       */
        Tizen::Base::String GetAppSettingIconPath(void) const;
 
        /**
-        * @if VISPARTNER-MANUFACTURER
-        * Gets the notification icon path of an application.
-        *
-        * @since       2.0
-        * @visibility  partner-manufacturer
-        * @privilege   %http://tizen.org/privilege/packagesetting
-        *
-        * @return      The notification icon path of an application, @n
-        *          else an empty string is returned if there is no value
-        * @endif
-        */
+       * Gets the notification icon path of an application.
+       *
+       * @since         2.1
+       *
+       * @return        The notification icon path of the application, @n
+       *                else an empty string is returned if there is no value
+       */
        Tizen::Base::String GetAppNotificationIconPath(void) const;
 
        /**
+       * Gets the menu icon of an application.
+       *
+       * @since        2.1
+       *
+       * @return       A pointer to the menu icon of the application, @n
+       *               else @c null if it fails
+       * @exception    E_SUCCESS                     The method is successful.
+       * @exception    E_FILE_NOT_FOUND              The menu icon does not exist.
+       * @exception    E_UNSUPPORTED_FORMAT          The image file format is not supported.
+       * @remarks      The specific error code can be accessed using the GetLastResult() method.
+       */
+       Tizen::Graphics::Bitmap* GetAppMenuIconN(void) const;
+
+       /**
+       * Gets the metadata list of an application.
+       *
+       * @since         2.1
+       *
+       * @return       A pointer to the map of the key(Tizen::Base::String) and value(%Tizen::Base::String) pairs of the metadata, @n
+       *               else @c null if it fails
+       * @exception    E_SUCCESS                     The method is successful.
+       * @exception    E_SYSTEM                      The method cannot proceed due to a severe system error.
+       * @remarks
+       *                       - The specific error code can be accessed using the GetLastResult() method.
+       *                       - An application can use the metadata to set the app-wide information.
+       */
+       Tizen::Base::Collection::IMap* GetAppMetadataListN(void) const;
+
+       /**
         * Gets the category list of an application.
         *
         * @since       2.0
@@ -137,26 +158,26 @@ public:
        Tizen::Base::Collection::IList* GetAppCategoryListN(void) const;
 
        /**
-        * Checks whether an application is visible on the menu.
+        * Checks if an application is visible on the menu.
         *
         * @since       2.0
         *
-        * @return      @c true if an application is visible on the menu, @n
+        * @return      @c true if the application is visible on the menu, @n
         *                      else @c false
-        * @remarks If the return value is @c false, it is recommended not to display the application on the menu.
+        * @remarks If the return value is @c false, it is not recommended to display the application on the menu.
         */
        bool IsMenuIconVisible(void) const;
 
        /**
-        * Checks whether an application is the main application of the package.
+        * Checks if an application is the main application of the package.
         *
         * @since       2.0
         *
-        * @return      @c true if an application is the main application of the package, @n
+        * @return      @c true if the application is the main application of the package, @n
         *                      else @c false
         */
        bool IsMainApp(void) const;
-
+       
 private:
        /**
         * This is the default constructor for this class. This default constructor is intentionally
@@ -180,6 +201,8 @@ private:
        friend class _PackageAppInfoImpl;
        friend class _PackageInfoImpl;
        friend class _PackageManagerImpl;
+       friend class _PackageParser;
+       friend class _PackageManagerServer;
 
 }; // PackageAppInfo