mirror of
https://gitlab.com/pholy/OSCAR-code.git
synced 2025-04-05 18:50:44 +00:00
2e92107cce
The full version now includes the build/git information embedded within
it as build metadata according to the Semantic Versioning 2.0.0 spec,
for example: "1.1.0-beta-1+branch-name-a1b2c3d".
Now the full version string, with all detail is always displayed
EXCEPT for release versions, in which case just the simple version
number ("1.1.0") is displayed in the primary UI.
- Main window title: simple version for release versions, full version
string otherwise
- Notifications: same as main window title
- System tray: same as main window title
- About window title: same as main window title
- About window release notes: always include full version string
- Reports: always include full version string
- Under the logo (about dialog, profile selector, new profile
window): removed, as it is largely redundant and can
interfere with the window geometry.
- Database upgrade alert: same as main window title
- Database newer alert: same as main window title
The full version string is also included within the preference and
profile .xml files, but because build metadata is ignored in version
comparisons, differences in builds will not cause any spurious
alerts. However, changes in prerelease versions will continue to
be significant, as they should be.
59 lines
1.9 KiB
C++
59 lines
1.9 KiB
C++
/* Version.h
|
|
*
|
|
* Copyright (c) 2020 The OSCAR Team
|
|
* Copyright (c) 2011-2018 Mark Watkins <mark@jedimark.net>
|
|
*
|
|
* This file is subject to the terms and conditions of the GNU General Public
|
|
* License. See the file COPYING in the main directory of the source code
|
|
* for more details. */
|
|
|
|
#ifndef VERSION_H
|
|
#define VERSION_H
|
|
|
|
#include <QString>
|
|
|
|
class Version
|
|
{
|
|
friend class VersionTests;
|
|
public:
|
|
Version(const QString & version_string);
|
|
const QString PrereleaseType() const;
|
|
bool IsReleaseVersion() const { return mPrerelease.isEmpty(); }
|
|
bool IsValid() const { return mIsValid; }
|
|
bool operator==(const Version & b) const { return Compare(*this, b) == 0; }
|
|
bool operator!=(const Version & b) const { return Compare(*this, b) != 0; }
|
|
bool operator<(const Version & b) const { return Compare(*this, b) < 0; }
|
|
bool operator>(const Version & b) const { return Compare(*this, b) > 0; }
|
|
|
|
//!brief Returns the full version string, including all metadata, used in reports
|
|
operator const QString &() const;
|
|
//!brief Returns the full version string, including all metadata, used in reports
|
|
const QString & toString() const;
|
|
//!brief Returns the version string to display in the UI, without build metadata if a release version
|
|
const QString displayString() const;
|
|
//!brief Returns the version string without any build metadata
|
|
const QString minimalString() const;
|
|
//!brief Returns the build metadata
|
|
const QString & getBuildMetadata() const;
|
|
|
|
protected:
|
|
const QString mString;
|
|
bool mIsValid;
|
|
|
|
int mMajor, mMinor, mPatch;
|
|
QString mPrerelease, mBuild;
|
|
|
|
void ParseSemanticVersion();
|
|
void FixLegacyVersions();
|
|
static int Compare(const Version & a, const Version & b);
|
|
};
|
|
|
|
//!brief Get the current version of the application.
|
|
const Version & getVersion();
|
|
|
|
QString getPrereleaseSuffix();
|
|
const QString & gitRevision();
|
|
const QString & gitBranch();
|
|
|
|
#endif // VERSION_H
|