msixbundle-rs

  • 语言Rust
  • 默认分支main
  • 大小237 KB
  • 更新3 天前
在 GitHub 打开

README

msixbundle-rs

A Rust library and CLI tool for building and signing Windows MSIX packages and MSIX bundles using the Windows SDK toolchain.

Overview

msixbundle-rs provides a programmatic Rust interface to automate the creation, signing, and validation of multi-architecture MSIX packages and bundles. It’s designed for build pipelines that need to package Windows applications for distribution via the Microsoft Store or enterprise deployment.

Packages

Package Description Registry
msixbundle Core library for MSIX packaging operations crates.io
msixbundle-cli Command-line tool for packaging workflows crates.io
@choochmeque/msixbundle-cli-win32 Prebuilt Windows binaries (x64 + arm64) as an npm sidecar for @choochmeque/tauri-windows-bundle npm

Features

  • Multi-architecture support: Build separate MSIX packages for x64 and ARM64 architectures
  • Automatic bundle creation: Combine per-architecture packages into a single .msixbundle
  • SDK auto-discovery: Automatically locate Windows SDK tools (MakeAppx.exe, makepri.exe, signtool.exe, appcert.exe) via registry
  • Resource indexing: Optionally generate resources.pri with makepri.exe for qualified assets
  • Code signing: Sign packages and bundles with PFX certificates
  • Timestamping: Support for both RFC3161 and Authenticode timestamp protocols
  • Validation: Validate packages using Windows App Certification Kit (WACK) and verify signatures
  • Manifest parsing: Extract version and display name from AppxManifest.xml

Requirements

  • Windows OS: This tool requires Windows and the Windows SDK
  • Windows SDK 10: MakeAppx.exe, MakePri.exe and signtool.exe must be installed
  • Windows App Certification Kit (WACK): Required for validation (appcert.exe)
    • Installed automatically with the Windows SDK
  • Rust: 1.85+ (2024 edition)

Quick Start

CLI Tool

cargo install msixbundle-cli

msixbundle-cli \
  --out-dir ./output \
  --dir-x64 ./build/x64/AppxContent \
  --dir-arm64 ./build/arm64/AppxContent \
  --pfx ./signing.pfx \
  --pfx-password "secret"

Library

[dependencies]
msixbundle = "1.1"

use msixbundle::*;

let tools = locate_sdk_tools()?;
let manifest = read_manifest_info(x64_dir)?;
let msix = pack_arch(&tools, x64_dir, out_dir, &manifest, "x64")?;

See the individual crate READMEs for detailed documentation.

Project Structure

msixbundle-rs/
├── msixbundle/          # Core library
│   ├── src/
│   │   └── lib.rs
│   └── Cargo.toml
├── msixbundle-cli/      # Command-line tool
│   ├── src/
│   │   └── main.rs
│   └── Cargo.toml
└── Cargo.toml           # Workspace configuration

How It Works

  1. Manifest Parsing: Reads AppxManifest.xml from each architecture directory to extract version and identity information
  2. Resource Indexing (optional): Uses makepri.exe to generate resources.pri
  3. Package Creation: Uses MakeAppx.exe to create .msix files for each architecture
  4. Bundle Mapping: Generates a bundlemap.txt file listing all architecture packages
  5. Bundle Creation: Uses MakeAppx.exe to combine packages into a .msixbundle
  6. Signing: Uses signtool.exe to apply digital signatures with optional timestamping
  7. Validation: Optionally validates packages with WACK and verifies signature validity

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

MIT License - see the LICENSE file for details.

Resources

评论

暂无评论