搜尋套件、儲存庫與 APP 分類

ducafecatFlutter 生態導航
套件詳情v3.18.0

msix

一個命令列工具，可從您的 Flutter Windows 編譯檔案建立 Msix 安裝程式。

Windows
pub.dev API 文件 原始碼
近 30 天下載
27.6萬
喜歡數
990
Pub 分數
130

安裝套件

flutter pub add msix

套件介紹

根據套件公開資料產生的選型評估，僅供參考。

msix 套件是一個命令列工具，專門設計用於從為 Windows 構建的 Flutter 應用程式產生 MSIX 安裝程式。它透過將現有的 Windows 建構輸出轉換為可分發的 MSIX 套件，簡化了打包流程，而 MSIX 套件是 Windows 應用程式部署的現代標準。此工具與 Flutter 的建構工作流程無縫整合，讓開發者能透過 Microsoft Store 發布其桌面應用程式，或直接側載安裝。它支援自動簽署和設定，簡化了 Windows 平台的發行管理。

適用情境

  • 為Windows桌面應用建立MSIX安裝程式
  • 將 Flutter 應用程式發佈至 Microsoft Store
  • 在CI/CD流水線中自動化Windows應用程式打包
  • 透過側載分發Flutter應用
  • 為企業部署生成簽名的 MSIX 套件

主要特色

  • 將 Flutter Windows 編譯檔轉換為 MSIX 格式
  • 支援自動簽名與清單產生
  • 與 Flutter 的建構系統整合
  • 啟用 Microsoft Store 發行
  • 透過 YAML 設定進行設定

適合對象

  • 面向 Windows 桌面的 Flutter 開發人員
  • 將應用程式部署到 Microsoft Store 的團隊
  • Windows 應用程式的工作流程
  • 企業軟體分發

使用建議

  • 需要 Windows 運作系統才能執行
  • 僅限 Windows 平台
  • 提交到 Microsoft Store 需要手動設定
  • 依賴正確的Flutter建構產物
  • 可能需要額外的憑證管理

原始 README

以下為關聯原始碼儲存庫的 README 原文快照，最新內容請造訪原始碼儲存庫。

MSIX

Flutter Favorite Badge

pub package MSIX toolkit package issues-closed issues-open Codemagic build status

MSIX is a Windows app packaging format from Microsoft that combines the best features of MSI, .appx, App-V, and ClickOnce to provide a modern and reliable packaging experience.

This package offers a command line tool for creating MSIX installers from your Flutter app, making it easy to publish your app to the Microsoft Store or host it on a website.

📋 Installation

In your pubspec.yaml, add the msix package as a new dev dependency with the following command:

flutter pub add --dev msix

📦 Creating an MSIX installer

To create a MSIX installer, run the following command:

dart run msix:create

⚙️ Configuring your installer

You will almost certainly want to customize various settings in the MSIX installer, such as the application title, the default icon, and which Windows capabilities your application needs. You can customize the generated MSIX installer by adding declarations to an msix_config: node in your pubspec.yaml file:

msix_config:
  display_name: Flutter App
  publisher_display_name: Company Name
  identity_name: company.suite.flutterapp
  msix_version: 1.0.0.0
  logo_path: C:\path\to\logo.png
  capabilities: internetClient, location, microphone, webcam

See Configurations Examples And Use Cases.

Available Configurations
MSIX configuration (click to expand)
YAML name Command-line argument Description (from Microsoft Package manifest schema reference) Example
display_name --display-name -d A friendly app name that can be displayed to users. Flutter App
publisher_display_name --publisher-display-name -u A friendly name for the publisher that can be displayed to users. Company Name
identity_name --identity-name -i Defines the unique identifier for the app. company.suite.flutterapp
msix_version --version The version number of the package, in a.b.c.d format. see how the msix version is determined. 1.0.0.0
logo_path --logo-path -l Path to an image file for use as the app icon (size recommended at least 400x400px). C:\images\logo.png
trim_logo --trim-logo <true/false> If false, don't trim the logo image, default is true. true
capabilities --capabilities -e List of the capabilities the app requires. internetClient,location,microphone,webcam
languages --languages Declares the language resources contained in the package. en-us, ja-jp
file_extension --file-extension -f File extensions that the app may be registered to open. .picture, .image
protocol_activation --protocol-activation Protocols activation that will activate the app. http,https
app_uri_handler_hosts --app-uri-handler-hosts Enable apps for websites using app URI handlers app. test.com, test2.info
execution_alias --execution-alias Execution alias command (cmd) that will activate the app. myapp
enable_at_startup --enable-at-startup App start at startup or user log-in. true
store --store Generate a MSIX file for publishing to the Microsoft Store. false
os_min_version --os-min-version Set minimum OS version, default is 10.0.17763.0 10.0.17763.0
Toast Notifications configuration
Startup Task configuration pass the app values (args) on startup or user log-in
Context Menu configuration Use your context menu dll with your app
Build configuration (click to expand)
YAML name Command-line argument Description Example
debug --debug or --release Create MSIX from the debug or release build files (\build\windows\runner\<Debug/Release>), release is the default. true
output_path --output-path -o The directory where the output MSIX file should be stored. C:\src\some\folder
output_name --output-name -n The filename that should be given to the created MSIX file. flutterApp_dev
architecture --architecture -h Describes the architecture of the code in the package, x64 or arm64, x64 is default. x64
build_windows --build-windows <true/false> If false, don't run the build command flutter build windows, default is true. true
windows_build_args --windows-build-args Any arguments for the flutter build windows command. --obfuscate --split-debug-info=C:\Users\me\folder
Sign configuration (click to expand)
YAML name Command-line argument Description Example
certificate_path --certificate-path -c Path to the certificate content to place in the store. C:\certs\signcert.pfx or C:\certs\signcert.crt
certificate_password --certificate-password -p Password for the certificate. 1234
publisher --publisher -b The Subject value in the certificate.
Required only if publish to the store, or if the Publisher will not found automatically by this package.		 CN=BF212345-5644-46DF-8668-014043C1B138 or CN=Contoso Software, O=Contoso Corporation, C=US
signtool_options --signtool-options Options to be provided to the signtool for app signing (see below.) /v /fd SHA256 /f C:/Users/me/Desktop/my.cer
sign_msix --sign-msix <true/false> If false, don't sign the msix file, default is true.
Note: when false, publisher is Required.		 true
install_certificate --install-certificate <true/false> If false, don't try to install the certificate, default is true. true

✒️ Signing options

Published MSIX installers should be signed with a certificate, to help ensure that app installs and updates come from trustworthy sources.

  • For development purposes, this package is configured by default to automatically sign your app with a self signed test certificate, which makes it easy to test your install prior to release.
  • If you publish your app to the Microsoft Store, the installation package will be signed automatically by the store.
  • If you need to use your own signing certificate, for example to release the app outside of the Microsoft Store, you can use the configuration fields certificate_path and certificate_password to configure a certificate of your choice.

You can also provide custom options to the signing tool with the --signtool-options command, as shown above. For more information on available options, see the signtool documentation. Note that using this option overrides the certificate_path and certificate_password fields.

Note: By default, the MSIX package will install the certificate on your machine. You can disable this by using the --install-certificate false option, or the YAML option install_certificate: false.

microsoft store icon Publishing to the Microsoft Store

To generate an MSIX file for publishing to the Microsoft Store, use the --store flag, or alternatively add store: true to the YAML configuration.

Note: For apps published to the Microsoft Store, the configuration values publisher_display_name, identity_name, msix_version and publisher must all be configured and should match the registered publisher and app name from the Microsoft Store dashboard, as per this screenshot.

🌐 Publishing outside the store

You can use the App Installer file to enable your users to install and update the app from local file share.

Note: installing from the web ms-appinstaller: is disabled for now.

To create a App Installer file, first set the publish_folder_path configuration, then run the following command:

dart run msix:publish
Available configurations for App Installer (click to expand)
App Installer configuration example:
msix_config:
  display_name: Flutter App
  app_installer: #<-- app installer configuration
    publish_folder_path: c:\path\to\myPublishFolder
    hours_between_update_checks: 0
    automatic_background_task: true
    update_blocks_activation: true
    show_prompt: true
    force_update_from_any_version: false
  msix_version: 1.0.3.0
YAML name Command-line argument Description (from Microsoft schema reference) Example
publish_folder_path --publish-folder-path A path to publish folder, where the msix versions and the .appinstaller file will be saved. c:\path\to\myPublishFolder
hours_between_update_checks --hours-between-update-checks Defines the minimal time gap between update checks, when the user open the app. default is 0 (will check for update every time the app opened) 2
automatic_background_task --automatic-background-task Checks for updates in the background every 8 hours independently of whether the user launched the app. false
update_blocks_activation --update-blocks-activation Defines the experience when an app update is checked for. false
show_prompt --show-prompt Defines if a window is displayed when updates are being installed, and when updates are being checked for. false
force_update_from_any_version --force-update-from-any-version Allows the app to update from version x to version x++ or to downgrade from version x to version x--. false

⚠️ Unsupported Features

We added the most common features of Msix in this package, however, if you need to add or edit a feature that is not supported yet, you can do this manually.

First, create the unpackaged msix files with the following command

dart run msix:build

Then edit the files that were created in the build folder.

After that create a msix installer file from those files with the following command

dart run msix:pack

Tags: msi windows win10 win11 windows10 windows11 windows store windows installer windows packaging appx AppxManifest SignTool MakeAppx

所屬分類

應用打包與發佈桌面端（Windows、Linux 與 macOS）

依賴

依賴清單 9 項

原始碼儲存庫

使用此套件的專案

所在榜單

Flutter Favorites#72