Updater. New Flow

framework/cmake/MuseSetupConfiguration.cmake

@@ -59,10 +59,6 @@ if (NOT MUSE_MODULE_MULTIWINDOWS)
     set(MUSE_MODULE_MULTIWINDOWS_QML OFF) # Stub does not have QML
 endif()
 
-if (NOT MUSE_MODULE_UPDATE)
-    set(MUSE_MODULE_UPDATE_QML OFF) # Stub does not have QML
-endif()
-
 if (NOT MUSE_MODULE_VST)
     set(MUSE_MODULE_VST_QML OFF) # Stub does not have QML
 endif()

framework/diagnostics/CMakeLists.txt

@@ -85,7 +85,7 @@ if (MUSE_MODULE_DIAGNOSTICS_CRASHPAD_CLIENT)
         message(FATAL_ERROR "Crashpad handler not found: ${MUSE_MODULE_DIAGNOSTICS_CRASHPAD_HANDLER_PATH}")
     endif()
     if (OS_IS_LIN OR OS_IS_WIN OR OS_IS_MAC)
-        install(PROGRAMS ${MUSE_MODULE_DIAGNOSTICS_CRASHPAD_HANDLER_PATH} DESTINATION ${INSTALL_BIN_DIR})
+        install(PROGRAMS ${MUSE_MODULE_DIAGNOSTICS_CRASHPAD_HANDLER_PATH} DESTINATION ${INSTALL_SUBDIR})
     endif()
 endif() # MUSE_MODULE_DIAGNOSTICS_CRASHPAD_CLIENT
 # ----------------

framework/stubs/update/CMakeLists.txt

@@ -29,4 +29,6 @@ target_sources(muse_update PRIVATE
     appupdatescenariostub.h
     appupdateservicestub.cpp
     appupdateservicestub.h
-)
+)
+
+add_subdirectory(qml/Muse/Update)

framework/stubs/update/appupdatescenariostub.cpp

@@ -32,24 +32,26 @@ void AppUpdateScenarioStub::checkForUpdate(bool)
 {
 }
 
-bool AppUpdateScenarioStub::checkInProgress() const
+bool AppUpdateScenarioStub::hasUpdate() const
+{
+    return false;
+}
+
+bool AppUpdateScenarioStub::hasReadyUpdate() const
 {
     return false;
 }
 
-muse::async::Notification AppUpdateScenarioStub::checkInProgressChanged() const
+muse::async::Notification AppUpdateScenarioStub::hasReadyUpdateChanged() const
 {
     return {};
 }
 
-bool AppUpdateScenarioStub::hasUpdate() const
+std::string AppUpdateScenarioStub::readyUpdateVersion() const
 {
-    return false;
+    return {};
 }
 
-muse::async::Promise<muse::Ret> AppUpdateScenarioStub::showUpdate()
+void AppUpdateScenarioStub::installReadyUpdate()
 {
-    return muse::async::Promise<muse::Ret>([](auto /*resolve*/, auto reject) {
-        return reject(int(muse::Ret::Code::UnknownError), "stub");
-    });
 }

framework/stubs/update/appupdatescenariostub.h

@@ -31,10 +31,12 @@ class AppUpdateScenarioStub : public IAppUpdateScenario
     bool needCheckForUpdate() const override;
     void checkForUpdate(bool manual) override;
 
-    bool checkInProgress() const override;
-    async::Notification checkInProgressChanged() const override;
-
     bool hasUpdate() const override;
-    muse::async::Promise<Ret> showUpdate() override;
+
+    bool hasReadyUpdate() const override;
+    async::Notification hasReadyUpdateChanged() const override;
+    std::string readyUpdateVersion() const override;
+
+    void installReadyUpdate() override;
 };
 }

framework/stubs/update/appupdateservicestub.cpp

@@ -42,3 +42,28 @@ RetVal<Progress> AppUpdateServiceStub::downloadRelease()
 {
     return RetVal<Progress>::make_ret(Ret::Code::NotSupported);
 }
+
+bool AppUpdateServiceStub::canAutoInstall() const
+{
+    return false;
+}
+
+RetVal<muse::io::path_t> AppUpdateServiceStub::prepareUpdate(const muse::io::path_t&)
+{
+    return RetVal<muse::io::path_t>(make_ret(Ret::Code::NotSupported));
+}
+
+Ret AppUpdateServiceStub::finalizeUpdate(const muse::io::path_t&)
+{
+    return make_ret(Ret::Code::NotSupported);
+}
+
+bool AppUpdateServiceStub::isReleaseDownloaded() const
+{
+    return false;
+}
+
+muse::io::path_t AppUpdateServiceStub::downloadedReleasePath() const
+{
+    return {};
+}

framework/stubs/update/appupdateservicestub.h

@@ -31,5 +31,12 @@ class AppUpdateServiceStub : public IAppUpdateService
     async::Promise<muse::RetVal<ReleaseInfo> > checkForUpdate() override;
     const RetVal<ReleaseInfo>& lastCheckResult() const override;
     RetVal<Progress> downloadRelease() override;
+
+    bool canAutoInstall() const override;
+    RetVal<muse::io::path_t> prepareUpdate(const muse::io::path_t& packagePath) override;
+    Ret finalizeUpdate(const muse::io::path_t& preparedPath) override;
+
+    bool isReleaseDownloaded() const override;
+    muse::io::path_t downloadedReleasePath() const override;
 };
 }

framework/stubs/update/qml/Muse/Update/CMakeLists.txt

@@ -0,0 +1,30 @@
+# SPDX-License-Identifier: GPL-3.0-only
+# MuseScore-Studio-CLA-applies
+#
+# MuseScore Studio
+# Music Composition & Notation
+#
+# Copyright (C) 2026 MuseScore Limited and others
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+muse_create_qml_module(muse_update_qml ALIAS muse::update_qml FOR muse_update STUB)
+
+qt_add_qml_module(muse_update_qml
+    URI Muse.Update
+    VERSION 1.0
+    QML_FILES
+        UpdateBanner.qml
+)
+
+fixup_qml_module_dependencies(muse_update_qml)

framework/stubs/update/qml/Muse/Update/UpdateBanner.qml

@@ -0,0 +1,29 @@
+/*
+ * SPDX-License-Identifier: GPL-3.0-only
+ * MuseScore-CLA-applies
+ *
+ * MuseScore Studio
+ * Music Composition & Notation
+ *
+ * Copyright (C) 2026 MuseScore Limited and others
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 3 as
+ * published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import QtQuick
+
+Item {
+    readonly property bool hasReadyUpdate: false
+    readonly property string updateVersion: ""
+
+    visible: false
+}

framework/stubs/update/updateconfigurationstub.cpp

@@ -52,11 +52,29 @@ muse::async::Notification UpdateConfigurationStub::needCheckForUpdateChanged() c
     return n;
 }
 
+bool UpdateConfigurationStub::autoInstallEnabled() const
+{
+    return false;
+}
+
+void UpdateConfigurationStub::setAutoInstallEnabled(bool)
+{
+}
+
 std::string UpdateConfigurationStub::skippedReleaseVersion() const
 {
     return "";
 }
 
+muse::io::path_t UpdateConfigurationStub::lastDownloadedPackagePath() const
+{
+    return "";
+}
+
+void UpdateConfigurationStub::setLastDownloadedPackagePath(const io::path_t&)
+{
+}
+
 void UpdateConfigurationStub::setSkippedReleaseVersion(const std::string&)
 {
 }
@@ -91,6 +109,11 @@ std::string UpdateConfigurationStub::privacyPolicyUrl() const
     return "";
 }
 
+muse::io::path_t UpdateConfigurationStub::downloadsPath() const
+{
+    return "";
+}
+
 muse::io::path_t UpdateConfigurationStub::updateDataPath() const
 {
     return "";

framework/stubs/update/updateconfigurationstub.h

@@ -37,9 +37,15 @@ class UpdateConfigurationStub : public IUpdateConfiguration
     void setNeedCheckForUpdate(bool needCheck) override;
     muse::async::Notification needCheckForUpdateChanged() const override;
 
+    bool autoInstallEnabled() const override;
+    void setAutoInstallEnabled(bool enabled) override;
+
     std::string skippedReleaseVersion() const override;
     void setSkippedReleaseVersion(const std::string& version) override;
 
+    io::path_t lastDownloadedPackagePath() const override;
+    void setLastDownloadedPackagePath(const io::path_t& path) override;
+
     bool checkForUpdateTestMode() const override;
 
     std::string checkForAppUpdateUrl() const override;
@@ -51,6 +57,7 @@ class UpdateConfigurationStub : public IUpdateConfiguration
     std::string privacyPolicyUrl() const override;
 
     io::path_t updateDataPath() const override;
+    io::path_t downloadsPath() const override;
     io::path_t updateRequestHistoryJsonPath() const override;
 };
 }

framework/update/CMakeLists.txt

@@ -29,6 +29,7 @@ target_sources(muse_update PRIVATE
     iupdaterequestparamsprovider.h
     iappupdatescenario.h
     iappupdateservice.h
+    iupdateinstaller.h
     updatecommands.h
 
     internal/updateconfiguration.cpp
@@ -45,12 +46,43 @@ target_sources(muse_update PRIVATE
     internal/appupdatescenario.h
     internal/appupdateservice.cpp
     internal/appupdateservice.h
+    internal/downloadfiledevice.cpp
+    internal/downloadfiledevice.h
 )
 
+if (OS_IS_MAC)
+    target_sources(muse_update PRIVATE
+        internal/platform/mac/macupdateinstaller.cpp
+        internal/platform/mac/macupdateinstaller.h
+    )
+elseif (OS_IS_WIN)
+    target_sources(muse_update PRIVATE
+        internal/platform/win/winupdateinstaller.cpp
+        internal/platform/win/winupdateinstaller.h
+        internal/platform/win/winupdateshared.h
+    )
+
+    target_link_libraries(muse_update PRIVATE taskschd ole32 oleaut32)
+elseif (OS_IS_LIN)
+    target_sources(muse_update PRIVATE
+        internal/platform/linux/linuxupdateinstaller.cpp
+        internal/platform/linux/linuxupdateinstaller.h
+    )
+else()
+    target_sources(muse_update PRIVATE
+        internal/platform/stub/updateinstallerstub.cpp
+        internal/platform/stub/updateinstallerstub.h
+    )
+endif()
+
 if (MUSE_QT_SUPPORT)
     target_link_libraries(muse_update PRIVATE Qt::Concurrent)
 endif()
 
+if (NOT CC_IS_EMCC)
+    add_subdirectory(helper)
+endif()
+
 if (MUSE_MODULE_UPDATE_TESTS)
     add_subdirectory(tests)
 endif()

framework/update/helper/CMakeLists.txt

@@ -0,0 +1,97 @@
+# SPDX-License-Identifier: GPL-3.0-only
+# MuseScore-Studio-CLA-applies
+#
+# MuseScore Studio
+# Music Composition & Notation
+#
+# Copyright (C) 2026 MuseScore Limited and others
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+set(UPDATE_HELPER_TARGET museupdater)
+
+set(UPDATE_HELPER_SRC
+    main.cpp
+    platform.h
+)
+
+if (OS_IS_WIN)
+    list(APPEND UPDATE_HELPER_SRC
+        platform_win.cpp
+        updatetask_win.cpp
+        updatetask_win.h
+        updateui_win.cpp
+        updateui_win.h
+        ../internal/platform/win/winupdateshared.h
+    )
+else()
+    list(APPEND UPDATE_HELPER_SRC
+        swap.cpp
+        swap.h
+    )
+
+    if (OS_IS_MAC)
+        list(APPEND UPDATE_HELPER_SRC platform_mac.cpp)
+    else()
+        list(APPEND UPDATE_HELPER_SRC platform_unix.cpp)
+    endif()
+endif()
+
+add_executable(${UPDATE_HELPER_TARGET} ${UPDATE_HELPER_SRC})
+
+set_target_properties(${UPDATE_HELPER_TARGET} PROPERTIES
+    CXX_STANDARD 17
+    CXX_STANDARD_REQUIRED ON
+)
+
+if (OS_IS_LIN)
+    # The helper is copied out of the AppImage and runs after it has been
+    # unmounted, so it cannot rely on the libraries bundled inside it. Those are
+    # generally newer than what the host provides, and linking against them
+    # dynamically would make the helper fail to start on exactly the systems
+    # where it is needed.
+    if (CC_IS_GCC OR CC_IS_CLANG)
+        target_link_options(${UPDATE_HELPER_TARGET} PRIVATE -static-libstdc++ -static-libgcc)
+    endif()
+endif()
+
+if (OS_IS_WIN)
+    target_link_libraries(${UPDATE_HELPER_TARGET} PRIVATE
+        taskschd  # CLSID_TaskScheduler, IID_ITaskService, IID_IExecAction
+        ole32     # CoInitializeEx, CoCreateInstance
+        oleaut32  # SysAllocString, VariantInit
+        advapi32  # registry, security descriptors, DuplicateTokenEx, CreateProcessAsUserW
+        shell32   # CommandLineToArgvW
+        wintrust  # WinVerifyTrust and the WTHelper* signer accessors
+        crypt32   # CertGetNameStringW
+        userenv   # CreateEnvironmentBlock
+        wtsapi32  # WTSQueryUserToken
+        msi       # MsiInstallProductW and the external UI handler
+        user32    # the progress window
+        gdi32     # and what it is drawn with
+    )
+endif()
+
+# On macOS the helper is embedded into the app bundle by the app target.
+if (NOT OS_IS_MAC)
+    set(UPDATE_HELPER_INSTALL_DIR "${CMAKE_INSTALL_BINDIR}")
+    if (NOT UPDATE_HELPER_INSTALL_DIR)
+        # GNUInstallDirs is not necessarily in use; the application itself is
+        # installed into "bin" and the helper has to sit next to it.
+        set(UPDATE_HELPER_INSTALL_DIR "bin")
+    endif()
+
+    install(TARGETS ${UPDATE_HELPER_TARGET}
+        RUNTIME DESTINATION ${UPDATE_HELPER_INSTALL_DIR}
+    )
+endif()