DEV Community

QuickQ Handbook Team
QuickQ Handbook Team

Posted on

Your installer is not broken, your download is truncated

Every "it won't install" report I have looked at recently ended in the same place: the download, not the installer.

Installed is not the same as intact

A truncated installer does not fail loudly. The download completes, the file gets a normal icon, and the failure only appears when the installer tries to unpack itself — at which point the message says "corrupted file", which reads like an OS problem and sends people off to change system settings.

The cheap check is size. Before downloading, note the size range the page publishes. After downloading, compare. A gap of tens of megabytes means the transfer was cut; a gap of a few megabytes is normal variation.

Four checks, in cost order

  1. Domain — read the address bar character by character before clicking download. If the host changes after the click, stop there.
  2. Size — compare against the published range. Under-sized means truncated; re-download rather than resuming.
  3. Extension — Windows gets an exe, macOS gets a dmg, Android gets an apk. A zip wrapping an exe means it was re-packed by someone else.
  4. Signature — on Windows, the file properties should carry a signature page. On macOS, Gatekeeper should have an opinion. A missing signature is a stop sign, not a warning.

Why resuming is a trap

Resume depends on the server honouring range requests, and on both halves coming from the same build. If a new version is published between the two requests, the resumed file is half old, half new — it finishes, it installs, and it behaves strangely. Re-downloading is faster than debugging that.

I keep a longer write-up with the five-platform file table and the failure modes per platform here: QuickQ download verification notes — it is an independent handbook, not vendor documentation, and it records the checks rather than promising a fix.

The reusable part: treat "downloaded" and "intact" as two different states, and check size before touching the installer.

Top comments (0)