Asosiasi File

Platform yang Relevan: Windows macOS

Asosiasi file memungkinkan aplikasi Anda menangani jenis file tertentu saat pengguna membukanya. Fitur ini sangat berguna untuk editor teks, penampil gambar, atau aplikasi apa pun yang menangani format file tertentu. Panduan ini menjelaskan cara menerapkan asosiasi file dalam aplikasi Wails v3 Anda.

Ikhtisar

Dukungan asosiasi file di Wails v3 saat ini tersedia untuk:

• Windows (paket penginstal NSIS)
• macOS (bundel aplikasi)

Konfigurasi

Asosiasi file dikonfigurasikan dalam file config.yml yang berada di direktori build proyek Anda.

Konfigurasi Dasar

Untuk menyiapkan asosiasi file:

1. Buka build/config.yml
2. Tambahkan asosiasi file Anda di bagian fileAssociations
3. Jalankan wails3 update build-assets untuk memperbarui aset build
4. Atur bidang FileAssociations dalam opsi aplikasi
5. Kemas aplikasi Anda menggunakan wails3 package

Berikut contoh konfigurasinya:

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

Properti Konfigurasi

Mendengarkan Peristiwa Pembukaan File

Untuk menangani peristiwa pembukaan file dalam aplikasi, Anda dapat mendengarkan peristiwa events.Common.ApplicationOpenedWithFile:

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...
}

Tutorial Langkah demi Langkah

Mari siapkan asosiasi file untuk editor teks sederhana langkah demi langkah:

# 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