/**************************************************************************** ** ** Copyright (C) 2015 The Qt Company Ltd. ** Contact: http://www.qt.io/licensing/ ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL21$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see http://www.qt.io/terms-conditions. For further ** information use the contact form at http://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 or version 3 as published by the Free ** Software Foundation and appearing in the file LICENSE.LGPLv21 and ** LICENSE.LGPLv3 included in the packaging of this file. Please review the ** following information to ensure the GNU Lesser General Public License ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** As a special exception, The Qt Company gives you certain additional ** rights. These rights are described in The Qt Company LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qstandardpaths.h" #include #include #include #ifndef QT_BOOTSTRAPPED #include #endif #include #include QT_BEGIN_NAMESPACE /* Translates a QStandardPaths::StandardLocation into the mac equivalent. */ OSType translateLocation(QStandardPaths::StandardLocation type) { switch (type) { case QStandardPaths::ConfigLocation: case QStandardPaths::GenericConfigLocation: case QStandardPaths::AppConfigLocation: return kPreferencesFolderType; case QStandardPaths::DesktopLocation: return kDesktopFolderType; case QStandardPaths::DocumentsLocation: return kDocumentsFolderType; case QStandardPaths::FontsLocation: // There are at least two different font directories on the mac: /Library/Fonts and ~/Library/Fonts. // To select a specific one we have to specify a different first parameter when calling FSFindFolder. return kFontsFolderType; case QStandardPaths::ApplicationsLocation: return kApplicationsFolderType; case QStandardPaths::MusicLocation: return kMusicDocumentsFolderType; case QStandardPaths::MoviesLocation: return kMovieDocumentsFolderType; case QStandardPaths::PicturesLocation: return kPictureDocumentsFolderType; case QStandardPaths::TempLocation: return kTemporaryFolderType; case QStandardPaths::GenericDataLocation: case QStandardPaths::RuntimeLocation: case QStandardPaths::AppDataLocation: case QStandardPaths::AppLocalDataLocation: return kApplicationSupportFolderType; case QStandardPaths::GenericCacheLocation: case QStandardPaths::CacheLocation: return kCachedDataFolderType; default: return kDesktopFolderType; } } /* Constructs a full unicode path from a FSRef. */ static QString getFullPath(const FSRef &ref) { QByteArray ba(2048, 0); if (FSRefMakePath(&ref, reinterpret_cast(ba.data()), ba.size()) == noErr) return QString::fromUtf8(ba.constData()).normalized(QString::NormalizationForm_C); return QString(); } static void appendOrganizationAndApp(QString &path) { #ifndef QT_BOOTSTRAPPED const QString org = QCoreApplication::organizationName(); if (!org.isEmpty()) path += QLatin1Char('/') + org; const QString appName = QCoreApplication::applicationName(); if (!appName.isEmpty()) path += QLatin1Char('/') + appName; #else Q_UNUSED(path); #endif } static QString macLocation(QStandardPaths::StandardLocation type, short domain) { // https://developer.apple.com/library/mac/documentation/Cocoa/Reference/Foundation/Classes/NSFileManager_Class/index.html if (type == QStandardPaths::DownloadLocation) { NSFileManager *fileManager = [NSFileManager defaultManager]; NSURL *url = [fileManager URLForDirectory:NSDownloadsDirectory inDomain:NSUserDomainMask appropriateForURL:nil create:NO error:nil]; if (!url) return QString(); return QString::fromNSString([url path]); } // http://developer.apple.com/documentation/Carbon/Reference/Folder_Manager/Reference/reference.html FSRef ref; OSErr err = FSFindFolder(domain, translateLocation(type), false, &ref); if (err) return QString(); QString path = getFullPath(ref); if (type == QStandardPaths::AppDataLocation || type == QStandardPaths::AppLocalDataLocation || type == QStandardPaths::CacheLocation || type == QStandardPaths::AppConfigLocation) appendOrganizationAndApp(path); return path; } QString QStandardPaths::writableLocation(StandardLocation type) { if (isTestModeEnabled()) { const QString qttestDir = QDir::homePath() + QLatin1String("/.qttest"); QString path; switch (type) { case GenericDataLocation: case AppDataLocation: case AppLocalDataLocation: path = qttestDir + QLatin1String("/Application Support"); if (type != GenericDataLocation) appendOrganizationAndApp(path); return path; case GenericCacheLocation: case CacheLocation: path = qttestDir + QLatin1String("/Cache"); if (type == CacheLocation) appendOrganizationAndApp(path); return path; case GenericConfigLocation: case ConfigLocation: case AppConfigLocation: path = qttestDir + QLatin1String("/Preferences"); if (type == AppConfigLocation) appendOrganizationAndApp(path); return path; default: break; } } switch (type) { case HomeLocation: return QDir::homePath(); case TempLocation: return QDir::tempPath(); case GenericDataLocation: case AppDataLocation: case AppLocalDataLocation: case GenericCacheLocation: case CacheLocation: case RuntimeLocation: return macLocation(type, kUserDomain); default: return macLocation(type, kOnAppropriateDisk); } } QStringList QStandardPaths::standardLocations(StandardLocation type) { QStringList dirs; if (type == GenericDataLocation || type == AppDataLocation || type == AppLocalDataLocation || type == GenericCacheLocation || type == CacheLocation) { const QString path = macLocation(type, kOnAppropriateDisk); if (!path.isEmpty()) dirs.append(path); } if (type == AppDataLocation || type == AppLocalDataLocation) { CFBundleRef mainBundle = CFBundleGetMainBundle(); if (mainBundle) { CFURLRef bundleUrl = CFBundleCopyBundleURL(mainBundle); CFStringRef cfBundlePath = CFURLCopyPath(bundleUrl); QString bundlePath = QCFString::toQString(cfBundlePath); CFRelease(cfBundlePath); CFRelease(bundleUrl); CFURLRef resourcesUrl = CFBundleCopyResourcesDirectoryURL(mainBundle); CFStringRef cfResourcesPath = CFURLCopyPath(bundleUrl); QString resourcesPath = QCFString::toQString(cfResourcesPath); CFRelease(cfResourcesPath); CFRelease(resourcesUrl); // Handle bundled vs unbundled executables. CFBundleGetMainBundle() returns // a valid bundle in both cases. CFBundleCopyResourcesDirectoryURL() returns // an absolute path for unbundled executables. if (resourcesPath.startsWith(QLatin1Char('/'))) dirs.append(resourcesPath); else dirs.append(bundlePath + resourcesPath); } } const QString localDir = writableLocation(type); dirs.prepend(localDir); return dirs; } #ifndef QT_BOOTSTRAPPED QString QStandardPaths::displayName(StandardLocation type) { if (QStandardPaths::HomeLocation == type) return QCoreApplication::translate("QStandardPaths", "Home"); FSRef ref; OSErr err = FSFindFolder(kOnAppropriateDisk, translateLocation(type), false, &ref); if (err) return QString(); QCFString displayName; err = LSCopyDisplayNameForRef(&ref, &displayName); if (err) return QString(); return static_cast(displayName); } #endif QT_END_NAMESPACE