Struct FileAssociation 

pub struct FileAssociation {
    pub ext: Vec<AssociationExt>,
    pub content_types: Option<Vec<String>>,
    pub name: Option<String>,
    pub description: Option<String>,
    pub role: BundleTypeRole,
    pub mime_type: Option<String>,
    pub rank: HandlerRank,
    pub exported_type: Option<ExportedFileAssociation>,
    pub android_intent_action_filters: Option<Vec<AndroidIntentAction>>,
}

File association

Fields

ext: Vec<AssociationExt>

File extensions to associate with this app. e.g. ‘png’

content_types: Option<Vec<String>>

Declare support to a file with the given content type. Maps to LSItemContentTypes on macOS.

This allows supporting any file format declared by another application that conforms to this type. Declaration of new types can be done with Self::exported_type and linking to certain content types are done via ExportedFileAssociation::conforms_to.

name: Option<String>

The name. Maps to CFBundleTypeName on macOS. Default to ext[0]

description: Option<String>

The association description. Windows-only. It is displayed on the Type column on Windows Explorer.

role: BundleTypeRole

The app’s role with respect to the type. Maps to CFBundleTypeRole on macOS.

mime_type: Option<String>

The mime-type of the association, e.g. 'image/png' or 'text/plain'.

• Linux: written as MimeType= in the .desktop file.
• macOS / iOS: added as public.mime-type in the UTTypeTagSpecification dictionary of the UTExportedTypeDeclarations entry in Info.plist.
• Android: used as android:mimeType in the <data> element of an <intent-filter> in AndroidManifest.xml.

rank: HandlerRank

The ranking of this app among apps that declare themselves as editors or viewers of the given file type. Maps to LSHandlerRank on macOS.

exported_type: Option<ExportedFileAssociation>

The exported type definition. Maps to a UTExportedTypeDeclarations entry on macOS.

You should define this if the associated file is a custom file type defined by your application.

android_intent_action_filters: Option<Vec<AndroidIntentAction>>

Intent action filters for this file association.

By default all filters are used.

Implementations

impl FileAssociation

pub fn infer_content_types(&self) -> HashSet<String>

Infers UTIs (Uniform Type Identifiers) from file extensions and mime types. This is useful for macOS and iOS to automatically populate LSItemContentTypes in the Info.plist for share sheet and file association support.

Returns a vector of UTIs that should be included in LSItemContentTypes. Explicitly provided content types are included first, followed by inferred types.

Trait Implementations

impl Clone for FileAssociation

fn clone(&self) -> FileAssociation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileAssociation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileAssociation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for FileAssociation

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

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

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 Serialize for FileAssociation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for FileAssociation

impl StructuralPartialEq for FileAssociation