Enum AndroidError 

pub enum AndroidError {
    Assets(AssetError),
    AssetPipeline(AssetPipelineError),
    InvalidRequest(String),
    InvalidExternalToolPath {
        reason: &'static str,
    },
    InvalidConfig(String),
    ToolMissing {
        tool: String,
        searched: Vec<Utf8PathBuf>,
        fix: String,
    },
    PlatformMissing {
        requested: String,
        installed: Vec<u32>,
        fix: String,
    },
    BuildToolsMissing {
        searched: Vec<Utf8PathBuf>,
        fix: String,
    },
    NdkLinkerMissing {
        target: String,
        searched: Vec<Utf8PathBuf>,
        fix: String,
    },
    NativeLibraryMissing {
        target: String,
        searched: Vec<Utf8PathBuf>,
    },
    MissingDex {
        searched: Vec<Utf8PathBuf>,
    },
    MissingDexClass {
        class_name: String,
        searched: Vec<Utf8PathBuf>,
    },
    CargoOutput(String),
    CommandSpawn {
        stage: String,
        program: Utf8PathBuf,
        source: Error,
    },
    CommandTimedOut {
        stage: String,
        program: Utf8PathBuf,
        log: Option<Utf8PathBuf>,
    },
    ProcessOutputTooLarge {
        stage: String,
        program: Utf8PathBuf,
        stream: String,
        limit_bytes: usize,
        log: Option<Utf8PathBuf>,
    },
    CommandInterrupted {
        stage: String,
        program: Utf8PathBuf,
    },
    CommandFailed {
        stage: String,
        program: Utf8PathBuf,
        status: String,
        summary: Box<String>,
        log: Option<Utf8PathBuf>,
    },
    Io {
        operation: &'static str,
        path: Utf8PathBuf,
        source: Error,
    },
    Zip {
        path: Utf8PathBuf,
        message: String,
    },
    InvalidArtifact {
        path: Utf8PathBuf,
        reason: String,
    },
    NonUtf8Path(PathBuf),
}

Failure while discovering, building, signing, or validating an Android artifact.

Variants

Assets(AssetError)

Project icon or splash asset validation failed.

AssetPipeline(AssetPipelineError)

Deterministic platform asset generation or cache validation failed.

InvalidRequest(String)

A request value cannot safely be used by the build pipeline.

InvalidExternalToolPath

A filesystem path cannot safely cross an external tool process boundary.

Fields

reason: &'static str

Secret-free reason for rejecting the path.

InvalidConfig(String)

ferry.toml failed semantic validation.

ToolMissing

A required tool or SDK component was not found.

Fields

tool: String

Human-readable tool name.

searched: Vec<Utf8PathBuf>

Paths inspected during discovery.

fix: String

Concrete remediation.

PlatformMissing

No suitable Android platform is installed.

Fields

requested: String

Requested platform selector.

installed: Vec<u32>

Installed API levels.

fix: String

Concrete remediation.

BuildToolsMissing

No complete Android SDK Build Tools installation is available.

Fields

searched: Vec<Utf8PathBuf>

Build Tools directories inspected.

fix: String

Concrete remediation.

NdkLinkerMissing

The selected NDK has no linker for an ABI.

Fields

target: String

Rust target triple.

searched: Vec<Utf8PathBuf>

Candidate linker paths.

fix: String

Concrete remediation.

NativeLibraryMissing

Cargo completed without reporting a matching native library.

Fields

target: String

Rust target triple.

searched: Vec<Utf8PathBuf>

Artifact paths reported by Cargo.

MissingDex

A build requires JVM bytecode but no dependency or bridge DEX was emitted.

Fields

searched: Vec<Utf8PathBuf>

Build-script output directories searched recursively.

MissingDexClass

A manifest component has no matching class in the merged DEX.

Fields

class_name: String

Fully qualified JVM class name required by generated manifest metadata.

searched: Vec<Utf8PathBuf>

Merged DEX files inspected.

CargoOutput(String)

Cargo emitted malformed or unusable JSON output.

CommandSpawn

An external command could not be started.

Fields

stage: String

Build stage.

program: Utf8PathBuf

Executable path.

source: Error

Operating-system error.

CommandTimedOut

An external command exceeded its deadline.

Fields

stage: String

Build stage.

program: Utf8PathBuf

Executable path.

log: Option<Utf8PathBuf>

Diagnostic log, when requested.

ProcessOutputTooLarge

An external command exceeded the per-stream output memory limit.

Fields

stage: String

Build stage.

program: Utf8PathBuf

Executable path.

stream: String

Stream that crossed the limit.

limit_bytes: usize

Maximum retained bytes for each stream.

log: Option<Utf8PathBuf>

Diagnostic log containing only the retained prefixes.

CommandInterrupted

Ctrl+C interrupted an external build tool.

Fields

stage: String

Build stage.

program: Utf8PathBuf

Executable path.

CommandFailed

An external tool returned a non-zero status.

Fields

stage: String

Build stage.

program: Utf8PathBuf

Executable path.

status: String

Process status code or signal description.

summary: Box<String>

Short stderr/stdout excerpt.

log: Option<Utf8PathBuf>

Diagnostic log, when requested.

Io

A filesystem operation failed.

Fields

operation: &'static str

Operation being attempted.

path: Utf8PathBuf

Affected path.

source: Error

Operating-system error.

Zip

ZIP parsing or writing failed.

Fields

path: Utf8PathBuf

APK path.

message: String

Archive error without an unhelpful generic wrapper.

InvalidArtifact

Independent artifact validation rejected the APK.

Fields

path: Utf8PathBuf

APK path.

reason: String

Exact failed invariant.

NonUtf8Path(PathBuf)

A platform path could not be represented by the UTF-8 API.

Trait Implementations

impl Debug for AndroidError

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

Formats the value using the given formatter.

impl Display for AndroidError

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

Formats the value using the given formatter.

impl Error for AndroidError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<AssetError> for AndroidError

fn from(source: AssetError) -> Self

Converts to this type from the input type.

impl From<AssetPipelineError> for AndroidError

fn from(source: AssetPipelineError) -> Self

Converts to this type from the input type.