Troubleshooting and code signing
Troubleshooting
Section titled “Troubleshooting”packages field missing or empty(pnpm):pnpm-workspace.yamlis missing itspackages:field, so pnpm 9’spnpm store patherrors. CI switched to npm (the local flow still uses pnpm).- Update artifact (
.sig) missing: confirmcreateUpdaterArtifacts: trueand that the build is signed; with--target, artifacts live intarget/<triple>/release/bundle(release.mjsalready handles it). - Windows update package: Tauri v2 uses
*-setup.exe(+.exe.sig), not.nsis.zip. - Release includes build intermediates (e.g.
build-script-build*.exe): scope collection to*/release/bundle/*. - Unsigned macOS package blocked by Gatekeeper: run
xattr -dr com.apple.quarantine /Applications/<Product>.appon first launch. - Server 403 / 500: make sure the static directory is anonymously readable and
latest.jsonreturns 200 + JSON. - Update prompt every launch:
latest.json.versiondoes not match the build version, or it is not monotonically increasing.
Code signing
Section titled “Code signing”OS code signing is optional and not required by this flow:
- macOS: an unsigned build risks Gatekeeper quarantine and update instability; Apple Developer ID + notarization resolves it.
- Windows: an unsigned build triggers SmartScreen warnings.