Version Number vs. Build Number
What the version and build numbers mean on iOS and Android, how Pgyer displays them, and how to switch which build number shows up.
"Version number" and "build number" are two different identifiers that mobile apps use for different purposes. This page defines them for iOS and Android, then explains how Pgyer displays each one and how to switch between them.
iOS and Android Equivalents
| iOS | Android | Purpose | Example Format | User-Facing |
|---|---|---|---|---|
| Version | versionName | The app's primary version identifier | 1.0.0 (major.minor.patch) | Yes |
| Build | versionCode | Identifies a specific build of the app | An integer that increments per build (e.g. 10023) | No |
- iOS: both values can be edited by hand in the Xcode project settings. App Store submissions must follow Apple's rules.
- Android:
versionNameis a user-facing string;versionCodeis an integer used for internal bookkeeping.
Pgyer's Default Build Number
To make it easy to tell different uploads of the same app apart, Pgyer auto-generates an incrementing build number for every upload. This number exists only on the Pgyer platform — the installer itself is never modified.
By default, the build number shown on the install page, the app management page, and elsewhere is the incrementing number Pgyer generated, not the build number baked into the installer.
Switch to the App's Own Build Number
For developers who prefer their own build numbering, Pgyer provides a switch. Open App Management → the app → Settings → App Settings, then choose the source under Build Number Generation:
- Pgyer's auto-incrementing build number (default);
- The build number defined inside the app itself.
Supported views such as the install page, version list, and overview use the selected source. Statistics filters, public APIs, historical exports, and other compatibility fields may still use Pgyer's generated build number. Automation that needs an exact value should distinguish between the Pgyer build and the build embedded in the installer.