Development/Tutorials/KIO Slaves/Hello World - Revision history

Agateau: /* Compile the stuff */ fix typo & use generic way to find Qt include dir

2012-11-20T12:34:19Z

‎Compile the stuff: fix typo & use generic way to find Qt include dir

Jan: Use proper syntax highlighting and remove trailing whitespaces.

2011-07-08T12:52:19Z

Use proper syntax highlighting and remove trailing whitespaces.

Neverendingo: Text replace - "" to ""

2011-06-29T20:52:22Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:44:55Z
Text replace - "<code>" to "<syntaxhighlight lang="text">"

				
				
				
				
			
			← Older revision
			Revision as of 20:44, 29 June 2011
			
Line 96:
Line 96:
  == Compile the stuff ==   == Compile the stuff ==
  Create a new Folder "build":   Create a new Folder "build":
− <code> + <syntaxhighlight lang="text">
  mkdir build   mkdir build
  cd build   cd build
  </code>   </code>
  Run cmake and make   Run cmake and make
− <code> + <syntaxhighlight lang="text">
  cmake ..   cmake ..
  make   make
Line 107:
Line 107:
    
  now you can install it (maybe you should use an experimental setup?)   now you can install it (maybe you should use an experimental setup?)
− <code> + <syntaxhighlight lang="text">
  make install   make install
  </code>   </code>
Line 121:
Line 121:
    
  now you can install it (maybe you should use an experimental setup?)   now you can install it (maybe you should use an experimental setup?)
− <code> + <syntaxhighlight lang="text">
  make install   make install
  </code>   </code>
    
  or if you want to install it to your system:   or if you want to install it to your system:
− <code> + <syntaxhighlight lang="text">
  sudo make install   sudo make install
  </code>   </code>



Neverendingo: Text replace - "" to ""

2011-06-29T20:29:17Z
Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:29, 29 June 2011
			
Line 30:
Line 30:
    
  == hello.h ==   == hello.h ==
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #ifndef HELLO_H   #ifndef HELLO_H
  #define HELLO_H   #define HELLO_H
Line 50:
Line 50:
    
  == hello.cpp ==   == hello.cpp ==
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include "hello.h"   #include "hello.h"
  #include <kdebug.h>     #include <kdebug.h>  





Yecril71pl: /* Test it */ command line access
2010-05-26T21:58:49Z
‎Test it:  command line access

				
				
				
				
			
			← Older revision
			Revision as of 21:58, 26 May 2010
			
Line 144:
Line 144:
    
  = Test it =   = Test it =
  + == in Konqueror ==
  Start kinfocenter, choose hello as protocol. If this is possible, start konqueror, type hello:/// into the URL bar.   Start kinfocenter, choose hello as protocol. If this is possible, start konqueror, type hello:/// into the URL bar.
  + == on the command line ==
  + kioclient 'cat' 'hello:///'



Schmeisser: use cmake and don't do stuff by hand if not needed
2010-01-30T18:52:35Z
use cmake and don't do stuff by hand if not needed

				
				
				
				
			
			← Older revision
			Revision as of 18:52, 30 January 2010
			
Line 95:
Line 95:
    
  == Compile the stuff ==   == Compile the stuff ==
  + Create a new Folder "build":
  + <code>
  + mkdir build
  + cd build
  + </code>
  + Run cmake and make
  + <code>
  + cmake ..
  + make
  + </code>
  + 
  + now you can install it (maybe you should use an experimental setup?)
  + <code>
  + make install
  + </code>
  + 
  + If you should want to do this by hand:
  + 
    g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so     g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so
    
Line 101:
Line 119:
  ''On my system I could fix it by changing -I/usr/local/include to -I/usr/include/qt4''   ''On my system I could fix it by changing -I/usr/local/include to -I/usr/include/qt4''
  == Install the stuff ==   == Install the stuff ==
  + 
  + now you can install it (maybe you should use an experimental setup?)
  + <code>
  + make install
  + </code>
  + 
  + or if you want to install it to your system:
  + <code>
  + sudo make install
  + </code>
  + 
  + Of course you can also do this by hand
  + 
  Find out where your protocols are lying:   Find out where your protocols are lying:
    kde4-config --path services     kde4-config --path services



Tampakrap: add 'kde4-config --path module'
2009-10-31T13:03:39Z
add 'kde4-config --path module'

				
				
				
				
			
			← Older revision
			Revision as of 13:03, 31 October 2009
			
Line 104:
Line 104:
    kde4-config --path services     kde4-config --path services
    /usr/share/kde4/services/     /usr/share/kde4/services/
  + 
  +  kde4-config --path module
  +  /usr/lib64/kde4/
    
    cp kio_hello.so /usr/local/lib/kde4/     cp kio_hello.so /usr/local/lib/kde4/



Icewind at 12:41, 24 August 2009
2009-08-24T12:41:54Z


				
				
				
				
			
			← Older revision
			Revision as of 12:41, 24 August 2009
			
Line 97:
Line 97:
    g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so     g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so
    
− ''this does not complile if the qt headers are not in /usr/local/include + ''this does not complile if the qt headers are not in /usr/local/include''
    
− On my system I could fix it by changing -I/usr/local/include to -I/usr/include/qt4'' + ''On my system I could fix it by changing -I/usr/local/include to -I/usr/include/qt4''
  == Install the stuff ==   == Install the stuff ==
  Find out where your protocols are lying:   Find out where your protocols are lying:



Icewind at 12:40, 24 August 2009
2009-08-24T12:40:36Z


				
				
				
				
			
			← Older revision
			Revision as of 12:40, 24 August 2009
			
Line 97:
Line 97:
    g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so     g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so
    
  + ''this does not complile if the qt headers are not in /usr/local/include
  + 
  + On my system I could fix it by changing -I/usr/local/include to -I/usr/include/qt4''
  == Install the stuff ==   == Install the stuff ==
  Find out where your protocols are lying:   Find out where your protocols are lying:

@@ Line 115: / Line 115: @@
 </syntaxhighlight>
-If you should want to do this by hand:
+If you want to do this by hand:
 <syntaxhighlight lang="bash">
-g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so
+g++ -shared -lkdeui -lkio -lkdecore -fPIC -I$(qmake -query QT_INSTALL_HEADERS) hello.cpp -o kio_hello.so
 </syntaxhighlight>
 == Install the stuff ==

@@ Line 1: / Line 1: @@
 = Understanding =
 A kioslave allows you to represent any kind of storage in a way you want. As an example, the kio_http kioslave loads data from the network over the http (protocol) and shows it rendered as html. Technically, a kioslave is a shared object plus its description. E.g. the imap4 kioslave consist of the following files:
- tweedleburg:/usr/local # find -iname "*imap4*"
+<syntaxhighlight lang="text">
- ./lib/kde4/kio_imap4.so
+tweedleburg:/usr/local # find -iname "*imap4*"
- ./share/kde4/services/imap4.protocol
+./lib/kde4/kio_imap4.so
 = The files =
@@ Line 9: / Line 11: @@
 == CMakeLists.txt ==
-<pre>
+<syntaxhighlight lang="cmake">
 PROJECT( tutorial )
 FIND_PACKAGE(KDE4 REQUIRED)
@@ Line 27: / Line 29: @@
 install(FILES hello.protocol DESTINATION ${SERVICES_INSTALL_DIR})
-</pre>
+</syntaxhighlight>
 == hello.h ==
@@ Line 52: / Line 54: @@
 <syntaxhighlight lang="cpp-qt">
 #include "hello.h"
 #include <kdebug.h>
 #include <kcomponentdata.h>
 extern "C" int KDE_EXPORT kdemain( int argc, char **argv )
-−
+{
    kDebug(7000) << "Entering function";
    KComponentData instance( "kio_hello" );
    if (argc != 4)
+   {
      fprintf( stderr, "Usage: kio_hello protocol domain-socket1 domain-socket2\n");
@@ Line 86: / Line 88: @@
 == hello.protocol ==
- [Protocol]
+<syntaxhighlight lang="text">
- DocPath=kioslave/kio_hello.html
+[Protocol]
- exec=kio_hello
+DocPath=kioslave/kio_hello.html
- input=none
+exec=kio_hello
- output=filesystem
+input=none
- protocol=hello
+output=filesystem
- reading=true
+protocol=hello
 == Compile the stuff ==
 Create a new Folder "build":
-<syntaxhighlight lang="text">
+<syntaxhighlight lang="bash">
 mkdir build
 cd build
 </syntaxhighlight>
 Run cmake and make
-<syntaxhighlight lang="text">
+<syntaxhighlight lang="bash">
 cmake ..
 make
@@ Line 107: / Line 111: @@
 now you can install it (maybe you should use an experimental setup?)
-<syntaxhighlight lang="text">
+<syntaxhighlight lang="bash">
 make install
 </syntaxhighlight>
@@ Line 113: / Line 117: @@
 If you should want to do this by hand:
- g++ -shared -lkdeui -lkio -lkdecore -fPIC -I/usr/local/include hello.cpp -o kio_hello.so
+<syntaxhighlight lang="bash">
 ''this does not complile if the qt headers are not in /usr/local/include''
@@ Line 120: / Line 126: @@
 == Install the stuff ==
-now you can install it (maybe you should use an experimental setup?)
+Now you can install it (maybe you should use an experimental setup?):
-<syntaxhighlight lang="text">
+<syntaxhighlight lang="bash">
 make install
 </syntaxhighlight>
 or if you want to install it to your system:
-<syntaxhighlight lang="text">
+<syntaxhighlight lang="bash">
 sudo make install
 </syntaxhighlight>
-Of course you can also do this by hand
+Of course you can also do this by hand.
 Find out where your protocols are lying:
- kde4-config --path services
+<syntaxhighlight lang="bash">
- /usr/share/kde4/services/
+kde4-config --path services
- kde4-config --path module
+kde4-config --path module
- /usr/lib64/kde4/
+  /usr/lib64/kde4/
- cp kio_hello.so /usr/local/lib/kde4/
+cp kio_hello.so /usr/local/lib/kde4/
- cp kio_hello.so /usr/lib64/kde4/
+cp kio_hello.so /usr/lib64/kde4/
- cp kio_hello.protocol /usr/share/kde4/services/
+cp kio_hello.protocol /usr/share/kde4/services/
 = Test it =
-== in Konqueror ==
+== In Konqueror ==
 Start kinfocenter, choose hello as protocol. If this is possible, start konqueror, type hello:/// into the URL bar.
-== on the command line ==
+== On the command line ==
 kioclient 'cat' 'hello:///'

← Older revision		Revision as of 21:58, 26 May 2010
Line 144:		Line 144:

	= Test it =		= Test it =
		+	== in Konqueror ==
	Start kinfocenter, choose hello as protocol. If this is possible, start konqueror, type hello:/// into the URL bar.		Start kinfocenter, choose hello as protocol. If this is possible, start konqueror, type hello:/// into the URL bar.
		+	== on the command line ==
		+	kioclient 'cat' 'hello:///'