Skip to main content

KeyOS API Reference

LaunchFailureReason

gui_server_api::msg

Enum LaunchFailureReason

pub enum LaunchFailureReason {
    SignatureRejected,
    NoCertificate,
    PublisherCertificateExpired,
    PublisherCertificateNotYetActive,
    KeyOsVersionTooOld,
    Internal,
    RunningKeyOsVersionUnavailable,
}

Expand description

Reason an app launch failed. Carries enough information for the SDK / UI to pick a useful follow-up (import a cert, enable developer mode, restart, …) instead of just printing a generic “launch failed” message.

Variants§

SignatureRejected

App is signed by a key not in the allowed set.

NoCertificate

No matching allowed-publisher certificate is installed, so this third-party app cannot launch.

PublisherCertificateExpired

The matching publisher certificate’s validity window has passed.

PublisherCertificateNotYetActive

The matching publisher certificate’s validity window has not started yet.

KeyOsVersionTooOld

The app requires a newer KeyOS release.

Internal

Anything else: app-manager-internal failure, IPC failure, etc.

RunningKeyOsVersionUnavailable

The running KeyOS version could not be determined, so compatibility cannot be checked.

Trait Implementations§

impl Archive for LaunchFailureReason

type Archived = ArchivedLaunchFailureReason

The archived representation of this type. Read more

type Resolver = LaunchFailureReasonResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve( &self, resolver: <Self as Archive>::Resolver, out: Place<<Self as Archive>::Archived>, )

Creates the archived version of this value at the given position and writes it to the given output. Read more

const COPY_OPTIMIZATION: CopyOptimization<Self> = _

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize. Read more

impl Clone for LaunchFailureReason

fn clone(&self) -> LaunchFailureReason

Returns a duplicate of the value. Read more

1.0.0§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

impl Debug for LaunchFailureReason

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

impl<D: Fallible + ?Sized> Deserialize<LaunchFailureReason, D> for Archived<LaunchFailureReason>

fn deserialize( &self, deserializer: &mut D, ) -> Result<LaunchFailureReason, <D as Fallible>::Error>

Deserializes using the given deserializer

impl PartialEq for LaunchFailureReason

fn eq(&self, other: &LaunchFailureReason) -> bool

Tests for self and other values to be equal, and is used by ==.

1.0.0§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<S: Fallible + ?Sized> Serialize<S> for LaunchFailureReason

fn serialize( &self, serializer: &mut S, ) -> Result<<Self as Archive>::Resolver, <S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.

impl Eq for LaunchFailureReason

impl StructuralPartialEq for LaunchFailureReason

Auto Trait Implementations§

impl Freeze for LaunchFailureReason

impl RefUnwindSafe for LaunchFailureReason

impl Send for LaunchFailureReason

impl Sync for LaunchFailureReason

impl Unpin for LaunchFailureReason

impl UnsafeUnpin for LaunchFailureReason

impl UnwindSafe for LaunchFailureReason

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> ArchivePointee for T

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.

impl<T> ArchiveUnsized for T
where T: Archive,

type Archived = <T as Archive>::Archived

The archived counterpart of this type. Unlike Archive, it may be unsized. Read more

fn archived_metadata( &self, ) -> <<T as ArchiveUnsized>::Archived as ArchivePointee>::ArchivedMetadata

Creates the archived version of the metadata for this value.

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of [From]<T> for U chooses to do.

impl<T> LayoutRaw for T

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>

Returns the layout of the type.

impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
where T: SharedNiching<N1, N2>, N1: Niching<T>, N2: Niching<T>,

unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool

Returns whether the given value has been niched. Read more

fn resolve_niched(out: Place<NichedOption<T, N1>>)

Writes data to out indicating that a T is niched.

impl<T> Pointee for T

type Metadata = ()

The metadata type for pointers and references to this type.

impl<T, S> SerializeUnsized<S> for T
where T: Serialize<S>, S: Fallible + Writer + ?Sized,

fn serialize_unsized( &self, serializer: &mut S, ) -> Result<usize, <S as Fallible>::Error>

Writes the object and returns the position of the archived type.

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> ArchiveCodec for T
where T: Archive + for<'a, 'b> Serialize<Strategy<Serializer<Buffer<'b>, ArenaHandle<'a>, ()>, Error>> + for<'a> Serialize<Strategy<Serializer<SizeOfWriter, ArenaHandle<'a>, ()>, Error>>, <T as Archive>::Archived: Portable,

impl<M> ArchiveEvent for M
where M: ArchiveCodec, <M as Archive>::Archived: for<'a> CheckBytes<Strategy<Validator<ArchiveValidator<'a>, ()>, Error>>,

impl<T> SubscriptionError for T
where T: ArchiveCodec, <Result<(), T> as Archive>::Archived: Deserialize<Result<(), T>, Strategy<(), Error>> + for<'a> CheckBytes<Strategy<Validator<ArchiveValidator<'a>, ()>, Error>>,