AppSettings.cc

Go to the documentation of this file.

#include "AppSettings.h"
#include "QGCFileHelper.h"
#include "QGCPalette.h"
#include "AppMessages.h"
#include "FirmwarePluginManager.h"
#include "QGCApplication.h"
#include "QGCLoggingCategory.h"
#include "QGCMAVLink.h"
#include "LinkManager.h"
 
#ifdef Q_OS_ANDROID
#include "AndroidInterface.h"
#endif
 
#include <QtCore/QStandardPaths>
#include <QtCore/QDir>
#include <QtCore/QSettings>
 
QGC_LOGGING_CATEGORY(AppSettingsLog, "Settings.AppSettings")
 
// Release languages are 90%+ complete
QList<QLocale::Language> AppSettings::_rgReleaseLanguages = {
    QLocale::English,
    QLocale::Azerbaijani,
    QLocale::Chinese,
    QLocale::Japanese,
    QLocale::Korean,
    QLocale::Portuguese,
    QLocale::Russian,
};
 
// Partial languages are 40%+ complete
QList<QLocale::Language> AppSettings::_rgPartialLanguages = {
    QLocale::Ukrainian,
};
 
AppSettings::LanguageInfo_t AppSettings::_rgLanguageInfo[] = {
    { QLocale::AnyLanguage,     "System" },                     // Must be first
    { QLocale::Azerbaijani,     "Azerbaijani (Azerbaijani)" },
    { QLocale::Bulgarian,       "български (Bulgarian)" },
    { QLocale::Chinese,         "中文 (Chinese)" },
    { QLocale::Dutch,           "Nederlands (Dutch)" },
    { QLocale::English,         "English" },
    { QLocale::Finnish,         "Suomi (Finnish)" },
    { QLocale::French,          "Français (French)" },
    { QLocale::German,          "Deutsche (German)" },
    { QLocale::Greek,           "Ελληνικά (Greek)" },
    { QLocale::Hebrew,          "עברית (Hebrew)" },
    { QLocale::Italian,         "Italiano (Italian)" },
    { QLocale::Japanese,        "日本語 (Japanese)" },
    { QLocale::Korean,          "한국어 (Korean)" },
    { QLocale::NorwegianBokmal, "Norsk (Norwegian)" },
    { QLocale::Polish,          "Polskie (Polish)" },
    { QLocale::Portuguese,      "Português (Portuguese)" },
    { QLocale::Russian,         "Pусский (Russian)" },
    { QLocale::Spanish,         "Español (Spanish)" },
    { QLocale::Swedish,         "Svenska (Swedish)" },
    { QLocale::Turkish,         "Türk (Turkish)" }
};
 
DECLARE_SETTINGGROUP(App, "")
{
    // Don't offer firmware classes whose plugin factory is not registered in this build
    const QList<QGCMAVLink::FirmwareClass_t> supportedFirmwareClasses = FirmwarePluginManager::instance()->supportedFirmwareClasses();
    const auto isSupported = [&supportedFirmwareClasses](const QVariant &value) {
        return supportedFirmwareClasses.contains(static_cast<QGCMAVLink::FirmwareClass_t>(value.toUInt()));
    };
    for (const char *factName : { preferredFirmwareClassName, offlineEditingFirmwareClassName }) {
        FactMetaData *const metaData = _nameToMetaDataMap.value(factName);
        if (!metaData) {
            qCWarning(AppSettingsLog) << "Missing metadata for fact" << factName;
            continue;
        }
        const QVariantList enumValues = metaData->enumValues();
        for (const QVariant &enumValue : enumValues) {
            if (!isSupported(enumValue)) {
                metaData->removeEnumInfo(enumValue);
            }
        }
    }
 
    // A previously stored value (or even the default) may no longer be supported by this build
    for (Fact *const fact : { preferredFirmwareClass(), offlineEditingFirmwareClass() }) {
        if (!isSupported(fact->rawValue())) {
            if (isSupported(fact->rawDefaultValue())) {
                fact->setRawValue(fact->rawDefaultValue());
            } else if (!fact->enumValues().isEmpty()) {
                fact->setRawValue(fact->enumValues().constFirst());
            }
        }
    }
 
    QGCPalette::setGlobalTheme(indoorPalette()->rawValue().toBool() ? QGCPalette::Dark : QGCPalette::Light);
 
    // Instantiate savePath so we can check for override and setup default path if needed
 
    SettingsFact* savePathFact = qobject_cast<SettingsFact*>(savePath());
    QString appName = QCoreApplication::applicationName();
#if defined(Q_OS_ANDROID) || defined(Q_OS_IOS)
    // Mobile builds always use the runtime generated location for savePath.
    bool userHasModifiedSavePath = false;
#else
    bool userHasModifiedSavePath = !savePathFact->rawValue().toString().isEmpty() || !_nameToMetaDataMap[savePathName]->rawDefaultValue().toString().isEmpty();
#endif
 
    if (!userHasModifiedSavePath) {
#if defined(Q_OS_ANDROID) || defined(Q_OS_IOS)
    #ifdef Q_OS_IOS
        // This will expose the directories directly to the File iOs app
        QDir rootDir = QDir(QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation));
        savePathFact->setRawValue(rootDir.absolutePath());
    #else
        QString rootDirPath;
        #ifdef Q_OS_ANDROID
            if (!androidDontSaveToSDCard()->rawValue().toBool()) {
                rootDirPath = AndroidInterface::getSDCardPath();
                qCDebug(AppSettingsLog) << "AndroidInterface::getSDCardPath()" << rootDirPath;
                if (rootDirPath.isEmpty() || !QDir(rootDirPath).exists()) {
                    rootDirPath.clear();
                    qCWarning(AppSettingsLog) << "Save to SD card specified for application data. But no SD card present or permissions not granted. Using internal storage.";
                } else if (!QFileInfo(rootDirPath).isWritable()) {
                    rootDirPath.clear();
                    QGC::showAppMessage(AppSettings::tr("Save to SD card specified for application data. But SD card is write protected. Using internal storage."));
                }
            }
        #endif
        if (rootDirPath.isEmpty()) {
            rootDirPath = QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation);
        }
        savePathFact->setRawValue(QDir(rootDirPath).filePath(appName));
    #endif
    savePathFact->setUserVisible(false);
#else
        QDir rootDir;
        if (QGC::runningUnitTests() || qgcApp()->simpleBootTest()) {
            rootDir = QDir(QStandardPaths::writableLocation(QStandardPaths::TempLocation));
        } else {
            rootDir = QDir(QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation));
        }
        savePathFact->setRawValue(rootDir.filePath(appName));
#endif
    }
 
    connect(savePathFact, &Fact::rawValueChanged, this, &AppSettings::savePathsChanged);
    connect(savePathFact, &Fact::rawValueChanged, this, &AppSettings::_checkSavePathDirectories);
 
#ifdef Q_OS_ANDROID
    // React to runtime toggling of the SD card setting
    connect(androidDontSaveToSDCard(), &Fact::rawValueChanged, this, [this, appName](QVariant value) {
        Fact* const fact = savePath();
        if (value.toBool()) {
            const QString internalBasePath = QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation);
            fact->setRawValue(QDir(internalBasePath).filePath(appName));
        } else {
            // If permission is already granted this returns the SD card root and we set the path here.
            // If not, it returns empty and launches the system permission UI. The result comes back through
            // jniStoragePermissionsResult, which sets the SD card save path (or reverts this setting on denial).
            const QString sdRootPath = AndroidInterface::getSDCardPath();
            if (!sdRootPath.isEmpty() && QDir(sdRootPath).exists() && QFileInfo(sdRootPath).isWritable()) {
                fact->setRawValue(QDir(sdRootPath).filePath(appName));
            }
        }
    });
#endif
 
    _checkSavePathDirectories();
 
    // When a specific preferred firmware/vehicle is chosen, keep the offline editing settings in sync
    connect(preferredFirmwareClass(), &Fact::rawValueChanged, this, [this](QVariant value) {
        if (value.toUInt() != 0) {
            offlineEditingFirmwareClass()->setRawValue(value);
        }
    });
    connect(preferredVehicleClass(), &Fact::rawValueChanged, this, [this](QVariant value) {
        if (value.toUInt() != 0) {
            offlineEditingVehicleClass()->setRawValue(value);
        }
    });
}
 
DECLARE_SETTINGSFACT(AppSettings, preferredFirmwareClass)
DECLARE_SETTINGSFACT(AppSettings, preferredVehicleClass)
DECLARE_SETTINGSFACT(AppSettings, offlineEditingFirmwareClass)
DECLARE_SETTINGSFACT(AppSettings, offlineEditingVehicleClass)
DECLARE_SETTINGSFACT(AppSettings, offlineEditingCruiseSpeed)
DECLARE_SETTINGSFACT(AppSettings, offlineEditingHoverSpeed)
DECLARE_SETTINGSFACT(AppSettings, offlineEditingAscentSpeed)
DECLARE_SETTINGSFACT(AppSettings, offlineEditingDescentSpeed)
DECLARE_SETTINGSFACT(AppSettings, batteryPercentRemainingAnnounce)
DECLARE_SETTINGSFACT(AppSettings, defaultMissionItemAltitude)
DECLARE_SETTINGSFACT(AppSettings, audioMuted)
DECLARE_SETTINGSFACT(AppSettings, audioVolume)
DECLARE_SETTINGSFACT(AppSettings, virtualJoystick)
DECLARE_SETTINGSFACT(AppSettings, virtualJoystickAutoCenterThrottle)
DECLARE_SETTINGSFACT(AppSettings, virtualJoystickLeftHandedMode)
DECLARE_SETTINGSFACT(AppSettings, uiScalePercent)
DECLARE_SETTINGSFACT(AppSettings, savePath)
DECLARE_SETTINGSFACT(AppSettings, androidDontSaveToSDCard)
DECLARE_SETTINGSFACT(AppSettings, androidUsePosixSerial)
DECLARE_SETTINGSFACT(AppSettings, useChecklist)
DECLARE_SETTINGSFACT(AppSettings, enforceChecklist)
DECLARE_SETTINGSFACT(AppSettings, enableMultiVehiclePanel)
DECLARE_SETTINGSFACT(AppSettings, tiandituToken)
DECLARE_SETTINGSFACT(AppSettings, mapboxToken)
DECLARE_SETTINGSFACT(AppSettings, mapboxAccount)
DECLARE_SETTINGSFACT(AppSettings, mapboxStyle)
DECLARE_SETTINGSFACT(AppSettings, esriToken)
DECLARE_SETTINGSFACT(AppSettings, customURL)
DECLARE_SETTINGSFACT(AppSettings, vworldToken)
DECLARE_SETTINGSFACT(AppSettings, openaipToken)
DECLARE_SETTINGSFACT(AppSettings, gstDebugLevel)
DECLARE_SETTINGSFACT(AppSettings, followTarget)
DECLARE_SETTINGSFACT(AppSettings, clearSettingsNextBoot)
DECLARE_SETTINGSFACT(AppSettings, disableAllPersistence)
DECLARE_SETTINGSFACT(AppSettings, firstRunPromptIdsShown)
DECLARE_SETTINGSFACT(AppSettings, lastNotifiedStableVersion)
DECLARE_SETTINGSFACT(AppSettings, favoriteParameters)
DECLARE_SETTINGSFACT(AppSettings, showAppLogTimestampAsElapsedTime)
 
DECLARE_SETTINGSFACT_NO_FUNC(AppSettings, indoorPalette)
{
    if (!_indoorPaletteFact) {
        _indoorPaletteFact = _createSettingsFact(indoorPaletteName);
        connect(_indoorPaletteFact, &Fact::rawValueChanged, this, &AppSettings::_indoorPaletteChanged);
    }
    return _indoorPaletteFact;
}
 
DECLARE_SETTINGSFACT_NO_FUNC(AppSettings, qLocaleLanguage)
{
    if (!_qLocaleLanguageFact) {
        _qLocaleLanguageFact = _createSettingsFact(qLocaleLanguageName);
        connect(_qLocaleLanguageFact, &Fact::rawValueChanged, this, &AppSettings::_qLocaleLanguageChanged);
 
        FactMetaData*   metaData            = _qLocaleLanguageFact->metaData();
        QStringList     rgEnumStrings;
        QVariantList    rgEnumValues;
 
        // System is always an available selection
        rgEnumStrings.append(_rgLanguageInfo[0].languageName);
        rgEnumValues.append(_rgLanguageInfo[0].languageId);
 
        for (const auto& languageInfo: _rgLanguageInfo) {
            if (_rgReleaseLanguages.contains(languageInfo.languageId)) {
                rgEnumStrings.append(languageInfo.languageName);
                rgEnumValues.append(languageInfo.languageId);
            }
        }
        for (const auto& languageInfo: _rgLanguageInfo) {
            if (_rgPartialLanguages.contains(languageInfo.languageId)) {
                rgEnumStrings.append(QString(languageInfo.languageName) + AppSettings::tr(" (Partial)"));
                rgEnumValues.append(languageInfo.languageId);
            }
        }
#ifdef QGC_DAILY_BUILD
        // Only daily builds include full set of languages for testing purposes
        for (const auto& languageInfo: _rgLanguageInfo) {
            if (!_rgReleaseLanguages.contains(languageInfo.languageId) && !_rgPartialLanguages.contains(languageInfo.languageId)) {
                rgEnumStrings.append(QString(languageInfo.languageName) + AppSettings::tr(" (Test Only)"));
                rgEnumValues.append(languageInfo.languageId);
            }
        }
#endif
#ifdef QT_DEBUG
        // Debug builds include pseudo-localization for UI layout testing
        rgEnumStrings.append(AppSettings::tr("Pseudo Localization (Test Only)"));
        rgEnumValues.append(QLocale::Esperanto);
#endif
        metaData->setEnumInfo(rgEnumStrings, rgEnumValues);
 
        if (_qLocaleLanguageFact->enumIndex() == -1) {
            _qLocaleLanguageFact->setRawValue(QLocale::AnyLanguage);
        }
    }
    return _qLocaleLanguageFact;
}
 
void AppSettings::_qLocaleLanguageChanged()
{
    qgcApp()->setLanguage();
}
 
void AppSettings::_checkSavePathDirectories(void)
{
    const QString savePath = this->savePath()->rawValue().toString();
    if (QGCFileHelper::ensureDirectoryExists(savePath)) {
        // Create all subdirectories
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, parameterDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, telemetryDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, missionDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, logDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, videoDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, photoDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, crashDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, mavlinkActionsDirectory));
        QGCFileHelper::ensureDirectoryExists(QGCFileHelper::joinPath(savePath, settingsDirectory));
    }
}
 
QString AppSettings::_childSavePath(const char* directory)
{
    const QString rootPath = savePath()->rawValue().toString();
    if (rootPath.isEmpty()) {
        return QString();
    }
 
    const QDir rootDir(rootPath);
    if (!rootDir.exists()) {
        return QString();
    }
 
    return rootDir.filePath(directory);
}
 
void AppSettings::_indoorPaletteChanged(void)
{
    QGCPalette::setGlobalTheme(indoorPalette()->rawValue().toBool() ? QGCPalette::Dark : QGCPalette::Light);
}
 
QString AppSettings::missionSavePath(void)
{
    return _childSavePath(missionDirectory);
}
 
QString AppSettings::parameterSavePath(void)
{
    return _childSavePath(parameterDirectory);
}
 
QString AppSettings::telemetrySavePath(void)
{
    return _childSavePath(telemetryDirectory);
}
 
QString AppSettings::logSavePath(void)
{
    return _childSavePath(logDirectory);
}
 
QString AppSettings::videoSavePath(void)
{
    return _childSavePath(videoDirectory);
}
 
QString AppSettings::photoSavePath(void)
{
    return _childSavePath(photoDirectory);
}
 
QString AppSettings::crashSavePath(void)
{
    return _childSavePath(crashDirectory);
}
 
QString AppSettings::mavlinkActionsSavePath(void)
{
    return _childSavePath(mavlinkActionsDirectory);
}
 
QString AppSettings::settingsSavePath(void)
{
    return _childSavePath(settingsDirectory);
}
 
QList<int> AppSettings::firstRunPromptsIdsVariantToList(const QVariant& firstRunPromptIds)
{
    QList<int> rgIds;
 
    QStringList strIdList = firstRunPromptIds.toString().split(",", Qt::SkipEmptyParts);
 
    for (const QString& strId: strIdList) {
        rgIds.append(strId.toInt());
    }
    return rgIds;
}
 
QVariant AppSettings::firstRunPromptsIdsListToVariant(const QList<int>& rgIds)
{
    QStringList strList;
    for (int id: rgIds) {
        strList.append(QString::number(id));
    }
    return QVariant(strList.join(","));
}
 
void AppSettings::firstRunPromptIdsMarkIdAsShown(int id)
{
    QList<int> rgIds = firstRunPromptsIdsVariantToList(firstRunPromptIdsShown()->rawValue());
    if (!rgIds.contains(id)) {
        rgIds.append(id);
        firstRunPromptIdsShown()->setRawValue(firstRunPromptsIdsListToVariant(rgIds));
    }
}
 
QLocale::Language AppSettings::_qLocaleLanguageEarlyAccess(void)
{
    QSettings settings;
 
    // Note that the AppSettings group has no group name
    QLocale::Language localeLanguage = static_cast<QLocale::Language>(settings.value(qLocaleLanguageName).toInt());
    for (auto& languageInfo: _rgLanguageInfo) {
        if (languageInfo.languageId == localeLanguage) {
            return localeLanguage;
        }
    }
 
#ifdef QT_DEBUG
    if (localeLanguage == QLocale::Esperanto) {
        return localeLanguage;
    }
#endif
 
    localeLanguage = QLocale::AnyLanguage;
    settings.setValue(qLocaleLanguageName, localeLanguage);
 
    return localeLanguage;
}