Dateizuordnungen

Relevante Plattformen: Windows macOS

Mit Dateizuordnungen kann Ihre Anwendung bestimmte Dateitypen verarbeiten, wenn Benutzer sie öffnen. Dies ist besonders für Texteditoren, Bildbetrachter und andere Anwendungen nützlich, die mit bestimmten Dateiformaten arbeiten. In dieser Anleitung erfahren Sie, wie Sie Dateizuordnungen in Ihrer Wails-v3-Anwendung implementieren.

Überblick

Dateizuordnungen werden in Wails v3 derzeit auf folgenden Plattformen unterstützt:

• Windows (NSIS-Installationspakete)
• macOS (Anwendungspakete)

Konfiguration

Dateizuordnungen werden in der Datei config.yml im Verzeichnis build Ihres Projekts konfiguriert.

Grundkonfiguration

So richten Sie Dateizuordnungen ein:

1. Öffnen Sie build/config.yml
2. Fügen Sie Ihre Dateizuordnungen im Abschnitt fileAssociations hinzu
3. Führen Sie wails3 update build-assets aus, um die Build-Assets zu aktualisieren
4. Legen Sie in den Anwendungsoptionen das Feld FileAssociations fest
5. Paketieren Sie Ihre Anwendung mit wails3 package

Hier sehen Sie eine Beispielkonfiguration:

fileAssociations:
  - ext: myapp
    name: MyApp Document
    description: MyApp Document File
    iconName: myappFileIcon
    role: Editor
  - ext: custom
    name: Custom Format
    description: Custom File Format
    iconName: customFileIcon
    role: Editor

Konfigurationseigenschaften

Auf Dateiöffnungsereignisse reagieren

Um Dateiöffnungsereignisse in Ihrer Anwendung zu verarbeiten, können Sie auf das Ereignis events.Common.ApplicationOpenedWithFile reagieren:

package main

import (
    "github.com/wailsapp/wails/v3/pkg/application"
    "github.com/wailsapp/wails/v3/pkg/events"
)

func main() {
    app := application.New(application.Options{
        Name: "MyApp",
        FileAssociations: []string{".txt", ".md"}, // Specify supported extensions
    })

    // Listen for files being used to open the application
    app.Event.OnApplicationEvent(events.Common.ApplicationOpenedWithFile, func(event *application.ApplicationEvent) {
        associatedFile := event.Context().Filename()
        app.Dialog.Info().SetMessage("Application opened with file: " + associatedFile).Show()
    })

    // Create your window and run the app...
}

Schritt-für-Schritt-Anleitung

Richten Sie nun Schritt für Schritt Dateizuordnungen für einen einfachen Texteditor ein:

# build/config.yml
fileAssociations:
  - ext: txt
    name: Text Document
    description: Plain Text Document
    iconName: textFileIcon
    role: Editor

wails3 update build-assets

app := application.New(application.Options{
  Name: "MyApp",
  FileAssociations: []string{".txt", ".md"}, // Specify supported extensions
})

wails3 package