跳到主要內容
Tauri

AppImage

AppImage 是一種發佈格式,不依賴系統安裝的套件,而是將應用程式所需的所有依賴項和檔案捆綁在一起。因此,輸出檔案較大,但更易於發佈,因為它在許多 Linux 發行版上都受支援,並且無需安裝即可執行。使用者只需使檔案可執行 ( chmod a+x MyProject.AppImage ),然後即可執行它 ( ./MyProject.AppImage )。

AppImage 很方便,如果您無法製作針對發行版套件管理器的套件,它可以簡化發佈流程。儘管如此,您應該謹慎使用它,因為檔案大小會從 2-6 MB 範圍增長到 70+ MB。

透過 GStreamer 的多媒體支援

如果您的應用程式播放音訊/視訊,您需要啟用 tauri.conf.json > bundle > linux > appimage > bundleMediaFramework 。這將增加 AppImage 捆綁包的大小,以包含媒體播放所需的其他 gstreamer 檔案。此標誌目前僅在 Ubuntu 建置系統上完全支援。請確保您的建置系統具有您的應用程式在運行時可能需要的所有外掛程式。

自訂檔案

若要在 AppImage 中包含您不想透過 Tauri 的 resources 功能 包含的自訂檔案,您可以在 tauri.conf.json > bundle > linux > appimage > files 中提供檔案或資料夾的清單。組態物件會將 AppImage 中的路徑對應到您檔案系統上的檔案路徑,相對於 tauri.conf.json 檔案。以下是一個範例組態

tauri.conf.json
{
"bundle": {
"linux": {
"appimage": {
"files": {
"/usr/share/README.md": "../README.md", // copies the ../README.md file to <appimage>/usr/share/README.md
"/usr/assets": "../assets/" // copies the entire ../assets directory to <appimage>/usr/assets
}
}
}
}
}

適用於 ARM 架構裝置的 AppImage

linuxdeploy 是 Tauri 使用的 AppImage 工具,目前 不支援交叉編譯 ARM AppImage。這表示 ARM AppImage 只能在 ARM 裝置或模擬器上建置。

請查看我們的 GitHub Actions 指南,取得利用 QEMU 建置應用程式的範例工作流程。請注意,這非常緩慢,僅建議在 Build Minutes 免費的公開儲存庫中使用。在私有儲存庫中,GitHub 的 ARM runners 應該更具成本效益且更易於設定。


© 2025 Tauri 貢獻者。CC-BY / MIT