AS_TYPE_APP

#define AS_TYPE_APP (as_app_get_type ())

struct AsAppClass

struct AsAppClass {
	GObjectClass		parent_class;
};

enum AsAppParseFlags

typedef enum {
	AS_APP_PARSE_FLAG_NONE,
	AS_APP_PARSE_FLAG_USE_HEURISTICS = 1, /* Since: 0.1.2 */
	AS_APP_PARSE_FLAG_KEEP_COMMENTS		= 2, /* Since: 0.1.6 */
	AS_APP_PARSE_FLAG_CONVERT_TRANSLATABLE = 4, /* Since: 0.1.6 */
	AS_APP_PARSE_FLAG_APPEND_DATA		= 8, /* Since: 0.1.8 */
	AS_APP_PARSE_FLAG_ALLOW_VETO		= 16, /* Since: 0.2.5 */
	AS_APP_PARSE_FLAG_USE_FALLBACKS		= 32, /* Since: 0.4.1 */
} AsAppParseFlags;

The flags to use when parsing resources.

enum AsAppSubsumeFlags

typedef enum {
	AS_APP_SUBSUME_FLAG_NONE,
	AS_APP_SUBSUME_FLAG_NO_OVERWRITE = 1, /* Since: 0.1.4 */
	AS_APP_SUBSUME_FLAG_BOTH_WAYS	 = 2, /* Since: 0.1.4 */
	AS_APP_SUBSUME_FLAG_PARTIAL	 = 4, /* Since: 0.2.2 */
} AsAppSubsumeFlags;

The flags to use when subsuming applications.

enum AsAppError

typedef enum {
	AS_APP_ERROR_FAILED,
	AS_APP_ERROR_INVALID_TYPE,
} AsAppError;

The error type.

enum AsAppValidateFlags

typedef enum {
	AS_APP_VALIDATE_FLAG_NONE		= 0, /* Since: 0.1.4 */
	AS_APP_VALIDATE_FLAG_RELAX		= 1, /* Since: 0.1.4 */
	AS_APP_VALIDATE_FLAG_STRICT		= 2, /* Since: 0.1.4 */
	AS_APP_VALIDATE_FLAG_NO_NETWORK		= 4, /* Since: 0.1.4 */
	AS_APP_VALIDATE_FLAG_ALL_APPS		= 8, /* Since: 0.2.6 */
} AsAppValidateFlags;

The flags to use when validating.

enum AsAppTrustFlags

typedef enum {
	AS_APP_TRUST_FLAG_COMPLETE		= 0, /* Since: 0.2.2 */
	AS_APP_TRUST_FLAG_CHECK_DUPLICATES = 1, /* Since: 0.2.2 */
	AS_APP_TRUST_FLAG_CHECK_VALID_UTF8 = 2, /* Since: 0.2.2 */
} AsAppTrustFlags;

The flags to use when checking input.

enum AsAppSourceKind

typedef enum {
	AS_APP_SOURCE_KIND_UNKNOWN,			/* Since: 0.1.4 */
	AS_APP_SOURCE_KIND_APPSTREAM,			/* Since: 0.1.4 */
	AS_APP_SOURCE_KIND_DESKTOP,			/* Since: 0.1.4 */
	AS_APP_SOURCE_KIND_APPDATA,			/* Since: 0.1.4 */
	AS_APP_SOURCE_KIND_METAINFO,			/* Since: 0.1.7 */
	AS_APP_SOURCE_KIND_INF,				/* Since: 0.3.5 */
} AsAppSourceKind;

The source kind.

enum AsAppState

typedef enum {
	AS_APP_STATE_UNKNOWN,				/* Since: 0.2.2 */
	AS_APP_STATE_INSTALLED,				/* Since: 0.2.2 */
	AS_APP_STATE_AVAILABLE,				/* Since: 0.2.2 */
	AS_APP_STATE_AVAILABLE_LOCAL,			/* Since: 0.2.2 */
	AS_APP_STATE_UPDATABLE,				/* Since: 0.2.2 */
	AS_APP_STATE_UNAVAILABLE,			/* Since: 0.2.2 */
	AS_APP_STATE_QUEUED_FOR_INSTALL,		/* Since: 0.2.2 */
	AS_APP_STATE_INSTALLING,			/* Since: 0.2.2 */
	AS_APP_STATE_REMOVING,				/* Since: 0.2.2 */
} AsAppState;

The application state.

AS_APP_ERROR

#define AS_APP_ERROR				as_app_error_quark ()

as_app_new ()

AsApp *             as_app_new                          (void);

Creates a new AsApp.

Since 0.1.0

as_app_error_quark ()

GQuark              as_app_error_quark                  (void);

Since 0.1.2

as_app_guess_source_kind ()

AsAppSourceKind     as_app_guess_source_kind            (const gchar *filename);

Guesses the source kind based from the filename.

Since 0.1.8

as_app_source_kind_from_string ()

AsAppSourceKind     as_app_source_kind_from_string      (const gchar *source_kind);

Converts the text representation to an enumerated value.

Since 0.2.2

as_app_source_kind_to_string ()

const gchar *       as_app_source_kind_to_string        (AsAppSourceKind source_kind);

Converts the enumerated value to an text representation.

Since 0.2.2

as_app_state_to_string ()

const gchar *       as_app_state_to_string              (AsAppState state);

Converts the enumerated value to an text representation.

Since 0.2.2

as_app_get_id_kind ()

AsIdKind            as_app_get_id_kind                  (AsApp *app);

Gets the ID kind.

Since 0.1.0

as_app_get_source_kind ()

AsAppSourceKind     as_app_get_source_kind              (AsApp *app);

Gets the source kind, i.e. where the AsApp came from.

Since 0.1.4

as_app_get_state ()

AsAppState          as_app_get_state                    (AsApp *app);

Gets the application state.

Since 0.2.2

as_app_get_trust_flags ()

AsAppTrustFlags     as_app_get_trust_flags              (AsApp *app);

Gets the trust flags, i.e. how trusted the incoming data is.

Since 0.2.2

as_app_get_languages ()

GList *             as_app_get_languages                (AsApp *app);

Get a list of all languages.

Since 0.1.0

as_app_get_addons ()

GPtrArray *         as_app_get_addons                   (AsApp *app);

Gets all the addons the application has.

Since 0.1.7

as_app_get_categories ()

GPtrArray *         as_app_get_categories               (AsApp *app);

Get the application categories.

Since 0.1.0

as_app_get_compulsory_for_desktops ()

GPtrArray *         as_app_get_compulsory_for_desktops  (AsApp *app);

Returns the desktops where this application is compulsory.

Since 0.1.0

as_app_get_extends ()

GPtrArray *         as_app_get_extends                  (AsApp *app);

Gets the IDs that are extended from the addon.

Since 0.1.7

as_app_get_keywords ()

GPtrArray *         as_app_get_keywords                 (AsApp *app,
                                                         const gchar *locale);

Gets any keywords the application should match against.

Since 0.3.0

as_app_get_kudos ()

GPtrArray *         as_app_get_kudos                    (AsApp *app);

Gets any kudos the application has obtained.

Since 0.2.2

as_app_get_permissions ()

GPtrArray *         as_app_get_permissions              (AsApp *app);

Gets any permissions the application has obtained.

Since 0.3.5

as_app_get_mimetypes ()

GPtrArray *         as_app_get_mimetypes                (AsApp *app);

Gets any mimetypes the application will register.

Since 0.2.0

as_app_get_pkgnames ()

GPtrArray *         as_app_get_pkgnames                 (AsApp *app);

Gets the package names (if any) for the application.

Since 0.1.0

as_app_get_architectures ()

GPtrArray *         as_app_get_architectures            (AsApp *app);

Gets the supported architectures for the application, or an empty list if all architectures are supported.

Since 0.1.1

as_app_get_releases ()

GPtrArray *         as_app_get_releases                 (AsApp *app);

Gets all the releases the application has had.

Since 0.1.0

as_app_get_provides ()

GPtrArray *         as_app_get_provides                 (AsApp *app);

Gets all the provides the application has.

Since 0.1.6

as_app_get_screenshots ()

GPtrArray *         as_app_get_screenshots              (AsApp *app);

Gets any screenshots the application has defined.

Since 0.1.0

as_app_get_icons ()

GPtrArray *         as_app_get_icons                    (AsApp *app);

Gets any icons the application has defined.

Since 0.3.1

as_app_get_bundles ()

GPtrArray *         as_app_get_bundles                  (AsApp *app);

Gets any bundles the application has defined.

Since 0.3.5

as_app_get_names ()

GHashTable *        as_app_get_names                    (AsApp *app);

Gets the names set for the application.

Since 0.1.6

as_app_get_comments ()

GHashTable *        as_app_get_comments                 (AsApp *app);

Gets the comments set for the application.

Since 0.1.6

as_app_get_developer_names ()

GHashTable *        as_app_get_developer_names          (AsApp *app);

Gets the developer_names set for the application.

Since 0.1.8

as_app_get_metadata ()

GHashTable *        as_app_get_metadata                 (AsApp *app);

Gets the metadata set for the application.

Since 0.1.6

as_app_get_descriptions ()

GHashTable *        as_app_get_descriptions             (AsApp *app);

Gets the descriptions set for the application.

Since 0.1.6

as_app_get_urls ()

GHashTable *        as_app_get_urls                     (AsApp *app);

Gets the URLs set for the application.

Since 0.1.0

as_app_get_vetos ()

GPtrArray *         as_app_get_vetos                    (AsApp *app);

Gets the list of vetos.

Since 0.2.5

as_app_get_icon_path ()

const gchar *       as_app_get_icon_path                (AsApp *app);

Gets the application icon path.

Since 0.1.0

as_app_get_id_filename ()

const gchar *       as_app_get_id_filename              (AsApp *app);

Returns a filename which represents the applications ID, e.g. "gimp.desktop" becomes "gimp" and is used for cache directories.

Since 0.3.0

as_app_get_id ()

const gchar *       as_app_get_id                       (AsApp *app);

Gets the full ID value.

Since 0.1.0

as_app_get_pkgname_default ()

const gchar *       as_app_get_pkgname_default          (AsApp *app);

Gets the default package name.

Since 0.2.0

as_app_get_source_pkgname ()

const gchar *       as_app_get_source_pkgname           (AsApp *app);

Gets the source package name that produced the binary package. Only source packages producing more than one binary package will have this entry set.

Since 0.2.4

as_app_get_origin ()

const gchar *       as_app_get_origin                   (AsApp *app);

Gets the application origin.

Since 0.3.2

as_app_get_project_group ()

const gchar *       as_app_get_project_group            (AsApp *app);

Gets an application project group.

Since 0.1.0

as_app_get_project_license ()

const gchar *       as_app_get_project_license          (AsApp *app);

Gets the application project license.

Since 0.1.0

as_app_get_metadata_license ()

const gchar *       as_app_get_metadata_license         (AsApp *app);

Gets the application project license.

Since 0.1.4

as_app_get_update_contact ()

const gchar *       as_app_get_update_contact           (AsApp *app);

Gets the application upstream update contact email.

Since 0.1.4

as_app_get_source_file ()

const gchar *       as_app_get_source_file              (AsApp *app);

Gets the source filename the instance was populated from.

NOTE: this is not set for AS_APP_SOURCE_KIND_APPSTREAM entries.

Since 0.2.2

as_app_get_name ()

const gchar *       as_app_get_name                     (AsApp *app,
                                                         const gchar *locale);

Gets the application name for a specific locale.

Since 0.1.0

as_app_get_comment ()

const gchar *       as_app_get_comment                  (AsApp *app,
                                                         const gchar *locale);

Gets the application summary for a specific locale.

Since 0.1.0

as_app_get_developer_name ()

const gchar *       as_app_get_developer_name           (AsApp *app,
                                                         const gchar *locale);

Gets the application developer name for a specific locale.

Since 0.1.8

as_app_get_description ()

const gchar *       as_app_get_description              (AsApp *app,
                                                         const gchar *locale);

Gets the application description markup for a specific locale.

Since 0.1.0

as_app_get_priority ()

gint                as_app_get_priority                 (AsApp *app);

Gets the application priority. Larger values trump smaller values.

Since 0.1.0

as_app_get_language ()

gint                as_app_get_language                 (AsApp *app,
                                                         const gchar *locale);

Gets the language coverage for the specific language.

Since 0.1.0

as_app_get_metadata_item ()

const gchar *       as_app_get_metadata_item            (AsApp *app,
                                                         const gchar *key);

Gets some metadata item.

Since 0.1.0

as_app_get_url_item ()

const gchar *       as_app_get_url_item                 (AsApp *app,
                                                         AsUrlKind url_kind);

Gets a URL.

Since 0.1.0

as_app_has_category ()

gboolean            as_app_has_category                 (AsApp *app,
                                                         const gchar *category);

Searches the category list for a specific item.

Since 0.1.5

as_app_has_kudo ()

gboolean            as_app_has_kudo                     (AsApp *app,
                                                         const gchar *kudo);

Searches the kudo list for a specific item.

Since 0.2.2

as_app_has_kudo_kind ()

gboolean            as_app_has_kudo_kind                (AsApp *app,
                                                         AsKudoKind kudo);

Searches the kudo list for a specific item.

Since 0.2.2

as_app_has_permission ()

gboolean            as_app_has_permission               (AsApp *app,
                                                         const gchar *permission);

Searches the permission list for a specific item.

Since 0.3.5

as_app_set_id ()

void                as_app_set_id                       (AsApp *app,
                                                         const gchar *id);

Sets a new application ID. Any invalid characters will be automatically replaced.

Since 0.1.0

as_app_set_id_kind ()

void                as_app_set_id_kind                  (AsApp *app,
                                                         AsIdKind id_kind);

Sets the application kind.

Since 0.1.0

as_app_set_source_kind ()

void                as_app_set_source_kind              (AsApp *app,
                                                         AsAppSourceKind source_kind);

Sets the source kind.

Since 0.1.4

as_app_set_state ()

void                as_app_set_state                    (AsApp *app,
                                                         AsAppState state);

Sets the application state.

Since 0.2.2

as_app_set_trust_flags ()

void                as_app_set_trust_flags              (AsApp *app,
                                                         AsAppTrustFlags trust_flags);

Sets the check flags, where AS_APP_TRUST_FLAG_COMPLETE is completely trusted input.

Since 0.2.2

as_app_set_origin ()

void                as_app_set_origin                   (AsApp *app,
                                                         const gchar *origin);

Sets the application origin.

Since 0.3.2

as_app_set_project_group ()

void                as_app_set_project_group            (AsApp *app,
                                                         const gchar *project_group);

Set any project affiliation.

Since 0.1.0

as_app_set_project_license ()

void                as_app_set_project_license          (AsApp *app,
                                                         const gchar *project_license);

Set the project license.

Since 0.1.0

as_app_set_metadata_license ()

void                as_app_set_metadata_license         (AsApp *app,
                                                         const gchar *metadata_license);

Set the project license.

Since 0.1.4

as_app_set_source_pkgname ()

void                as_app_set_source_pkgname           (AsApp *app,
                                                         const gchar *source_pkgname);

Set the project license.

Since 0.2.4

as_app_set_update_contact ()

void                as_app_set_update_contact           (AsApp *app,
                                                         const gchar *update_contact);

Set the project license.

Since 0.1.4

as_app_set_icon_path ()

void                as_app_set_icon_path                (AsApp *app,
                                                         const gchar *icon_path);

Sets the icon path, where local icons would be found.

Since 0.1.0

as_app_set_name ()

void                as_app_set_name                     (AsApp *app,
                                                         const gchar *locale,
                                                         const gchar *name);

Sets the application name for a specific locale.

Since 0.1.0

as_app_set_comment ()

void                as_app_set_comment                  (AsApp *app,
                                                         const gchar *locale,
                                                         const gchar *comment);

Sets the application summary for a specific locale.

Since 0.1.0

as_app_set_developer_name ()

void                as_app_set_developer_name           (AsApp *app,
                                                         const gchar *locale,
                                                         const gchar *developer_name);

Sets the application developer name for a specific locale.

Since 0.1.0

as_app_set_description ()

void                as_app_set_description              (AsApp *app,
                                                         const gchar *locale,
                                                         const gchar *description);

Sets the application descrption markup for a specific locale.

Since 0.1.0

as_app_set_source_file ()

void                as_app_set_source_file              (AsApp *app,
                                                         const gchar *source_file);

Set the file that the instance was sourced from.

Since 0.2.2

as_app_set_priority ()

void                as_app_set_priority                 (AsApp *app,
                                                         gint priority);

Sets the application priority, where 0 is default and positive numbers are better than negative numbers.

Since 0.1.0

as_app_add_category ()

void                as_app_add_category                 (AsApp *app,
                                                         const gchar *category);

Adds a menu category to the application.

Since 0.1.0

as_app_add_keyword ()

void                as_app_add_keyword                  (AsApp *app,
                                                         const gchar *locale,
                                                         const gchar *keyword);

Add a keyword the application should match against.

Since 0.3.0

as_app_add_kudo ()

void                as_app_add_kudo                     (AsApp *app,
                                                         const gchar *kudo);

Add a kudo the application has obtained.

Since 0.2.2

as_app_add_kudo_kind ()

void                as_app_add_kudo_kind                (AsApp *app,
                                                         AsKudoKind kudo_kind);

Add a kudo the application has obtained.

Since 0.2.2

as_app_add_permission ()

void                as_app_add_permission               (AsApp *app,
                                                         const gchar *permission);

Add a permission the application has obtained.

Since 0.3.5

as_app_add_mimetype ()

void                as_app_add_mimetype                 (AsApp *app,
                                                         const gchar *mimetype);

Adds a mimetype the application can process.

Since 0.1.0

as_app_add_pkgname ()

void                as_app_add_pkgname                  (AsApp *app,
                                                         const gchar *pkgname);

Adds a package name to an application.

Since 0.1.0

as_app_add_arch ()

void                as_app_add_arch                     (AsApp *app,
                                                         const gchar *arch);

Adds a package name to an application.

Since 0.1.1

as_app_add_release ()

void                as_app_add_release                  (AsApp *app,
                                                         AsRelease *release);

Adds a release to an application.

Since 0.1.0

as_app_add_provide ()

void                as_app_add_provide                  (AsApp *app,
                                                         AsProvide *provide);

Adds a provide to an application.

Since 0.1.6

as_app_add_screenshot ()

void                as_app_add_screenshot               (AsApp *app,
                                                         AsScreenshot *screenshot);

Adds a screenshot to an application.

Since 0.1.0

as_app_add_icon ()

void                as_app_add_icon                     (AsApp *app,
                                                         AsIcon *icon);

Adds a icon to an application.

Since 0.3.1

as_app_add_bundle ()

void                as_app_add_bundle                   (AsApp *app,
                                                         AsBundle *bundle);

Adds a bundle to an application.

Since 0.3.5

as_app_add_language ()

void                as_app_add_language                 (AsApp *app,
                                                         gint percentage,
                                                         const gchar *locale);

Adds a language to the application.

Since 0.1.0

as_app_add_compulsory_for_desktop ()

void                as_app_add_compulsory_for_desktop   (AsApp *app,
                                                         const gchar *compulsory_for_desktop);

Adds a desktop that requires this application to be installed.

Since 0.1.0

as_app_add_url ()

void                as_app_add_url                      (AsApp *app,
                                                         AsUrlKind url_kind,
                                                         const gchar *url);

Adds some URL data to the application.

Since 0.1.0

as_app_add_metadata ()

void                as_app_add_metadata                 (AsApp *app,
                                                         const gchar *key,
                                                         const gchar *value);

Adds a metadata entry to the application.

Since 0.1.0

as_app_remove_metadata ()

void                as_app_remove_metadata              (AsApp *app,
                                                         const gchar *key);

Removes a metadata item from the application.

Since 0.1.0

as_app_add_addon ()

void                as_app_add_addon                    (AsApp *app,
                                                         AsApp *addon);

Adds a addon to an application.

Since 0.1.7

as_app_add_extends ()

void                as_app_add_extends                  (AsApp *app,
                                                         const gchar *extends);

Adds a parent ID to the application.

Since 0.1.7

as_app_validate ()

GPtrArray *         as_app_validate                     (AsApp *app,
                                                         AsAppValidateFlags flags,
                                                         GError **error);

Validates data in the instance for style and consitency.

Since 0.1.4

as_app_subsume ()

void                as_app_subsume                      (AsApp *app,
                                                         AsApp *donor);

Copies information from the donor to the application object.

Since 0.1.0

as_app_subsume_full ()

void                as_app_subsume_full                 (AsApp *app,
                                                         AsApp *donor,
                                                         AsAppSubsumeFlags flags);

Copies information from the donor to the application object.

Since 0.1.4

as_app_add_veto ()

void                as_app_add_veto                     (AsApp *app,
                                                         const gchar *fmt,
                                                         ...);

Adds a reason to not include the application in the metadata.

Since 0.2.5

as_app_remove_veto ()

void                as_app_remove_veto                  (AsApp *app,
                                                         const gchar *description);

Removes a reason to not include the application in the metadata.

Since 0.4.1

as_app_search_matches_all ()

guint               as_app_search_matches_all           (AsApp *app,
                                                         gchar **search);

Searches application data for all the specific keywords.

Since 0.1.3

as_app_search_matches ()

guint               as_app_search_matches               (AsApp *app,
                                                         const gchar *search);

Searches application data for a specific keyword.

Since 0.1.0

as_app_parse_file ()

gboolean            as_app_parse_file                   (AsApp *app,
                                                         const gchar *filename,
                                                         AsAppParseFlags flags,
                                                         GError **error);

Parses a desktop or AppData file and populates the application state.

Applications that are not suitable for the store will have vetos added.

Since 0.1.2

as_app_to_file ()

gboolean            as_app_to_file                      (AsApp *app,
                                                         GFile *file,
                                                         GCancellable *cancellable,
                                                         GError **error);

Exports a DOM tree to an XML file.

Since 0.2.0

as_app_get_icon_default ()

AsIcon *            as_app_get_icon_default             (AsApp *app);

Finds the default icon.

Since 0.3.1

as_app_get_icon_for_size ()

AsIcon *            as_app_get_icon_for_size            (AsApp *app,
                                                         guint width,
                                                         guint height);

Finds an icon of a specific size.

Since 0.3.1

as_app_get_bundle_default ()

AsBundle *          as_app_get_bundle_default           (AsApp *app);

Finds the default bundle.

Since 0.3.5

as_app_get_release ()

AsRelease *         as_app_get_release                  (AsApp *app,
                                                         const gchar *version);

Gets a specific release from the application.

Since 0.3.5

as_app_get_release_default ()

AsRelease *         as_app_get_release_default          (AsApp *app);

Gets the default (newest) release from the application.

Since 0.3.5

as_app_convert_icons ()

gboolean            as_app_convert_icons                (AsApp *app,
                                                         AsIconKind kind,
                                                         GError **error);

Converts all the icons in the application to a specific kind.

Since 0.3.1