Средство обновления

Средство обновления доставляет обновления ПО из приложения, избавляя вас от необходимости создавать собственный конвейер скачивания, проверки и замены. Оно работает на основе app.Updater, принимает один или несколько подключаемых Providerов (GitHub Releases, keygen.sh, Sparkle AppCast, открытый протокол Wails Update Manifest или собственную реализацию), проверяет подлинность скачанных файлов с помощью настроенного открытого ключа, безопасно заменяет выполняемый бинарный файл и передаёт сведения о каждом переходе через стандартную шину событий Wails.

Быстрый старт

package main

import (
    "context"
    "log"

    "github.com/wailsapp/wails/v3/pkg/application"
    "github.com/wailsapp/wails/v3/pkg/updater"
    "github.com/wailsapp/wails/v3/pkg/updater/providers/github"
)

func main() {
    app := application.New(application.Options{Name: "Demo"})

    gh, _ := github.New(github.Config{Repository: "myorg/myapp"})
    if err := app.Updater.Init(updater.Config{
        CurrentVersion: "1.0.0",
        Providers:      []updater.Provider{gh},
    }); err != nil {
        log.Fatal(err)
    }

    if err := app.Updater.CheckAndInstall(context.Background()); err != nil {
        log.Printf("update: %v", err)
    }

    _ = app.Run()
}

В результате откроется окно обновления фреймворка, будет выполнена проверка GitHub, скачан и проверен артефакт для текущей платформы, заменён бинарный файл, после чего средство обновления будет ожидать, пока пользователь перезапустит приложение.

Жизненный цикл

app.Updater — это конечный автомат со следующими состояниями (updater.State):

Текущее состояние можно в любой момент получить с помощью app.Updater.State(). При каждом переходе также создаётся событие Wails (см. раздел «События»).

Restart ждёт, пока вспомогательный процесс достигнет application.New, прежде чем попросить работающее приложение завершиться. Время ожидания запуска по умолчанию составляет 30 секунд. Если приложение выполняет длительную инициализацию до application.New, задайте для Config.HelperReadyTimeout большую длительность, например time.Minute. Ноль выбирает значение по умолчанию; отрицательные длительности отклоняются. Если время ожидания запуска истекло, Restart возвращает updater.ErrHelperNotReady и оставляет работающее приложение открытым.

Обновление размещается во временном каталоге wails-update-* рядом с установленным исполняемым файлом (в macOS — рядом с пакетом .app), поэтому этот каталог должен быть доступен для записи.

Внутри AppImage средство обновления заменяет и перезапускает файл .AppImage, указанный в $APPIMAGE, а не точку монтирования, доступную только для чтения.

Стандартное окно автоматически отображает текущее состояние. Например, если Check сообщает, что обновление не требуется, пользователь увидит соответствующее сообщение и закроет окно кнопкой «Закрыть»:

Провайдеры

Provider может быть любая реализация, соответствующая этому интерфейсу:

type Provider interface {
    Name() string
    Check(ctx context.Context, req CheckRequest) (*Release, error)
    Download(ctx context.Context, r *Release, dst io.Writer, onProgress func(written, total int64)) error
}

В репозитории поставляются четыре реализации.

GitHub Releases — updater/providers/github

gh, err := github.New(github.Config{
    Repository:    "myorg/myapp",     // your owner/repo (required)
    Token:         "ghp_…",           // optional; raises rate limit + private repos
    Prerelease:    false,             // include pre-releases in latest lookup
    ChecksumAsset: "SHA256SUMS",      // optional sibling asset for digest verification
    BaseURL:       "",                // optional override (e.g. GitHub Enterprise)
    AssetMatcher:  nil,               // optional custom asset-picker; nil uses DefaultAssetMatcher
    HTTPClient:    nil,               // optional client override
})

Стандартный механизм сопоставления артефактов ищет в имени файла сочетание подстрок GOOS и GOARCH, распознавая распространённые псевдонимы (amd64 / x86_64 / x64, arm64 / aarch64, 386 / i386 / x86 / ia32). Для собственных схем именования:

gh, _ := github.New(github.Config{
    Repository: "myorg/myapp",
    AssetMatcher: func(req updater.CheckRequest, assets []github.ReleaseAsset) int {
        for i, a := range assets {
            if strings.Contains(a.Name, "my-naming-convention") &&
               strings.Contains(a.Name, req.Platform) {
                return i
            }
        }
        return -1 // no match
    },
})

ChecksumAsset — это имя соседнего артефакта выпуска, содержимое которого представляет собой строки <sha256> <filename> (в таком формате выводят данные sha256sum и shasum -a 256). Провайдер получает этот файл во время Check, находит строку, соответствующую выбранному артефакту, и заполняет Release.Verification.Digest, чтобы фреймворк проверил скачанный файл.

keygen.sh — updater/providers/keygen

kg, err := keygen.New(keygen.Config{
    Account:    "your-account-slug", // required
    Product:    "product-uuid",      // optional but recommended when account has multiple products
    Package:    "",                  // optional further narrowing
    Channel:    "stable",            // "stable" / "rc" / "beta" / "alpha" / "dev"
    Filetype:   "",                  // optional artifact filetype filter ("dmg", "exe", …)
    Token:      "prod-…",            // product / environment / user / admin token; wins over LicenseKey
    LicenseKey: "",                  // license key auth (used only when Token is empty)
    BaseURL:    "",                  // optional API base override
    HTTPClient: nil,                 // optional client override; redirect-strip wrapper still applied
})

Провайдер автоматически помещает контрольную сумму SHA-512 и подпись Ed25519ph для каждого артефакта keygen.sh в блок Release.Verification фреймворка — дополнительная настройка не требуется.

Форматы токенов: токены keygen.sh содержат префикс роли (admi- / prod- / envi- / user-). Необработанный UUID, отображаемый на панели управления, — это идентификатор токена, а не его секретное значение. Секрет отображается только при создании токена. Подробности см. в документации по аутентификации keygen.sh.

Sparkle AppCast — updater/providers/appcast

ac, err := appcast.New(appcast.Config{
    URL:        "https://your.app/appcast.xml", // required
    Channel:    "stable",                       // optional sparkle:channel filter
    HTTPClient: nil,                            // optional client override
})

Подключается к существующей инфраструктуре Sparkle / WinSparkle без каких-либо изменений. Считывает из ленты sparkle:shortVersionString, <enclosure url type length sparkle:os sparkle:edSignature> и sparkle:channel.

DSA-подписи из Sparkle 1 (sparkle:dsaSignature) не поддерживаются. Проектам, использующим эту схему подписи, следует перейти на EdDSA (Sparkle 2).

Wails Update Manifest — updater/providers/endpoint

ep, err := endpoint.New(endpoint.Config{
    URL:        "https://updates.example.com/check", // required; supports {{platform}} / {{arch}} / {{version}} / {{channel}} placeholders
    Channel:    "stable",                            // optional channel filter
    Headers:    nil,                                 // optional headers, e.g. {"Authorization": "License <key>"}
    HTTPClient: nil,                                 // optional client override; redirect-strip wrapper still applied
})

Использует открытый протокол Wails Update Manifest: один документ JSON описывает последний выпуск и его артефакты для каждой платформы, включая контрольные суммы и подписи. Один и тот же документ можно разместить на статическом файловом хостинге (S3, GitHub Pages или любой CDN — публикуйте для каждого канала один манифест со списком всех платформ) либо выдавать с динамического сервера обновлений (при каждой проверке провайдер отправляет platform, arch, version и channel, поэтому сервер может вернуть ровно один артефакт или ограничить доступ на основании лицензии).

Благодаря заполнителям URL статическую структуру можно настроить одной строкой:

ep, _ := endpoint.New(endpoint.Config{
    URL: "https://cdn.example.com/updates/{{platform}}/{{arch}}/stable.json",
})

Настроенные заголовки отправляются с каждым запросом манифеста. При скачивании артефактов они используются повторно только на том же хосте, где расположен манифест, и при отсутствии перехода с https на http. Заголовок Authorization удаляется при любом перенаправлении со сменой origin или понижением уровня безопасности.

За публикацию отвечает CLI: wails3 updater manifest одной командой вычисляет дайджесты файлов выпуска, подписывает и описывает их, а wails3 updater verify повторно проверяет результат перед отправкой. См. раздел «Публикация с помощью CLI wails3».

Цепочка резервных провайдеров

Порядок элементов в Config.Providers имеет значение. Средство обновления последовательно обходит их: используется первый провайдер, вернувший выпуск; первый ответ «установлена актуальная версия» немедленно прерывает обход цепочки (резервный провайдер нужен на случай, когда основной недоступен, а не когда провайдеры расходятся во мнениях). При ошибке средство обновления переходит к следующему провайдеру.

app.Updater.Init(updater.Config{
    CurrentVersion: "1.0.0",
    Providers: []updater.Provider{
        kg, // primary: licensed customers
        gh, // fallback: public mirror
    },
})

Создание собственного провайдера

Три метода и около 150 строк в типичной реализации. Updater отвечает за проверку, атомарную подготовку, замену и окно, а код провайдера определяет следующий выпуск и передаёт байты в потоковом режиме:

type CustomProvider struct { /* config */ }

func (p *CustomProvider) Name() string { return "custom" }

func (p *CustomProvider) Check(ctx context.Context, req updater.CheckRequest) (*updater.Release, error) {
    // Hit your update endpoint, decide whether req.CurrentVersion is current,
    // and return either nil (no upgrade) or a *Release with Artifact + optional
    // Verification populated.
    // Errors here drop through to the next provider in Config.Providers.
}

func (p *CustomProvider) Download(ctx context.Context, r *updater.Release, dst io.Writer, onProgress func(int64, int64)) error {
    // Stream the artifact's bytes to dst. Call onProgress(written, total) as
    // bytes flow past; the Updater debounces emits to ~10 Hz on the event bus.
}

Используйте провайдеры из дерева исходного кода как образцы — каждый из них реализован в одном файле Go.

Криптографическая проверка

Подлинность выпусков проверяет встроенный в фреймворк модуль проверки, используя Config.PublicKey как корень доверия:

//go:embed publickey.pem
var publicKey []byte

app.Updater.Init(updater.Config{
    CurrentVersion: "1.0.0",
    Providers:      []updater.Provider{...},
    PublicKey:      publicKey,
})

Поддерживаемые алгоритмы (Release.Verification.SignatureAlgo):

Кроме того, если выпуск содержит хеш, но не подпись, поддерживается проверка только по дайджесту (DigestAlgo: sha256 / sha512).

Config.PublicKey — ЕДИНСТВЕННЫЙ якорь доверия при проверке подписи: источник выпуска никак не может подставить собственный ключ. Если выпуск содержит Signature, но Config.PublicKey не настроен, проверка завершается отказом. Модуль проверки вычисляет дайджест за один потоковый проход во время скачивания, поэтому даже для обновлений размером в несколько гигабайт проверка не требует дополнительного прохода по диску.

Создание ключа подписи

wails3 updater genkey
# updater.key       — keep secret, use to sign releases
# updater.key.pub   — bundle in your app via go:embed

Закрытый ключ имеет формат PKCS#8 PEM, а открытый — PKIX PEM; Config.PublicKey принимает файл .pub без изменений (также принимается необработанный ключ длиной 32 байт или его представление в base64, которое genkey выводит для встраивания). Подписывайте выпуски с помощью wails3 updater manifest -key updater.key ... или wails3 updater sign; см. раздел «Публикация с помощью CLI wails3».

Или на Go:

import "crypto/ed25519"
import "crypto/rand"

pub, priv, _ := ed25519.GenerateKey(rand.Reader)
// Persist `priv` securely (HSM, signing CI, etc.); embed `pub` in your binary.

Форматы артефактов

Провайдеры передают в потоковом режиме байты любого опубликованного вами файла; затем перед заменой фреймворк распаковывает его:

• Один исполняемый файл (например, myapp-linux-amd64) — используется без изменений. Часто применяется в Linux.
• .zip — распаковывается на месте. Архив должен содержать ровно один элемент верхнего уровня (обычно пакет macOS .app или один исполняемый файл). Рекомендуемый формат пакета для macOS.
• .tar.gz / .tgz — распаковывается на месте с тем же требованием единственного элемента верхнего уровня. Удобно для дистрибутивов Linux, которые поставляют дерево среды выполнения вместе с исполняемым файлом.

Архивы с несколькими элементами верхнего уровня отклоняются: фреймворк заменяет одну цель на диске, поэтому команда «установить этот архив на место» неоднозначна, если архив содержит несколько объектов. .dmg и .pkg (macOS), а также .msi (Windows) не поддерживаются в v1 — вместо них распространяйте .zip пакета. При извлечении действует защита от zip-slip, отклоняются символические ссылки, ведущие за пределы корня архива, а общий размер несжатых данных и количество элементов ограничены соответственно 2 ГиБ и 50 000.

Окно по умолчанию

app.Updater.CheckAndInstall(ctx) открывает принадлежащее фреймворку окно размером 520×540 со следующими элементами:

• Главный значок, зависящий от состояния (синяя ↓ — обновление доступно или скачивается, зелёная ✓ — готово или установлена актуальная версия, красный ! — ошибка)
• Метка версии: v1.0.0 → v2.0.1 · 8.8 MB
• Прокручиваемая панель примечаний к выпуску с отрисованным Markdown (абзацы, полужирное и курсивное начертание, списки, таблицы GFM, встроенный код, ограждённые блоки кода, заголовки h1–h3, ссылки)
• Одно основное действие для каждого состояния (Установить / Перезапустить и применить / Повторить)
• Второстепенные действия в стиле ghost (Пропустить эту версию / Напомнить позже)
• Тёмный и светлый режимы через prefers-color-scheme
• Мерцающий индикатор неопределённого прогресса, когда общий размер неизвестен

Окно прослушивает события updater:* в шине событий Wails и отправляет действия updater:user:* обратно в Go.

Настройка темы с помощью переменных CSS

app.Updater.Init(updater.Config{
    // …
    Window: &updater.BuiltinWindow{
        CSS: `:root { --accent: #ff6f00; --bg: #1a1a1a; --fg: #fafafa; }`,
    },
})

Таблица стилей по умолчанию предоставляет следующие переменные — можно переопределить любую из них:

Замена шаблона

Предоставьте собственный HTML; он должен лишь прослушивать события wails:updater:* и отправлять действия wails:updater:user:*:

app.Updater.Init(updater.Config{
    // …
    Window: &updater.BuiltinWindow{
        HTML: myCustomTemplate,
    },
})

Окна InitialHTML загружаются без источника сервера ресурсов, поэтому не могут динамически получать /wails/runtime.js. Связаться из такого окна с хостом можно двумя способами:

1. Просто напишите HTML. Фреймворк автоматически внедряет минимальную прослойку window.wails.Events в любое окно, открытое с заданными WebviewWindowOptions.AllowSimpleEventEmit = true и HTML — именно так работают встроенный сценарий средства обновления и сценарий с собственным окном. Этап сборки не требуется. Этот способ используется в примере ниже.
2. Соберите @wailsio/runtime выбранным сборщиком (Vite, esbuild, Rollup) и во время сборки импортируйте его в свой HTML. Events.On работает сразу, поскольку выполняется исключительно на стороне клиента; Events.Emit использует транспорт fetch среды выполнения, который не работает при origin со значением null. Поэтому установите небольшой транспорт postMessage через точку расширения setTransport среды выполнения, направляющий сообщения через window._wails.invoke("wails:event:emit:<name>"). Если window.wails.Events уже находится в области видимости, внедрение фреймворка ничего не делает, поэтому эти два подхода не конфликтуют.

В обоих случаях JavaScript в вашем HTML вызывает один и тот же API Events.On / Events.Emit:

<script>
const { On, Emit } = window.wails.Events;

On("wails:updater:update-available", (e) => {
    const rel = e.data ?? e;
    document.getElementById("ver").textContent = rel.version;
});

document.getElementById("install").addEventListener("click",
    () => Emit("wails:updater:user:install"));

// Ask the host to replay the current state so we paint correctly on (re)open.
Emit("wails:updater:window:ready");
</script>

Прослойка предоставляет ту часть современного API среды выполнения, которая нужна событиям с простыми именами: Events.On(name, cb) возвращает функцию отмены подписки, а Events.Emit(nameOrEventObject) направляет запрос хосту через защищённый условиями путь postMessage wails:event:emit:. Прослойка устанавливается один раз при загрузке страницы, до выполнения любых ваших встроенных скриптов.

Если вы хотите переопределить прослойку (или загружаете полную среду выполнения другим способом), задайте window.wails.Events до выполнения первого тега <script> на странице — тогда внедрение будет пропущено.

Оформление окна

Переопределите параметры окна (размер, отсутствие рамки, отображение поверх остальных окон), не изменяя HTML:

Window: &updater.BuiltinWindow{
    Options: updater.WindowOptions{
        Title:         "My App Updater",
        Width:         640,
        Height:        480,
        Frameless:     true,
        AlwaysOnTop:   true,
        DisableResize: false,
    },
},

Собственное окно

Управляйте процессом обновления через созданный вами *application.WebviewWindow. Средство обновления вызывает для вашего окна Show() / Close() / EmitEvent(), а ваш HTML определяет, что отображать:

myWin := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title:                "My Updater",
    Width:                520, Height: 460,
    HTML:                 myCustomHTML,
    AllowSimpleEventEmit: true,           // see security note below
})
app.Updater.Init(updater.Config{
    // …
    Window: updater.BYOWindow(myWin.AsUpdaterWindow()),
})

Ваш HTML использует window.wails.Events.On / Events.Emit так же, как встроенный шаблон: автоматически внедряемая фреймворком прослойка добавляется в любое окно с AllowSimpleEventEmit: true независимо от того, принадлежит окно фреймворку или вам. Описание API см. в разделе Замена шаблона.

Без интерфейса

app.Updater.Init(updater.Config{
    // …
    Window: updater.WindowNone,
})

Окно никогда не открывается. Подпишитесь на события updater:* из собственного интерфейса (или существующего главного окна) и вызывайте app.Updater.CheckAndInstall(ctx) в обработчике кнопки. Это удобно для периодических фоновых проверок, результаты которых следует показывать только при обнаружении обновления, а также для приложений, интегрирующих процесс обновления в собственную панель настроек.

События

И Go, и JavaScript подписываются через стандартную шину событий Wails. Не вводите передаваемые строковые значения вручную — используйте константы, экспортируемые пакетом updater (Go) или пакетом среды выполнения (JS). Оба уровня используют один и тот же набор имён, синхронность которого контролируется регрессионным тестом.

Из Go

Константы находятся в github.com/wailsapp/wails/v3/pkg/updater. Подписывайтесь через app.Event.On(name, fn); функция обратного вызова получает *application.CustomEvent, в поле Data которого находится типизированная полезная нагрузка, указанная в справочнике событий. Выполняйте утверждение типа, а не декодирование JSON:

import (
    "log"

    "github.com/wailsapp/wails/v3/pkg/application"
    "github.com/wailsapp/wails/v3/pkg/updater"
)

// …

app.Event.On(updater.EventUpdateAvailable, func(e *application.CustomEvent) {
    rel, ok := e.Data.(*updater.Release)
    if !ok { return }
    log.Printf("update found: %s", rel.Version)
})

app.Event.On(updater.EventDownloadProgress, func(e *application.CustomEvent) {
    p, ok := e.Data.(updater.Progress)
    if !ok { return }
    log.Printf("%d / %d bytes (%.0f KB/s)", p.Written, p.Total, p.Rate/1024)
})

app.Event.On(updater.EventError, func(e *application.CustomEvent) {
    info, ok := e.Data.(updater.ErrorInfo)
    if !ok { return }
    log.Printf("update failed during %s: %s", info.Stage, info.Message)
})

Все доступные константы Go:

Из JavaScript

Константы находятся в пространстве имён Updater.Events модуля @wailsio/runtime. Их имена совпадают с именами в Go, а для удобства поиска через автодополнение они сгруппированы по вложенным пространствам имён (User.*, Window.*):

import { Events, Updater } from "@wailsio/runtime";

Events.On(Updater.Events.UpdateAvailable, (e) => {
    console.log("update found:", e.data.version);
});

Events.On(Updater.Events.DownloadProgress, (e) => {
    const p = e.data;
    console.log(`${p.written} / ${p.total} bytes (${(p.rate/1024).toFixed(1)} KB/s)`);
});

Events.On(Updater.Events.Error, (e) => {
    const info = e.data;
    console.error(`update failed during ${info.stage}: ${info.message}`);
});

События действий пользователя, которые ваш HTML отправляет обратно хосту, находятся в пространстве имён Updater.Events.User:

import { Updater } from "@wailsio/runtime";

document.getElementById("install-btn").addEventListener("click", () => {
    // The framework window does this internally via the postMessage shim;
    // shown here for BYO templates that need to drive the flow themselves.
    window._wails.invoke("wails:event:emit:" + Updater.Events.User.Install);
});

Справочник событий

Сторона-подписчик (хост → страница):

Сторона страницы (страница → хост) — если вы создаёте собственный шаблон, ваш код подписывается на эти события:

Справочник API

updater.Config

Методы *updater.Updater

Ошибки

Как выполняется замена

Restart повторно запускает текущий исполняемый файл, задав сигнальные переменные окружения. application.New обнаруживает их при запуске и переключается в режим вспомогательного процесса:

1. Вспомогательный процесс ожидает завершения родительского процесса с указанным PID не более 30 с (platformIsAlive опрашивает его через syscall.OpenProcess + GetExitCodeProcess в Windows и через os.FindProcess + proc.Signal(syscall.Signal(0)) в Unix).
2. Вспомогательный процесс создаёт резервную копию целевого объекта (копирует файл либо рекурсивно копирует каталоги пакетов macOS .app).
3. Вспомогательный процесс заменяет целевой объект подготовленным артефактом, делая до 20 попыток с задержкой 500 мс между ними:

• Unix — os.RemoveAll(target) + os.Rename(newPath, target). Открытые файловые дескрипторы, ссылающиеся на прежний inode, остаются действительными.
• Windows — os.Rename(target, target.old.<nanos>) + os.Rename(newPath, target). Windows позволяет переименовывать файлы, образ которых всё ещё отображён в память, но не позволяет удалять их; при следующем обновлении вспомогательный процесс удаляет все оставшиеся соседние объекты .old.*, отображение которых в ядре уже освобождено.

4. Вспомогательный процесс восстанавливает для нового исполняемого файла исходный режим доступа (скачанный файл был создан с umask по умолчанию, из-за чего в Unix сбрасывается +x; в Windows эта операция ничего не делает).
5. Вспомогательный процесс удаляет из окружения переменные режима вспомогательного процесса и повторно запускает уже заменённый исполняемый файл.
6. Вспомогательный процесс завершается.

Если запуск завершается ошибкой, вспомогательный процесс восстанавливает резервную копию. Если родительский процесс не завершается в течение 30 с, вспомогательный процесс прерывает работу, не изменяя целевой объект (поэтому у пользователя остаётся работоспособное приложение, даже если диалог завершения работы блокирует Quit).

Для пакетов macOS .app, распространяемых как .zip (рекомендуемый способ упаковки), архив распаковывается между проверкой и переходом в состояние готовности, чтобы вспомогательный процесс мог заменить целевой объект настоящим каталогом.

Периодическая проверка

app.Updater.Init(updater.Config{
    // …
    CheckInterval: 6 * time.Hour,
})

Если задано CheckInterval > 0, фоновая горутина вызывает CheckAndInstall с настроенным интервалом. Срабатывания таймера, происходящие во время уже выполняющегося процесса (проверки, скачивания, верификации или установки), пропускаются — параллельные конечные автоматы не поддерживаются.

Чтобы фоновая проверка выполнялась незаметно и сообщала о себе только при обнаружении обновления, задайте Window: updater.WindowNone и обрабатывайте EventUpdateAvailable в собственном пользовательском интерфейсе.

Пропуск и напоминание

Кнопка «Пропустить эту версию» в окне по умолчанию сохраняет доступную версию через SkipVersion(rel.Version). Последующие вызовы Check обнаруживают ту же версию и считают приложение актуальным (пока пользователь не обновит CurrentVersion, что происходит автоматически после успешного выполнения Restart). Кнопка «Напомнить позже» просто закрывает окно, ничего не сохраняя.

// Reading what the user skipped (e.g. to surface in app settings)
if v := app.Updater.SkippedVersion(); v != "" {
    log.Printf("user skipped %s", v)
}

// Programmatically clearing the skip:
app.Updater.SkipVersion("")

Контрольный список для распространения

Перед публикацией выпуска, который будет установлен средством обновления:

1. Выберите правильный формат архива. macOS: .zip пакета .app. Linux: один исполняемый файл или .tar.gz. Windows: один файл .exe или .zip. Форматы .dmg / .msi / .pkg не поддерживаются.
2. Подпишите артефакт закрытым ключом, соответствующим Config.PublicKey. Для лент, публикуемых провайдерами (keygen.sh, AppCast), следуйте процедуре подписания соответствующего провайдера. Для GitHub Releases с ChecksumAsset создайте файл SHA256SUMS с помощью sha256sum / shasum -a 256.
3. Обеспечьте совпадение строки версии. Значение Config.CurrentVersion должно точно совпадать с тегом версии выпуска (например, 1.0.0 ↔ тег v1.0.0; начальный символ v удаляется на стороне провайдера).
4. Протестируйте замену на целевой платформе хотя бы один раз перед выпуском — обработка подписи кода, нотариального заверения и Gatekeeper зависит от платформы и не выполняется самим средством обновления.

Устранение неполадок

«для подписи требуется открытый ключ, но он не настроен» — в выпуске есть поле Signature, но Config.PublicKey пусто. Задайте открытый ключ или измените конвейер выпуска, чтобы он не включал подпись.

«несовпадение дайджеста» — скачанные байты не соответствуют данным, заявленным провайдером. Обычно причина заключается в неполной загрузке из-за сбоя сети или повреждённом артефакте. Повторный запуск часто устраняет проблему.

Окно открывается, но сразу исчезает; нет ни Markdown, ни индикатора выполнения — ваш пользовательский HTML не вызвал wails:runtime:ready. См. вспомогательный код в разделе Замена шаблона.

Обновление в Windows не завершается; в журнале вспомогательного процесса указано «remove old (attempt N): Access is denied» — это происходит только в версиях этого PR до de764fb; текущая реализация переименовывает старый файл и отодвигает его в сторону, поэтому не подвержена этой проблеме. Обновитесь.

Gatekeeper в macOS блокирует заменённый исполняемый файл — подпись кода должна сохраняться на всех этапах. Подпишите исходный .app и повторно подпишите перезапускаемый исполняемый файл, если конвейер сборки изменяет права при обновлении.

См. также

• Готовый к запуску пример: v3/examples/updater
• Репозиторий с тестовой демонстрацией: wailsapp/updater-demo
• Учебное руководство: Добавление самообновления в приложение Wails