mx-packageinstaller

A comprehensive package management GUI for MX Linux with support for multiple package sources including APT repositories, Flatpak applications, and curated popular applications.

Project Structure

mx-packageinstaller/
├── src/                 # Source code (*.cpp, *.h, *.ui files)
├── Testing/            # Unit tests and test configuration
├── translations/       # Translation files (*.ts)
├── scripts/           # Helper scripts and policies
├── help/              # Documentation and help files
├── icons/             # Application icons and resources
├── debian/            # Debian packaging files
└── CMakeLists.txt     # Build configuration

Building

This is a Qt6 application using CMake build system.

Build Commands

# Basic build
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

# Build with tests
cmake -B build -DBUILD_TESTS=ON -DCMAKE_BUILD_TYPE=Release
cmake --build build

# Run tests
cd build && ctest --verbose
# or run individual tests
cd build && ./test_versionnumber && ./test_aptcache

# Continuous testing (requires inotify-tools)
cd build && make watch_tests

# Clean build
cmake --build build --target clean

# Using the build script
./build.sh                    # Release build
./build.sh --debug            # Debug build
./build.sh --tests            # Build with tests
./build.sh --clang            # Use Clang compiler
./build.sh --clean            # Clean before build
./build.sh --debian           # Build Debian package

Testing

The project includes comprehensive unit tests for critical components:

• test_versionnumber: Tests Debian version comparison logic including epochs, revisions, tildes, and real-world scenarios (14 tests)
• test_aptcache: Tests APT cache parsing, architecture filtering, version selection, and file processing (11 tests)

All tests use QtTest framework and can be run individually or through CMake's test runner.

Features

• Multiple Package Sources: APT repositories, Flatpak, curated popular applications
• Architecture Filtering: Automatic detection and filtering for current system architecture
• Version Management: Sophisticated Debian version comparison and selection
• Privilege Escalation: Secure administrative operations via pkexec/gksu
• Comprehensive Testing: Unit tests for critical package management logic
• Internationalization: Full translation support for multiple languages

Logging

Application logs are written to /tmp/mxpi.log during runtime and copied to /var/log/mxpi.log at exit.

Requirements

• Qt6 (Core, Gui, Widgets, Network, Xml, LinguistTools)
• C++20 compiler (GCC 12+ or Clang)
• CMake 3.16+
• Ninja (recommended for faster builds)