Trait libflatpak::prelude::InstallationExtManual

source · 
pub trait InstallationExtManual:
    Sealed
    + IsA<Installation>
    + 'static {
    // Provided methods
    fn update_appstream_sync(
        &self,
        remote_name: &str,
        arch: Option<&str>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(), Error> { ... }
    fn update_appstream_full_sync(
        &self,
        remote_name: &str,
        arch: Option<&str>,
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(), Error> { ... }
    fn update_full(
        &self,
        flags: UpdateFlags,
        kind: RefKind,
        name: &str,
        arch: Option<&str>,
        branch: Option<&str>,
        subpaths: &[&str],
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<InstalledRef, Error> { ... }
    fn uninstall(
        &self,
        kind: RefKind,
        name: &str,
        arch: Option<&str>,
        branch: Option<&str>,
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(), Error> { ... }
    fn uninstall_full(
        &self,
        flags: UninstallFlags,
        kind: RefKind,
        name: &str,
        arch: Option<&str>,
        branch: Option<&str>,
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<(), Error> { ... }
    fn update(
        &self,
        flags: UpdateFlags,
        kind: RefKind,
        name: &str,
        arch: Option<&str>,
        branch: Option<&str>,
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<InstalledRef, Error> { ... }
    fn install(
        &self,
        remote_name: &str,
        kind: RefKind,
        name: &str,
        arch: Option<&str>,
        branch: Option<&str>,
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<InstalledRef, Error> { ... }
    fn install_bundle(
        &self,
        file: &impl IsA<File>,
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<InstalledRef, Error> { ... }
    fn install_full(
        &self,
        flags: InstallFlags,
        remote_name: &str,
        kind: RefKind,
        name: &str,
        arch: Option<&str>,
        branch: Option<&str>,
        subpaths: &[&str],
        progress: Option<&mut dyn FnMut(&str, u32, bool)>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<InstalledRef, Error> { ... }
    fn launch_full(
        &self,
        flags: LaunchFlags,
        name: &str,
        arch: Option<&str>,
        branch: Option<&str>,
        commit: Option<&str>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<Instance, Error> { ... }
}

Provided Methods§

source

fn update_appstream_sync( &self, remote_name: &str, arch: Option<&str>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

Updates the local copy of appstream for remote_name for the specified arch. If you need progress feedback, use update_appstream_full_sync().

§remote_name

the name of the remote

§arch

Architecture to update, or None for the local machine arch

§out_changed

Set to true if the contents of the appstream changed, false if nothing changed

§cancellable

a gio::Cancellable

§Returns

true on success, or false on error

source

fn update_appstream_full_sync( &self, remote_name: &str, arch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

Updates the local copy of appstream for remote_name for the specified arch.

§remote_name

the name of the remote

§arch

Architecture to update, or None for the local machine arch

§progress

progress callback

§progress_data

user data passed to progress

§out_changed

Set to true if the contents of the appstream changed, false if nothing changed

§cancellable

a gio::Cancellable

§Returns

true on success, or false on error

source

fn update_full( &self, flags: UpdateFlags, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, subpaths: &[&str], progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_update() instead. It has a lot more interesting features.

Update an application or runtime.

If the specified package is not installed, then Error::NotInstalled will be thrown.

If no updates could be found on the remote end and the package is already up to date, then Error::AlreadyInstalled will be thrown.

§Deprecated since 1.7

Use TransactionExt::add_update() instead.

§flags

set of UpdateFlags flag

§kind

whether this is an app or runtime

§name

name of the app or runtime to update

§arch

architecture of the app or runtime to update (default: current architecture)

§branch

name of the branch of the app or runtime to update (default: master)

§subpaths

A list of subpaths to fetch, or None for everything

§progress

the callback

§progress_data

user data passed to progress

§cancellable

a gio::Cancellable

§Returns

The ref for the newly updated app or None on failure

source

fn uninstall( &self, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_uninstall() instead. It has a lot more interesting features.

Uninstall an application or runtime.

§Deprecated since 1.7

Use TransactionExt::add_uninstall() instead.

§kind

what this ref contains (an RefKind)

§name

name of the app or runtime to uninstall

§arch

architecture of the app or runtime to uninstall; if None, default_arch() is assumed

§branch

name of the branch of the app or runtime to uninstall; if None, master is assumed

§progress

the callback

§progress_data

user data passed to progress

§cancellable

a gio::Cancellable

§Returns

true on success

source

fn uninstall_full( &self, flags: UninstallFlags, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_uninstall() instead. It has a lot more interesting features.

Uninstall an application or runtime.

§Deprecated since 1.7

Use TransactionExt::add_uninstall() instead.

§flags

set of UninstallFlags flags

§kind

what this ref contains (an RefKind)

§name

name of the app or runtime to uninstall

§arch

architecture of the app or runtime to uninstall; if None, default_arch() is assumed

§branch

name of the branch of the app or runtime to uninstall; if None, master is assumed

§progress

the callback

§progress_data

user data passed to progress

§cancellable

a gio::Cancellable

§Returns

true on success

source

fn update( &self, flags: UpdateFlags, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_update() instead. It has a lot more interesting features.

Update an application or runtime.

If the specified package is not installed, then Error::NotInstalled will be thrown.

If no updates could be found on the remote end and the package is already up to date, then Error::AlreadyInstalled will be thrown.

§Deprecated since 1.7

Use TransactionExt::add_update() instead.

§flags

set of UpdateFlags flag

§kind

whether this is an app or runtime

§name

name of the app or runtime to update

§arch

architecture of the app or runtime to update (default: current architecture)

§branch

name of the branch of the app or runtime to update (default: master)

§progress

the callback

§progress_data

user data passed to progress

§cancellable

a gio::Cancellable

§Returns

The ref for the newly updated app or None on failure

source

fn install( &self, remote_name: &str, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_install() instead. It has a lot more interesting features.

Install a new application or runtime.

Note that this function was originally written to always return a InstalledRef. Since 0.9.13, passing FLATPAK_INSTALL_FLAGS_NO_DEPLOY will only pull refs into the local flatpak repository without deploying them, however this function will be unable to provide information on the installed ref, so FLATPAK_ERROR_ONLY_PULLED will be set and the caller must respond accordingly.

§Deprecated since 1.7

Use TransactionExt::add_install() instead.

§remote_name

name of the remote to use

§kind

what this ref contains (an RefKind)

§name

name of the app/runtime to fetch

§arch

which architecture to fetch (default: current architecture)

§branch

which branch to fetch (default: ‘master’)

§progress

progress callback

§progress_data

user data passed to progress

§cancellable

a gio::Cancellable

§Returns

The ref for the newly installed app or None on failure

source

fn install_bundle( &self, file: &impl IsA<File>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_install_bundle() instead. It has a lot more interesting features.

Install an application or runtime from an flatpak bundle file. See flatpak-build-bundle(1) for how to create bundles.

§Deprecated since 1.7

Use TransactionExt::add_install_bundle() instead.

§file

a gio::File that is an flatpak bundle

§progress

progress callback

§progress_data

user data passed to progress

§cancellable

a gio::Cancellable

§Returns

The ref for the newly installed app or None on failure

source

fn install_full( &self, flags: InstallFlags, remote_name: &str, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, subpaths: &[&str], progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_install() instead. It has a lot more interesting features.

Install a new application or runtime.

Note that this function was originally written to always return a InstalledRef. Since 0.9.13, passing FLATPAK_INSTALL_FLAGS_NO_DEPLOY will only pull refs into the local flatpak repository without deploying them, however this function will be unable to provide information on the installed ref, so FLATPAK_ERROR_ONLY_PULLED will be set and the caller must respond accordingly.

§Deprecated since 1.7

Use TransactionExt::add_install() instead.

§flags

set of InstallFlags flag

§remote_name

name of the remote to use

§kind

what this ref contains (an RefKind)

§name

name of the app/runtime to fetch

§arch

which architecture to fetch (default: current architecture)

§branch

which branch to fetch (default: ‘master’)

§subpaths

A list of subpaths to fetch, or None for everything

§progress

progress callback

§progress_data

user data passed to progress

§cancellable

a gio::Cancellable

§Returns

The ref for the newly installed app or None on failure

source

fn launch_full( &self, flags: LaunchFlags, name: &str, arch: Option<&str>, branch: Option<&str>, commit: Option<&str>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<Instance, Error>

Launch an installed application.

You can use flatpak_installation_get_installed_ref() or InstallationExt::current_installed_app() to find out what builds are available, in order to get a value for commit.

Compared to InstallationExt::launch(), this function returns a Instance that can be used to get information about the running instance. You can also use it to wait for the instance to be done with g_child_watch_add() if you pass the LaunchFlags::DO_NOT_REAP flag.

§flags

set of LaunchFlags

§name

name of the app to launch

§arch

which architecture to launch (default: current architecture)

§branch

which branch of the application (default: “master”)

§commit

the commit of branch to launch

§instance_out

return location for a Instance

§cancellable

a gio::Cancellable

§Returns

true, unless an error occurred

Object Safety§

This trait is not object safe.

Implementors§