**
** Copyright (c) 2011 Nokia Corporation and/or its subsidiary(-ies).
**
-** Contact: Nokia Corporation (qt-info@nokia.com)
+** Contact: Nokia Corporation (info@qt.nokia.com)
**
-** No Commercial Usage
-**
-** This file contains pre-release code and may not be distributed.
-** You may use this file in accordance with the terms and conditions
-** contained in the Technology Preview License Agreement accompanying
-** this package.
**
** 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 as published by the Free Software
-** Foundation and appearing in the file LICENSE.LGPL included in the
-** packaging of this file. Please review the following information to
-** ensure the GNU Lesser General Public License version 2.1 requirements
-** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+** This file may be used under the terms of the GNU Lesser General Public
+** License version 2.1 as published by the Free Software Foundation and
+** appearing in the file LICENSE.LGPL included in the packaging of this file.
+** Please review the following information to ensure the GNU Lesser General
+** Public License version 2.1 requirements will be met:
+** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
-** rights. These rights are described in the Nokia Qt LGPL Exception
+** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
+** Other Usage
+**
+** Alternatively, this file may be used in accordance with the terms and
+** conditions contained in a signed written agreement between you and Nokia.
+**
** If you have questions regarding the use of this file, please contact
-** Nokia at qt-info@nokia.com.
+** Nokia at info@qt.nokia.com.
**
**************************************************************************/
#include "projectconfiguration.h"
#include "projectexplorer_export.h"
-#include "task.h"
#include <QtCore/QFutureInterface>
#include <QtGui/QWidget>
namespace ProjectExplorer {
-
+class Task;
class BuildConfiguration;
class BuildStepList;
class DeployConfiguration;
class Target;
-/*
-// BuildSteps are the primary way plugin developers can customize
-// how their projects (or projects from other plugins) are build.
-//
-// Building a project, is done by taking the list of buildsteps
-// from the project and calling first init() than run() on them.
-//
-// That means to change the way your project is build, reimplemnt
-// this class and add your Step to the buildStep list of the project.
-//
-// Note: The projects own the buildstep, do not delete them yourself.
-//
-// init() is called in the GUI thread and can be used to query the
-// project for any information you need.
-//
-// run() is run via QtConccurrent in a own thread, if you need an
-// eventloop you need to create it yourself!
-//
-*/
-
class BuildStepConfigWidget;
+// Documentation inside.
class PROJECTEXPLORER_EXPORT BuildStep : public ProjectConfiguration
{
Q_OBJECT
public:
virtual ~BuildStep();
- // This function is run in the gui thread,
- // use it to retrieve any information that you need in run()
virtual bool init() = 0;
- // Reimplement this. This function is called when the target is build.
- // This function is NOT run in the gui thread. It runs in its own thread
- // If you need an event loop, you need to create one.
- // The absolute minimal implementation is:
- // fi.reportResult(true);
virtual void run(QFutureInterface<bool> &fi) = 0;
- // the Widget shown in the target settings dialog for this buildStep
- // ownership is transferred to the caller
virtual BuildStepConfigWidget *createConfigWidget() = 0;
- // if this function returns true, the user can't delete this BuildStep for this target
- // and the user is prevented from changing the order immutable steps are run
- // the default implementation returns false
virtual bool immutable() const;
+ virtual bool runInGuiThread() const;
+ virtual void cancel();
BuildConfiguration *buildConfiguration() const;
DeployConfiguration *deployConfiguration() const;
enum OutputFormat { NormalOutput, ErrorOutput, MessageOutput, ErrorMessageOutput };
enum OutputNewlineSetting { DoAppendNewline, DontAppendNewline };
+ Project *project() const;
signals:
- // Add a task.
void addTask(const ProjectExplorer::Task &task);
- // The string is added to the generated output, usually in the output
- // window.
- // It should be in plain text, with the format in the parameter
void addOutput(const QString &string, ProjectExplorer::BuildStep::OutputFormat format,
- ProjectExplorer::BuildStep::OutputNewlineSetting newlineSetting = DoAppendNewline);
+ ProjectExplorer::BuildStep::OutputNewlineSetting newlineSetting = DoAppendNewline) const;
+
+ void finished();
};
class PROJECTEXPLORER_EXPORT IBuildStepFactory :
BuildStepConfigWidget()
: QWidget()
{}
- virtual void init() = 0;
virtual QString summaryText() const = 0;
+ virtual QString additionalSummaryText() const { return QString(); }
virtual QString displayName() const = 0;
+
signals:
void updateSummary();
+ void updateAdditionalSummary();
};
} // namespace ProjectExplorer