Mbarcode Plugin Tutorial - Revision history

81.217.39.232 at 09:58, 14 June 2011

2011-06-14T09:58:31Z

← Older revision		Revision as of 09:58, 14 June 2011
Line 216:		Line 216:
	qmake && make		qmake && make

-	Go to your directory and pick up the new file named <code>libmbarcode_myplugin.so</code>. Copy this to your device and place it in <code>/home/user/.config/mbarcode/plugins</code>.	+	Go to your directory and pick up the new file named <code>libmbarcode_myplugin.so</code>. Copy this to your device and place it in <code>/home/user/.config/mbarcode/plugins</code>. (Note: final plugins are stored in <code>/usr/share/mbarcode/plugins</code>. The former path with .config didn't work for me).

	Start mBarcode and scan a barcode as usual. Your plugin should now show up.		Start mBarcode and scan a barcode as usual. Your plugin should now show up.

spartan563: /* Prerequisites */

2011-05-20T23:12:49Z

Prerequisites

← Older revision		Revision as of 23:12, 20 May 2011
Line 19:		Line 19:
	* Qt Creator		* Qt Creator

-	Using [[MADDE]] for development is currently a bit of a pain since it lacks an option for third party libraries. ~~This might be unnecessary for plugins, but MADDE~~ is ~~in any case not covered by this~~ tutorial ~~as of yet.~~	+	Using [[MADDE]] for development is currently a bit of a pain since it lacks an option for third party libraries. There is a tutorial that covers writing these plugins using the Nokia Qt SDK available here [[Mbarcode_Plugin_Tutorial_MADDE]]

	== Writing the plugin ==		== Writing the plugin ==

dragly: /* Plugin interface */

2011-01-12T21:59:06Z

Plugin interface

← Older revision		Revision as of 21:59, 12 January 2011
Line 144:		Line 144:

	<source lang="cpp">		<source lang="cpp">
		+	// This is a plugin used as an example in different tutorials.
		+
	#ifndef PLUGIN_H		#ifndef PLUGIN_H
	#define PLUGIN_H		#define PLUGIN_H

dragly: /* The plugin actions */

2011-01-12T21:58:19Z

The plugin actions

← Older revision		Revision as of 21:58, 12 January 2011
Line 76:		Line 76:
	#define SHOWDIALOGACTION_H		#define SHOWDIALOGACTION_H

		+	#include <QtCore>
	#include <mbarcode-qt/plugininterfaces.h>		#include <mbarcode-qt/plugininterfaces.h>
	#include <mbarcode-qt/pluginaction.h>		#include <mbarcode-qt/pluginaction.h>

-	class ShowDialogAction : ~~public QObject,~~ public PluginAction	+	class ShowDialogAction : public PluginAction
	{		{
	Q_OBJECT		Q_OBJECT
	public:		public:
	ShowDialogAction(const PluginInterface *interface);		ShowDialogAction(const PluginInterface *interface);
-		+	QString getName() { return "EAN Local Analyser"; } // This name is just for convenience
-	QString getName() { return "~~My Plugin Action~~"; } // This name is just for convenience	+
	QString getText(); // This is the text that will show in the list		QString getText(); // This is the text that will show in the list
-	~~bool isReady() { return ready; } // Tells the list wether this plugin is ready to be shown or not~~
	void clickAction(QWidget *parentWindow); // The action which is called whenever we are clicked		void clickAction(QWidget *parentWindow); // The action which is called whenever we are clicked
-		+	signals:
		+	void isReady();
	private slots:		private slots:
	void barcodeAnalysed(QString barcodeType, QString barcodeData); // The slot where all the processing goes down		void barcodeAnalysed(QString barcodeType, QString barcodeData); // The slot where all the processing goes down
-
	private:		private:
-	~~bool ready;~~
	QString barcodeType;		QString barcodeType;
	QString barcodeData;		QString barcodeData;
	};		};
		+
		+	//Q_DECLARE_METATYPE(ShowDialogAction *);

	#endif // SHOWDIALOGACTION_H		#endif // SHOWDIALOGACTION_H
Line 112:		Line 112:
	{		{
	// Do your initialization here.		// Do your initialization here.
-	~~// Remember to set ready to false.~~
-	~~// This keeps the plugin from appearing in the list before it is ready~~
-
-	~~ready = false;~~
	}		}
-
	QString ShowDialogAction::getText() {		QString ShowDialogAction::getText() {
	// This is the text which will show in the list of results.		// This is the text which will show in the list of results.
-
	return "Show Dialog";		return "Show Dialog";
	}		}
-
	void ShowDialogAction::clickAction(QWidget* parentWindow)		void ShowDialogAction::clickAction(QWidget* parentWindow)
	{		{
	// This is what happens when the user clicks our button.		// This is what happens when the user clicks our button.
-	~~// In this example we only show a message box~~	+	QMessageBox msg(parentWindow);
-		+	msg.setWindowTitle("You clicked the button!");
-	~~QMessageBox *msgBox = new~~ QMessageBox(parentWindow);	+	msg.setText("A window should be a dynamic object. Otherwise it is removed at the end of this function. A message box, on the other hand, has the exec().");
-	~~msgBox->~~setWindowTitle("~~My Plugin~~");	+	msg.exec();
-	~~msgBox->~~setText("~~The barcode was~~ of ~~type " + barcodeType + " and contained~~ the ~~data~~ " ~~+ barcodeData~~);	+
-	~~msgBox->~~exec();	+
	}		}
-
	void ShowDialogAction::barcodeAnalysed(QString barcodeType, QString barcodeData) {		void ShowDialogAction::barcodeAnalysed(QString barcodeType, QString barcodeData) {
-
	// In this function you process the data. This could be used for early web lookups or whatever.		// In this function you process the data. This could be used for early web lookups or whatever.
	// We just store the data in memory for now.		// We just store the data in memory for now.
-
	this->barcodeType = barcodeType;		this->barcodeType = barcodeType;
	this->barcodeData = barcodeData;		this->barcodeData = barcodeData;
-
	// We've done what we need to and are ready to show ourselves		// We've done what we need to and are ready to show ourselves
-		+	emit isReady();
-	~~ready = true~~;	+
	}		}
	</source>		</source>

amigadave: wikify, use

2010-07-12T07:34:08Z

wikify, use <source>

← Older revision		Revision as of 07:34, 12 July 2010
Line 1:		Line 1:
-	This tutorial will give you a quick introduction to writing plugins for mBarcode. We will try to guide you from your very first steps all the way to a full fledged plugin.	+	This tutorial will give you a quick introduction to writing plugins for [[mBarcode]]. We will try to guide you from your very first steps all the way to a full fledged plugin.

	The plugin we are going to create will show a quick dialog with info about the data contained in the barcode.		The plugin we are going to create will show a quick dialog with info about the data contained in the barcode.

-	= Prerequisites =	+	== Prerequisites ==

	In this tutorial we'll be using Qt together with C++ to connect to the mBarcode plugin framework. To make the process very easy we are also using Qt Creator to write our code and Scratchbox to test and compile it. You don't have to use Scratchbox or Qt Creator if you don't want to, but this is not covered by this tutorial.		In this tutorial we'll be using Qt together with C++ to connect to the mBarcode plugin framework. To make the process very easy we are also using Qt Creator to write our code and Scratchbox to test and compile it. You don't have to use Scratchbox or Qt Creator if you don't want to, but this is not covered by this tutorial.
Line 19:		Line 19:
	* Qt Creator		* Qt Creator

-	Using MADDE for development is currently a bit of a pain since it lacks an option for third party libraries. This might be unnecessary for plugins, but MADDE is in any case not covered by this tutorial as of yet.	+	Using [[MADDE]] for development is currently a bit of a pain since it lacks an option for third party libraries. This might be unnecessary for plugins, but MADDE is in any case not covered by this tutorial as of yet.

-	= Writing the plugin =	+	== Writing the plugin ==

	Using Scratchbox is the easiest way to get started. Log in to Scratchbox by typing		Using Scratchbox is the easiest way to get started. Log in to Scratchbox by typing

-	~~<pre>~~/scratchbox/login~~</pre>~~	+	/scratchbox/login

-	Install the mbarcode-dev package	+	Install the <code>mbarcode-dev</code> package

-	~~<pre>~~apt-get install mbarcode-dev~~</pre>~~	+	apt-get install mbarcode-dev

-	Next, create a new "Empty Qt project" using Qt Creator and store this in /scratchbox/users/<your username>/home/<your username>/. For the sake of simplicity, we'll name our project "plugin".	+	Next, create a new "Empty Qt project" using Qt Creator and store this in <code>/scratchbox/users/<your username>/home/<your username>/</code>. For the sake of simplicity, we'll name our project "plugin".

	Alternatively, create an empty folder using the terminal and add an empty plugin.pro file.		Alternatively, create an empty folder using the terminal and add an empty plugin.pro file.

-	== The project file ==	+	=== The project file ===

	Add the following to your plugin.pro file:		Add the following to your plugin.pro file:
Line 66:		Line 66:
	</pre>		</pre>

-	== The plugin actions ==	+	=== The plugin actions ===

-	Let's add some actions for our plugin! In Qt Creator, right click on your project and select "Add New...". Choose "C++ Class" and name it "ShowDialogAction".	+	Let's add some actions for our plugin! In Qt Creator, right click on your project and select "Add New...". Choose "C++ Class" and name it <code>ShowDialogAction</code>.

-	Open the showdialogaction.h file and overwrite it with the following:	+	Open the <code>showdialogaction.h</code> file and overwrite it with the following:

-	<~~pre~~>	+	<source lang="cpp">
	#ifndef SHOWDIALOGACTION_H		#ifndef SHOWDIALOGACTION_H
	#define SHOWDIALOGACTION_H		#define SHOWDIALOGACTION_H
Line 100:		Line 100:

	#endif // SHOWDIALOGACTION_H		#endif // SHOWDIALOGACTION_H
-	</~~pre~~>	+	</source>

-	Open the showdialogaction.cpp file and overwrite it with the following:	+	Open the <code>showdialogaction.cpp</code> file and overwrite it with the following:

-	<~~pre~~>	+	<source lang="cpp">
	#include "showdialogaction.h"		#include "showdialogaction.h"

Line 147:		Line 147:
	ready = true;		ready = true;
	}		}
-	</~~pre~~>	+	</source>

	You could add more classes like this if you want different buttons with different actions, but for now, this will do.		You could add more classes like this if you want different buttons with different actions, but for now, this will do.

-	== Plugin interface ==	+	=== Plugin interface ===

-	Let's connect to mBarcode's plugin interface. In Qt Creator, right click on your project and select "Add New...". Choose "C++ Class" and name it "Plugin".	+	Let's connect to mBarcode's plugin interface. In Qt Creator, right click on your project and select "Add New...". Choose "C++ Class" and name it <code>Plugin</code>.

-	Open your plugin.h file and overwrite it with the following:	+	Open your <code>plugin.h</code> file and overwrite it with the following:

-	<~~pre~~>	+	<source lang="cpp">
	#ifndef PLUGIN_H		#ifndef PLUGIN_H
	#define PLUGIN_H		#define PLUGIN_H
Line 183:		Line 183:

	#endif // PLUGIN_H		#endif // PLUGIN_H
-	</~~pre~~>	+	</source>

-	Open your plugin.cpp file and add the following:	+	Open your <code>plugin.cpp</code> file and add the following:

-	<~~pre~~>	+	<source lang="cpp">
	#include "plugin.h"		#include "plugin.h"
	#include "showdialogaction.h"		#include "showdialogaction.h"
Line 218:		Line 218:

	Q_EXPORT_PLUGIN2(mbqt_myplugin, Plugin) // Please change this name		Q_EXPORT_PLUGIN2(mbqt_myplugin, Plugin) // Please change this name
-	</~~pre~~>	+	</source>

-	== Testing your fancy new plugin ==	+	=== Testing your fancy new plugin ===

-	There you go! You are now ready to build your plugin and test it out. Before we build a complete ~~debian~~ package, let's see if everything works.	+	There you go! You are now ready to build your plugin and test it out. Before we build a complete Debian package, let's see if everything works.

	Build your plugin by issuing this command in your project folder in Scratchbox:		Build your plugin by issuing this command in your project folder in Scratchbox:
-	~~<pre>~~	+
-	qmake && make	+	qmake && make
-	~~</pre>~~	+
-	Go to your directory and pick up the new file named "libmbarcode_myplugin.so". Copy this to your device and place it in /home/user/.config/mbarcode/plugins.	+	Go to your directory and pick up the new file named <code>libmbarcode_myplugin.so</code>. Copy this to your device and place it in <code>/home/user/.config/mbarcode/plugins</code>.

	Start mBarcode and scan a barcode as usual. Your plugin should now show up.		Start mBarcode and scan a barcode as usual. Your plugin should now show up.

-	=== Troubleshooting ===	+	==== Troubleshooting ====

	If your plugin doesn't load, please run mbarcode from terminal and look for error messages during the loading of the application.		If your plugin doesn't load, please run mbarcode from terminal and look for error messages during the loading of the application.

-	= Creating a ~~debian~~ package =	+	== Creating a Debian package ==

	To be continued...		To be continued...

-	[[Category:~~Software~~]]	+	[[Category:Development]]
	[[Category:mBarcode]]		[[Category:mBarcode]]

dragly at 15:16, 8 July 2010

2010-07-08T15:16:48Z

← Older revision		Revision as of 15:16, 8 July 2010
Line 239:		Line 239:

	To be continued...		To be continued...
		+
		+	[[Category:Software]]
		+	[[Category:mBarcode]]

dragly: /* The project file */

2010-07-08T15:13:22Z

The project file

← Older revision		Revision as of 15:13, 8 July 2010
Line 42:		Line 42:
	TEMPLATE = lib		TEMPLATE = lib
	CONFIG += plugin		CONFIG += plugin
-	INCLUDEPATH += ../..	+	INCLUDEPATH += ../..

-	HEADERS = plugin.h	+	HEADERS = plugin.h \
-	SOURCES = plugin.cpp	+	showdialogaction.h
-	TARGET = $$qtLibraryTarget(~~mbarcode_isbnplugin~~)	+	SOURCES = plugin.cpp \
		+	showdialogaction.cpp
		+	TARGET = $$qtLibraryTarget(mbarcode_myplugin)

-	unix {	+	unix {
	# VARIABLES		# VARIABLES
	isEmpty(PREFIX):PREFIX = /usr		isEmpty(PREFIX):PREFIX = /usr
Line 55:		Line 57:
	DEFINES += DATADIR=\"$$DATADIR\" \		DEFINES += DATADIR=\"$$DATADIR\" \
	PKGDATADIR=\"$$PKGDATADIR\"		PKGDATADIR=\"$$PKGDATADIR\"
-		+
	# MAKE INSTALL		# MAKE INSTALL
	INSTALLS += target		INSTALLS += target

dragly: /* Prerequisites */

2010-07-08T15:12:54Z

Prerequisites

← Older revision		Revision as of 15:12, 8 July 2010
Line 19:		Line 19:
	* Qt Creator		* Qt Creator

-	Using MADDE for development is currently a bit of a pain since it lacks ~~the~~ option for third party libraries. This might be unnecessary for plugins, but MADDE is in any case not covered by this tutorial yet.	+	Using MADDE for development is currently a bit of a pain since it lacks an option for third party libraries. This might be unnecessary for plugins, but MADDE is in any case not covered by this tutorial as of yet.

	= Writing the plugin =		= Writing the plugin =

dragly at 15:12, 8 July 2010

2010-07-08T15:12:13Z

← Older revision		Revision as of 15:12, 8 July 2010
Line 21:		Line 21:
	Using MADDE for development is currently a bit of a pain since it lacks the option for third party libraries. This might be unnecessary for plugins, but MADDE is in any case not covered by this tutorial yet.		Using MADDE for development is currently a bit of a pain since it lacks the option for third party libraries. This might be unnecessary for plugins, but MADDE is in any case not covered by this tutorial yet.

-	= ~~First steps~~ =	+	= Writing the plugin =

	Using Scratchbox is the easiest way to get started. Log in to Scratchbox by typing		Using Scratchbox is the easiest way to get started. Log in to Scratchbox by typing
Line 234:		Line 234:
	If your plugin doesn't load, please run mbarcode from terminal and look for error messages during the loading of the application.		If your plugin doesn't load, please run mbarcode from terminal and look for error messages during the loading of the application.

-	=~~= Buildling it into~~ a ~~deb~~ package ==	+	= Creating a debian package =

	To be continued...		To be continued...

dragly at 15:11, 8 July 2010

2010-07-08T15:11:23Z

← Older revision		Revision as of 15:11, 8 July 2010
Line 1:		Line 1:
-	This tutorial will give you a quick introduction to writing plugins for mBarcode. We will try to guide you from your very first steps all the way to a full fledged plugin. ~~Our~~ plugin will ~~use 1D codes and do~~ a ~~search for these on~~ the ~~web. It will show~~ the ~~results in a window of its own~~.	+	This tutorial will give you a quick introduction to writing plugins for mBarcode. We will try to guide you from your very first steps all the way to a full fledged plugin.
		+
		+	The plugin we are going to create will show a quick dialog with info about the data contained in the barcode.

	= Prerequisites =		= Prerequisites =