Skip to content

WINDOWS_DEPLOYMENT.md

Latest commit

 

History

History
103 lines (79 loc) · 3.35 KB

WINDOWS_DEPLOYMENT.md

File metadata and controls

103 lines (79 loc) · 3.35 KB
Raw

Windows Deployment Guide

Architecture Support

Seyfr provides both 32-bit and 64-bit Windows executables:

  • seyfr-x64.exe - For 64-bit Windows systems (Windows 7+ x64)
  • seyfr-x86.exe - For 32-bit Windows systems (Windows 7+ x86)

Requirements

Seyfr desktop application on Windows requires two runtime components:

1. Visual C++ Runtime (Fixed ✅)

  • Issue: VCRUNTIME140.dll was not found
  • Solution: Build with --features windows-static to embed runtime
  • Status: Automatically handled in builds

2. Microsoft Edge WebView2 Runtime (Required ⚠️)

  • Issue: WebView2Loader.dll was not found
  • Solution: Install WebView2 Runtime on target machine
  • Status: Must be installed separately

Installation Options

Option 1: Automatic Installation (Recommended)

The GitHub Actions build includes the WebView2 bootstrapper. Run it before using Seyfr:

  1. Download the appropriate release bundle:
    • seyfr-windows-x64-bundle for 64-bit systems
    • seyfr-windows-x86-bundle for 32-bit systems
  2. Run MicrosoftEdgeWebview2Setup.exe (included in both bundles)
  3. Run the appropriate executable:
    • seyfr-x64.exe for 64-bit systems
    • seyfr-x86.exe for 32-bit systems

Option 2: Manual Installation

Download and install WebView2 Runtime from: https://developer.microsoft.com/en-us/microsoft-edge/webview2/

Option 3: Check if Already Installed

WebView2 is included with:

  • Microsoft Edge browser (most Windows 11 systems)
  • Microsoft 365 applications
  • Many modern Windows applications

Building for Windows

From Windows (Recommended):

# For 64-bit Windows
rustup target add x86_64-pc-windows-msvc
cd seyfr-ui
dx build --release --platform desktop --target x86_64-pc-windows-msvc --features windows-static

# For 32-bit Windows
rustup target add i686-pc-windows-msvc
cd seyfr-ui
dx build --release --platform desktop --target i686-pc-windows-msvc --features windows-static

Cross-compile from macOS/Linux:

# 64-bit (works reliably)
rustup target add x86_64-pc-windows-gnu
cd seyfr-ui
dx build --release --platform desktop --target x86_64-pc-windows-gnu --features windows-static

# 32-bit (may have linker issues on macOS)
rustup target add i686-pc-windows-gnu
cd seyfr-ui
dx build --release --platform desktop --target i686-pc-windows-gnu --features windows-static

Troubleshooting

"VCRUNTIME140.dll was not found"

  • Ensure you're building with --features windows-static
  • This embeds the Visual C++ runtime in the executable

"WebView2Loader.dll was not found"

  • Install Microsoft Edge WebView2 Runtime
  • Use the bootstrapper included in release bundles
  • Or download from Microsoft's official site

Application won't start

  1. Check Windows version (Windows 10 1803+ required)
  2. Install WebView2 Runtime
  3. Run as administrator if needed
  4. Check Windows Defender/antivirus exclusions

Distribution

When distributing Seyfr:

  1. Include the WebView2 bootstrapper (MicrosoftEdgeWebview2Setup.exe)
  2. Instruct users to run the bootstrapper first
  3. Or create an installer that includes WebView2 installation

Technical Details

  • Static Runtime: VCRUNTIME140.dll is embedded using static_vcruntime crate
  • WebView2: Required for UI rendering in Dioxus desktop applications
  • Architecture: Supports x86_64 Windows systems
  • Minimum OS: Windows 10 version 1803 or later