Skip to content

EXLOUD/AppX-Package-Installer

Repository files navigation

πŸ‘€ Repository Views

count

⭐ If this tool helped you, please consider giving it a star! ⭐


AppX Package Installer

AppX Package Installer

Modern MSIX/AppX Package Installer for Windows 10/11

Issues License

What is it? | Features | How to use | Formats | Building


🎯 What is AppX Package Installer?

AppX Package Installer is a modern, user-friendly Windows application designed to simplify the installation of AppX and MSIX packages. With its intuitive drag-and-drop interface, automatic dependency management, and sleek design, it makes package installation effortless for both developers and end users.

Unlike complex command-line tools, this application provides a visual interface that automatically handles package dependencies, architecture compatibility, and license management.

✨ Features

Click to expand features

🎨 User Experience

  • Intuitive Drag & Drop Interface - Simply drag your AppX files into the application
  • Real-time Installation Progress - Live status updates with visual feedback
  • Modern UI Design - Clean, gradient-based interface with smooth animations
  • Three Visual States - Empty, Loading, and Success states with indicators

πŸ”§ Technical Capabilities

  • Multiple Format Support - .appx, .appxbundle, .msix, .msixbundle
  • Smart Package Detection - Automatically identifies dependencies, main apps, and bundles
  • Architecture Compatibility - System architecture detection and filtering
  • Automatic License Handling - Searches and applies license files automatically
  • Intelligent Installation Order - Dependencies β†’ Apps β†’ Bundles

πŸ›‘οΈ System Integration

  • PowerShell Integration - Uses native Windows PowerShell commands
  • Administrator Support - System-wide installation with elevated privileges
  • Error Handling - Graceful error management with user-friendly messages
  • Cancellation Support - Ability to cancel long-running installations

πŸš€ How to use?

There are several ways to use AppX Package Installer:

4.1 Download Release

Click to expand

The easiest way to get started is to download the pre-built executable.

4.1.1 Download

Download the latest release from GitHub Releases.

4.1.2 Installation

  1. Extract the downloaded archive
  2. Run the executable as Administrator (recommended)
  3. Start installing your AppX packages!

4.1.3 Usage

Usage Demo

  1. Launch the application (preferably as Administrator)
  2. Drag and drop your AppX package files into the main window
  3. Wait for automatic installation - the app handles everything
  4. Receive success notification when installation is complete

4.2 Build from Source

Click to expand

If you prefer to build the application yourself, follow these steps.

4.2.1 Prerequisites

  1. Visual Studio 2019 or later - Required for building the project
  2. .NET Framework 4.7.2 SDK - Must be installed
  3. Windows 10 SDK - For Windows API compatibility

4.2.2 Build Steps

# Clone the repository
git clone https://github.com/EXLOUD/AppX-Package-Installer.git
cd AppX-Package-Installer

# Open in Visual Studio
start AppX-Package-Installer.sln

# Or build from command line
msbuild AppX-Package-Installer.sln /p:Configuration=Release

4.2.3 Run

  1. Build the project in Visual Studio
  2. Navigate to bin/Release/ directory
  3. Run the executable as Administrator (recommended)

πŸ“¦ Supported Formats

The installer supports multiple package formats with automatic detection:

4.3 Package Types

Format Description Auto-Detection Example
.appx Standard Application Package βœ… APP/DEP MyApp.appx
.appxbundle Application Bundle Package βœ… BUNDLE MyApp.appxbundle
.msix Modern Application Package βœ… APP/DEP MyApp.msix
.msixbundle Modern Bundle Package βœ… BUNDLE MyApp.msixbundle

4.4 Installation Priority

The installer automatically handles package dependencies by installing in the correct order:

  1. Dependencies (VCLibs, NET, Xaml, WinJS) - Installed first
  2. Main Applications - Installed second
  3. Bundles - Installed last

4.5 License Handling

The application can automatically detect and apply license files:

  • Place .xml license files in the same directory as your packages
  • The installer will automatically find and apply them during installation
  • No manual license management required

πŸ’» System Requirements

Component Requirement
Operating System Windows 10/11
Framework .NET Framework 4.7.2+
PowerShell Windows PowerShell (built-in)
Privileges Administrator rights (recommended)
Architecture x86, x64, ARM64

πŸ”¨ Building

Click to expand building instructions

Prerequisites

Make sure you have the following installed:

  • Visual Studio 2019 or later
  • .NET Framework 4.7.2 SDK
  • Windows 10 SDK

Project Structure

AppX-Package-Installer/
β”œβ”€β”€ src/                    # Source code
β”‚   β”œβ”€β”€ MainWindow.xaml     # Main UI
β”‚   β”œβ”€β”€ MainWindow.xaml.cs  # UI logic
β”‚   └── ...                 # Other source files
β”œβ”€β”€ assets/                 # Images and resources
β”œβ”€β”€ bin/                    # Build output
β”œβ”€β”€ docs/                   # Documentation
β”œβ”€β”€ LICENSE                 # MIT License
└── README.md              # This file

Build Configuration

The project is configured for:

  • Target Framework: .NET Framework 4.7.2
  • Platform Targets: x86, x64
  • Output Type: Windows Application

πŸ”§ Troubleshooting

Why isn't my installation working?

7.1 Common Issues

Installation Fails

Possible causes:

  • Not running as Administrator
  • Package incompatible with Windows version
  • Corrupted package file
  • Missing dependencies

Solutions:

  • Run the application as Administrator
  • Check package compatibility
  • Re-download the package
  • Install required dependencies manually
Drag & Drop Not Working

Possible causes:

  • Incorrect file extensions
  • Security restrictions
  • Application not running as Administrator

Solutions:

  • Verify files have correct extensions (.appx, .msix, etc.)
  • Run as Administrator
  • Check Windows security settings
PowerShell Errors

Possible causes:

  • PowerShell execution policy restrictions
  • Outdated PowerShell version
  • Missing Windows features

Solutions:

  • Check PowerShell execution policy
  • Update PowerShell via Windows Update
  • Enable PowerShell in Windows Features

7.2 Getting Help

If you encounter issues:

  1. Check the Issues page
  2. Search for existing solutions
  3. Create a new issue with detailed information including:
    • Windows version
    • Package types you're trying to install
    • Error messages
    • Steps to reproduce

🀝 Contributing

8.1 Suggestions

If you encounter problems, you can report them on the Issues page. Many enthusiastic developers and GitHub users will help you.

This project welcomes contributions and suggestions. You can make suggestions in Issues, or submit a pull request πŸ˜„

8.2 Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

The code is available under the MIT license.

πŸ‘¨β€πŸ’» Author

EXLOUD

GitHub

Made with ❀️ for the Windows development community


⭐ If you find this project helpful, please consider giving it a star! ⭐