/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** 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 https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #include "debuggersourcepathmappingwidget.h" #include "debuggeractions.h" #include "debuggerengine.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using namespace Utils; namespace Debugger { namespace Internal { class SourcePathMappingModel; enum { SourceColumn, TargetColumn, ColumnCount }; using Mapping = QPair; class DebuggerSourcePathMappingWidget : public QGroupBox { Q_DECLARE_TR_FUNCTIONS(Debugger::Internal::DebuggerSourcePathMappingWidget) public: DebuggerSourcePathMappingWidget(); SourcePathMap sourcePathMap() const; void setSourcePathMap(const SourcePathMap &); private: void slotAdd(); void slotAddQt(); void slotRemove(); void slotCurrentRowChanged(const QModelIndex &,const QModelIndex &); void slotEditSourceFieldChanged(); void slotEditTargetFieldChanged(); void resizeColumns(); void updateEnabled(); QString editSourceField() const; QString editTargetField() const; void setEditFieldMapping(const Mapping &m); int currentRow() const; void setCurrentRow(int r); SourcePathMappingModel *m_model; QTreeView *m_treeView; QPushButton *m_addButton; QPushButton *m_addQtButton; QPushButton *m_removeButton; QLineEdit *m_sourceLineEdit; Utils::PathChooser *m_targetChooser; }; // Qt's various build paths for unpatched versions. QStringList qtBuildPaths() { if (HostOsInfo::isWindowsHost()) { return {"Q:/qt5_workdir/w/s", "C:/work/build/qt5_workdir/w/s", "c:/users/qt/work/qt", "c:/Users/qt/work/install"}; } else if (HostOsInfo::isMacHost()) { return { "/Users/qt/work/qt" }; } else { return { "/home/qt/work/qt" }; } } /*! \class Debugger::Internal::SourcePathMappingModel \brief The SourcePathMappingModel class is a model for the DebuggerSourcePathMappingWidget class. Maintains mappings and a dummy placeholder row for adding new mappings. */ class SourcePathMappingModel : public QStandardItemModel { public: explicit SourcePathMappingModel(QObject *parent); SourcePathMap sourcePathMap() const; void setSourcePathMap(const SourcePathMap &map); Mapping mappingAt(int row) const; bool isNewPlaceHolderAt(int row) { return isNewPlaceHolder(rawMappingAt(row)); } void addMapping(const QString &source, const QString &target) { addRawMapping(source, QDir::toNativeSeparators(target)); } void addNewMappingPlaceHolder() { addRawMapping(m_newSourcePlaceHolder, m_newTargetPlaceHolder); } void setSource(int row, const QString &); void setTarget(int row, const QString &); private: inline bool isNewPlaceHolder(const Mapping &m) const; inline Mapping rawMappingAt(int row) const; void addRawMapping(const QString &source, const QString &target); const QString m_newSourcePlaceHolder; const QString m_newTargetPlaceHolder; }; SourcePathMappingModel::SourcePathMappingModel(QObject *parent) : QStandardItemModel(0, ColumnCount, parent), m_newSourcePlaceHolder(DebuggerSourcePathMappingWidget::tr("")), m_newTargetPlaceHolder(DebuggerSourcePathMappingWidget::tr("")) { QStringList headers; headers.append(DebuggerSourcePathMappingWidget::tr("Source path")); headers.append(DebuggerSourcePathMappingWidget::tr("Target path")); setHorizontalHeaderLabels(headers); } SourcePathMap SourcePathMappingModel::sourcePathMap() const { SourcePathMap rc; const int rows = rowCount(); for (int r = 0; r < rows; ++r) { const Mapping m = mappingAt(r); // Skip placeholders. if (!m.first.isEmpty() && !m.second.isEmpty()) rc.insert(m.first.toString(), m.second.toString()); } return rc; } // Check a mapping whether it still contains a placeholder. bool SourcePathMappingModel::isNewPlaceHolder(const Mapping &m) const { const QChar lessThan('<'); const QChar greaterThan('>'); return m.first.isEmpty() || m.first.startsWith(lessThan) || m.first.endsWith(greaterThan) || m.first.toString() == m_newSourcePlaceHolder || m.second.isEmpty() || m.second.startsWith(lessThan) || m.second.endsWith(greaterThan) || m.second.toString() == m_newTargetPlaceHolder; } // Return raw, unfixed mapping Mapping SourcePathMappingModel::rawMappingAt(int row) const { return Mapping(FilePath::fromUserInput(item(row, SourceColumn)->text()), FilePath::fromUserInput(item(row, TargetColumn)->text())); } // Return mapping, empty if it is the place holder. Mapping SourcePathMappingModel::mappingAt(int row) const { const Mapping raw = rawMappingAt(row); return isNewPlaceHolder(raw) ? Mapping() : Mapping(raw.first, raw.second); } void SourcePathMappingModel::setSourcePathMap(const SourcePathMap &m) { removeRows(0, rowCount()); const SourcePathMap::const_iterator cend = m.constEnd(); for (SourcePathMap::const_iterator it = m.constBegin(); it != cend; ++it) addMapping(it.key(), it.value()); } void SourcePathMappingModel::addRawMapping(const QString &source, const QString &target) { QList items; auto sourceItem = new QStandardItem(source); sourceItem->setFlags(Qt::ItemIsEnabled|Qt::ItemIsSelectable); auto targetItem = new QStandardItem(target); targetItem->setFlags(Qt::ItemIsEnabled|Qt::ItemIsSelectable); items << sourceItem << targetItem; appendRow(items); } void SourcePathMappingModel::setSource(int row, const QString &s) { QStandardItem *sourceItem = item(row, SourceColumn); QTC_ASSERT(sourceItem, return); sourceItem->setText(s.isEmpty() ? m_newSourcePlaceHolder : s); } void SourcePathMappingModel::setTarget(int row, const QString &t) { QStandardItem *targetItem = item(row, TargetColumn); QTC_ASSERT(targetItem, return); targetItem->setText(t.isEmpty() ? m_newTargetPlaceHolder : QDir::toNativeSeparators(t)); } /*! \class Debugger::Internal::DebuggerSourcePathMappingWidget \brief The DebuggerSourcePathMappingWidget class is a widget for maintaining a set of source path mappings for the debugger. Path mappings to be applied using source path substitution in GDB. */ DebuggerSourcePathMappingWidget::DebuggerSourcePathMappingWidget() : m_model(new SourcePathMappingModel(this)), m_treeView(new QTreeView(this)), m_addButton(new QPushButton(tr("Add"), this)), m_addQtButton(new QPushButton(tr("Add Qt sources..."), this)), m_removeButton(new QPushButton(tr("Remove"), this)), m_sourceLineEdit(new QLineEdit(this)), m_targetChooser(new PathChooser(this)) { setTitle(tr("Source Paths Mapping")); setToolTip(tr("

Mappings of source file folders to " "be used in the debugger can be entered here.

" "

This is useful when using a copy of the source tree " "at a location different from the one " "at which the modules where built, for example, while " "doing remote debugging.

" "

If source is specified as a regular expression by starting it with an " "open parenthesis, the paths in the ELF are matched with the " "regular expression to automatically determine the source path.

" "

Example: (/home/.*/Project)/KnownSubDir -> D:\\Project will " "substitute ELF built by any user to your local project directory.

")); // Top list/left part. m_treeView->setRootIsDecorated(false); m_treeView->setUniformRowHeights(true); m_treeView->setSelectionMode(QAbstractItemView::SingleSelection); m_treeView->setSelectionBehavior(QAbstractItemView::SelectRows); m_treeView->setModel(m_model); connect(m_treeView->selectionModel(), &QItemSelectionModel::currentRowChanged, this, &DebuggerSourcePathMappingWidget::slotCurrentRowChanged); // Top list/Right part: Buttons. auto buttonLayout = new QVBoxLayout; buttonLayout->addWidget(m_addButton); buttonLayout->addWidget(m_addQtButton); m_addQtButton->setVisible(!qtBuildPaths().isEmpty()); m_addQtButton->setToolTip(tr("

Add a mapping for Qt's source folders " "when using an unpatched version of Qt.")); buttonLayout->addWidget(m_removeButton); connect(m_addButton, &QAbstractButton::clicked, this, &DebuggerSourcePathMappingWidget::slotAdd); connect(m_addQtButton, &QAbstractButton::clicked, this, &DebuggerSourcePathMappingWidget::slotAddQt); connect(m_removeButton, &QAbstractButton::clicked, this, &DebuggerSourcePathMappingWidget::slotRemove); buttonLayout->addItem(new QSpacerItem(0, 0, QSizePolicy::Ignored, QSizePolicy::MinimumExpanding)); // Assemble top auto treeHLayout = new QHBoxLayout; treeHLayout->addWidget(m_treeView); treeHLayout->addLayout(buttonLayout); // Edit part m_targetChooser->setExpectedKind(PathChooser::ExistingDirectory); m_targetChooser->setHistoryCompleter("Debugger.MappingTarget.History"); connect(m_sourceLineEdit, &QLineEdit::textChanged, this, &DebuggerSourcePathMappingWidget::slotEditSourceFieldChanged); connect(m_targetChooser, &PathChooser::pathChanged, this, &DebuggerSourcePathMappingWidget::slotEditTargetFieldChanged); auto editLayout = new QFormLayout; const QString sourceToolTip = tr("

The source path contained in the " "debug information of the executable as reported by the debugger"); auto editSourceLabel = new QLabel(tr("&Source path:")); editSourceLabel->setToolTip(sourceToolTip); m_sourceLineEdit->setToolTip(sourceToolTip); editSourceLabel->setBuddy(m_sourceLineEdit); editLayout->addRow(editSourceLabel, m_sourceLineEdit); const QString targetToolTip = tr("

The actual location of the source " "tree on the local machine"); auto editTargetLabel = new QLabel(tr("&Target path:")); editTargetLabel->setToolTip(targetToolTip); editTargetLabel->setBuddy(m_targetChooser); m_targetChooser->setToolTip(targetToolTip); editLayout->addRow(editTargetLabel, m_targetChooser); editLayout->setFieldGrowthPolicy(QFormLayout::ExpandingFieldsGrow); auto chooser = new VariableChooser(this); chooser->addSupportedWidget(m_targetChooser->lineEdit()); // Main layout auto mainLayout = new QVBoxLayout; mainLayout->addLayout(treeHLayout); mainLayout->addLayout(editLayout); setLayout(mainLayout); updateEnabled(); } QString DebuggerSourcePathMappingWidget::editSourceField() const { return QDir::cleanPath(m_sourceLineEdit->text().trimmed()); } QString DebuggerSourcePathMappingWidget::editTargetField() const { return m_targetChooser->rawPath(); } void DebuggerSourcePathMappingWidget::setEditFieldMapping(const Mapping &m) { m_sourceLineEdit->setText(m.first.toUserOutput()); m_targetChooser->setFilePath(m.second); } void DebuggerSourcePathMappingWidget::slotCurrentRowChanged (const QModelIndex ¤t, const QModelIndex &) { setEditFieldMapping(current.isValid() ? m_model->mappingAt(current.row()) : Mapping()); updateEnabled(); } void DebuggerSourcePathMappingWidget::resizeColumns() { m_treeView->resizeColumnToContents(SourceColumn); } void DebuggerSourcePathMappingWidget::updateEnabled() { // Allow for removing the current item. const int row = currentRow(); const bool hasCurrent = row >= 0; m_sourceLineEdit->setEnabled(hasCurrent); m_targetChooser->setEnabled(hasCurrent); m_removeButton->setEnabled(hasCurrent); // Allow for adding only if the current item no longer is the place // holder for new items. const bool canAdd = !hasCurrent || !m_model->isNewPlaceHolderAt(row); m_addButton->setEnabled(canAdd); m_addQtButton->setEnabled(canAdd); } SourcePathMap DebuggerSourcePathMappingWidget::sourcePathMap() const { return m_model->sourcePathMap(); } void DebuggerSourcePathMappingWidget::setSourcePathMap(const SourcePathMap &m) { m_model->setSourcePathMap(m); if (!m.isEmpty()) resizeColumns(); } int DebuggerSourcePathMappingWidget::currentRow() const { const QModelIndex index = m_treeView->selectionModel()->currentIndex(); return index.isValid() ? index.row() : -1; } void DebuggerSourcePathMappingWidget::setCurrentRow(int r) { m_treeView->selectionModel()->setCurrentIndex(m_model->index(r, 0), QItemSelectionModel::ClearAndSelect |QItemSelectionModel::Current |QItemSelectionModel::Rows); } void DebuggerSourcePathMappingWidget::slotAdd() { m_model->addNewMappingPlaceHolder(); setCurrentRow(m_model->rowCount() - 1); } void DebuggerSourcePathMappingWidget::slotAddQt() { // Add a mapping for various Qt build locations in case of unpatched builds. const FilePath qtSourcesPath = FileUtils::getExistingDirectory(this, tr("Qt Sources")); if (qtSourcesPath.isEmpty()) return; for (const QString &buildPath : qtBuildPaths()) m_model->addMapping(buildPath, qtSourcesPath.toString()); resizeColumns(); setCurrentRow(m_model->rowCount() - 1); } void DebuggerSourcePathMappingWidget::slotRemove() { const int row = currentRow(); if (row >= 0) m_model->removeRow(row); } void DebuggerSourcePathMappingWidget::slotEditSourceFieldChanged() { const int row = currentRow(); if (row >= 0) { m_model->setSource(row, editSourceField()); updateEnabled(); } } void DebuggerSourcePathMappingWidget::slotEditTargetFieldChanged() { const int row = currentRow(); if (row >= 0) { m_model->setTarget(row, editTargetField()); updateEnabled(); } } // Find Qt installation by running qmake static QString findQtInstallPath(const FilePath &qmakePath) { if (qmakePath.isEmpty()) return QString(); QtcProcess proc; proc.setCommand({qmakePath, {"-query", "QT_INSTALL_HEADERS"}}); proc.start(); if (!proc.waitForStarted()) { qWarning("%s: Cannot start '%s': %s", Q_FUNC_INFO, qPrintable(qmakePath.toString()), qPrintable(proc.errorString())); return QString(); } if (!proc.waitForFinished()) { proc.stopProcess(); qWarning("%s: Timeout running '%s'.", Q_FUNC_INFO, qPrintable(qmakePath.toString())); return QString(); } if (proc.exitStatus() != QProcess::NormalExit) { qWarning("%s: '%s' crashed.", Q_FUNC_INFO, qPrintable(qmakePath.toString())); return QString(); } const QByteArray ba = proc.readAllStandardOutput().trimmed(); QDir dir(QString::fromLocal8Bit(ba)); if (dir.exists() && dir.cdUp()) return dir.absolutePath(); return QString(); } /* Merge settings for an installed Qt (unless another setting is already in the map. */ SourcePathMap mergePlatformQtPath(const DebuggerRunParameters &sp, const SourcePathMap &in) { const FilePath qmake = BuildableHelperLibrary::findSystemQt(sp.inferior.environment); // FIXME: Get this from the profile? // We could query the QtVersion for this information directly, but then we // will need to add a dependency on QtSupport to the debugger. // // The profile could also get a function to extract the required information from // its information to avoid this dependency (as we do for the environment). const QString qtInstallPath = findQtInstallPath(qmake); if (qtInstallPath.isEmpty()) return in; SourcePathMap rc = in; for (const QString &buildPath : qtBuildPaths()) { if (!rc.contains(buildPath)) // Do not overwrite user settings. rc.insert(buildPath, qtInstallPath + "/../Src"); } return rc; } // // SourcePathMapAspect // class SourcePathMapAspectPrivate { public: QPointer m_widget; }; SourcePathMapAspect::SourcePathMapAspect() : d(new SourcePathMapAspectPrivate) { } SourcePathMapAspect::~SourcePathMapAspect() { delete d; } void SourcePathMapAspect::fromMap(const QVariantMap &) { QTC_CHECK(false); // This is only used via read/writeSettings } void SourcePathMapAspect::toMap(QVariantMap &) const { QTC_CHECK(false); } void SourcePathMapAspect::addToLayout(LayoutBuilder &builder) { QTC_CHECK(!d->m_widget); d->m_widget = createSubWidget(); d->m_widget->setSourcePathMap(value()); builder.addRow(d->m_widget.data()); } QVariant SourcePathMapAspect::volatileValue() const { QTC_CHECK(!isAutoApply()); QTC_ASSERT(d->m_widget, return {}); return QVariant::fromValue(d->m_widget->sourcePathMap()); } void SourcePathMapAspect::setVolatileValue(const QVariant &val) { QTC_CHECK(!isAutoApply()); if (d->m_widget) d->m_widget->setSourcePathMap(val.value()); } const char sourcePathMappingArrayNameC[] = "SourcePathMappings"; const char sourcePathMappingSourceKeyC[] = "Source"; const char sourcePathMappingTargetKeyC[] = "Target"; SourcePathMap SourcePathMapAspect::value() const { return BaseAspect::value().value(); } void SourcePathMapAspect::writeSettings(QSettings *s) const { const SourcePathMap sourcePathMap = value(); s->beginWriteArray(sourcePathMappingArrayNameC); if (!sourcePathMap.isEmpty()) { const QString sourcePathMappingSourceKey(sourcePathMappingSourceKeyC); const QString sourcePathMappingTargetKey(sourcePathMappingTargetKeyC); int i = 0; for (auto it = sourcePathMap.constBegin(), cend = sourcePathMap.constEnd(); it != cend; ++it, ++i) { s->setArrayIndex(i); s->setValue(sourcePathMappingSourceKey, it.key()); s->setValue(sourcePathMappingTargetKey, it.value()); } } s->endArray(); } void SourcePathMapAspect::readSettings(const QSettings *settings) { // Eeks. But legitimate, this operates on ICore::settings(); QSettings *s = const_cast(settings); SourcePathMap sourcePathMap; if (const int count = s->beginReadArray(sourcePathMappingArrayNameC)) { const QString sourcePathMappingSourceKey(sourcePathMappingSourceKeyC); const QString sourcePathMappingTargetKey(sourcePathMappingTargetKeyC); for (int i = 0; i < count; ++i) { s->setArrayIndex(i); const QString key = s->value(sourcePathMappingSourceKey).toString(); const QString value = s->value(sourcePathMappingTargetKey).toString(); sourcePathMap.insert(key, value); } } s->endArray(); setValue(QVariant::fromValue(sourcePathMap)); } } // namespace Internal } // namespace Debugger