Asosiasi File

Platform Relevan: Windows macOS

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

Ringkasan

Dukungan asosiasi file di Wails v3 saat ini tersedia untuk:

• Windows (paket installer NSIS)
• macOS (application bundle)

Konfigurasi

Asosiasi file dikonfigurasi di 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 bawah bagian fileAssociations
3. Jalankan wails3 update build-assets untuk memperbarui build assets
4. Atur field FileAssociations di opsi aplikasi
5. Package aplikasi Anda menggunakan wails3 package

Berikut contoh konfigurasi:

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 Event Buka File

Untuk menangani event buka file di aplikasi Anda, Anda dapat mendengarkan event 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"}, // Tentukan ekstensi yang didukung
    })

    // Dengarkan file yang digunakan untuk membuka aplikasi
    app.Event.OnApplicationEvent(events.Common.ApplicationOpenedWithFile, func(event *application.ApplicationEvent) {
        associatedFile := event.Context().Filename()
        app.Dialog.Info().SetMessage("Application opened with file: " + associatedFile).Show()
    })

    // Buat window Anda dan jalankan aplikasi...
}

Tutorial Langkah demi Langkah

Mari kita telusuri penyiapan asosiasi file untuk editor teks sederhana:

# 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"}, // Tentukan ekstensi yang didukung
})

wails3 package