http___qt-project.org_wiki_Temel_Qt_Programlama_Egitimi_1.xml
1.1 2.1 3.1 4.1 4.2 4.3 5.1 6.1 6.2 6.3 7.1 8.1 9.1 10.1 11.1 12.1 13.1 14.1 16.1 17.1 18.1 20.1 21.1 22.1 23.1 25.1 26.1 27.1 28.1 29.1 30.1 31.1 31.2 31.3 32.1 33.1 34.1 34.2 34.3 35.1 35.2 35.3 36.1 37.1 38.1 39.1 40.1 40.2 41.1 42.1 43.1 44.1 45.1 46.1 47.1 48.1 50.1 51.1 54.1 56.1 57.1 58.1 58.2 58.3 59.1 60.1 61.1 62.1 63.1 64.1 65.1 66.1 67.1 68.1 68.2 69.1 69.2 69.3 70.1 71.1 72.1 73.1 74.1 75.1 76.1 77.1 78.1 79.1 80.1 81.1 82.1 83.1 84.1 85.1 86.1 87.1 90.1 92.1 93.1 93.2 93.3 94.1 95.1 96.1 98.1 99.1 100.1 101.1 102.1 103.1 104.1 105.1 106.1 107.1 108.1 109.1 110.1 111.1 113.1 115.1 116.1 116.2 117.1 118.1 119.1 120.1 121.1 122.1 123.1 124.1 125.1 126.1 127.1 128.1 129.1 130.1 131.1 132.1 133.1 134.1 135.1 136.1 138.1 139.1 142.1 144.1 145.1 145.2 145.3 145.4 146.1 146.2 146.3 146.4
Table of Content How to create a library with Qt and use it in an application Introduction This tutorial illustrates different approaches for using a custom library in your application on Windows. The first part explains how to create a shared library and how to link against it in your application. The second part is about creating and using a static library. Creating a shared library When creating a shared library that you would like to link against, then you need to ensure that the symbols that are going to be used outside the library are properly exported when the library is created. Subsequently imported when you are linking against the library. This can be done using Q_DECL_EXPORT [qt-project.org] and Q_DECL_IMPORT [qt-project.org] as shown in the following example: test.h - #include - #if defined TEST - #define TEST_COMMON_DLLSPEC Q_DECL_EXPORT - #else - #define TEST_COMMON_DLLSPEC Q_DECL_IMPORT - #endif - class TEST_COMMON_DLLSPEC Widget : public QWidget - Q_OBJECT - public: - Widget(); test.cpp - #include - #include "test.h" - Widget::Widget() : QWidget() test.pro - TEMPLATE = lib - # Input - SOURCES += test.cpp - HEADERS+= test.h - DEFINES += TEST In windows, MinGW will output .a and .dll, MSVC2010 will ouput .lib and .dll. In linux, MinGW will output .so, .so.1, .so.1.0 and .so.1.0.0 – .lib, .a and .so are import libraries. They help link your code to the library and is needed when you build your file(.a files not all the time). See also the documentation on Creating Shared Libraries [qt-project.org]. Linking your application against the shared library In order to use the shared library in your application, then you can include the headers of your library in your code and use the methods. Compile with linking to the .lib file. At runtime this loads the dll which has the implementation. To set this up, then in your application’s .pro file you need to inform the application where to find the headers and the library. The INCLUDEPATH [qt-project.org] needs to point to the directory where the headers are installed, and the LIBS [qt-project.org] variable needs to point to the directory of the .lib file. In addition you need to ensure that the .dll is found by either putting it in the application’s directory or in the global PATH. For example: loadTestLib.pro - TEMPLATE = app - TARGET = - DEPENDPATH += . ../testLib - INCLUDEPATH += ../testLib - LIBS+= -L../testLib/debug -ltestLib - # Input - SOURCES += main.cpp main.cpp - #include - #include "test.h" - int main(int argc, char *argv[]) - QApplication a(argc, argv); - Widget w; - return a.exec(); alternatively you can right-click your project in Qt Creator and select “Add Library…”, choose External library and browse for your library file: - For libraries compiled with MSCV2010 compiler in windows, you look for .lib - in Windows, MinGW compiled linking libraries are in .a, but you will need to add it manually(as of Qt Creator 2.7). You could also try simply linking the .dll directly cause it would probably work. Don’t try this with a MSCV2010 compiled library. - in linux you look for the .so file This will append the following code to your *.pro file: - win32:CONFIG(release, debug|release): LIBS += -L$$PWD/build-MyLibrary/-lmylibrary - else:win32:CONFIG(debug, debug|release): LIBS +=-L$$PWD/build-MyLibrary/ -lmylibrary - else:unix: LIBS += -L$$PWD/build-MyLibrary/ -lMyLibrary - INCLUDEPATH += $$PWD/build-MyLibrary - DEPENDPATH += $$PWD/build-MyLibrary Note that for unix/linux systems the library file name is case sensitive, but for windows you have to leave in all small caps. Using QLibrary to load the shared library QLibrary [qt-project.org] can be used for loading shared libraries at runtime. In this case you only need access to the .dll, access to the headers and .lib file(s) is not necessary. The following example shows how to set up a library for usage with QLibrary. For the function names to be resolvable, they must be exported as C functions (i.e., without name mangling) from the library. This means that the functions must be wrapped in an extern “C” block if the library is compiled with a C++ compiler. Since we are doing this on Windows we also must explicitly export the function from the DLL using Q_DECL_EXPORT [qt-project.org] and Q_DECL_IMPORT [qt-project.org] qlibraryLibrary.pro - TEMPLATE = lib - HEADERS += widget.h - SOURCES += widget.cpp - DEFINES += TEST widget.h - #include - #if defined TEST - #define TEST_COMMON_DLLSPEC Q_DECL_EXPORT - #else - #define TEST_COMMON_DLLSPEC Q_DECL_IMPORT - #endif - extern "C" TEST_COMMON_DLLSPEC QWidget* createWidget1(); widget.cpp - #include - #include "widget.h" - QWidget* createWidget1() - return wid; Loading the library using QLibrary To load the library using QLibrary, you can simply pass in the .dll to the QLibrary constructor. Make sure the .dll is available in the application directory or in the global PATH. To use functions from the library in your application, you need to resolve them using QLibrary::resolve() [qt-project.org]. The example below loads the library created above and uses one of its functions to create and show a widget. - #include - int main(int argc, char **argv) - QApplication app(argc, argv); - QLibrary library("qlibraryLibrary.dll"); - if (!library.load()) - qDebug() << library.errorString(); - if (library.load()) - qDebug() << "library loaded"; - typedef QWidget*(*CreateWidgetFunction)(void); - CreateWidgetFunction cwf = (CreateWidgetFunction)library.resolve("createWidget1"); - if (cwf) { - QWidget* wid = cwf(); - if (wid) - wid->show(); - } else { - qDebug() << "Could not show widget from the loaded library"; - return app.exec(); Creating a static library When creating a static library you need to specify the staticlib option to CONFIG [qt-project.org] in the .pro file. In contrast to the shared library example, you don’t need to set up anything special for exporting and importing symbols in your .h file, since the library will be built into the application, for example: test.pro - TEMPLATE = lib - CONFIG+= staticlib - # Input - HEADERS += test.h - SOURCES += test.cpp Using the static library in your application Similar to what we did for the shared library loading, you need to set up the INCLUDEPATH [qt-project.org] to point to the directory where the headers are installed and the LIBS [qt-project.org] variable to point to the .lib file, for example: useStaticLib.pro - TEMPLATE = app - TARGET = - CONFIG+= console - # Input - SOURCES += main.cpp - INCLUDEPATH += ../staticLibrary - LIBS+= -L../staticLibrary/debug -lstaticLibrary main.cpp - #include - #include "test.h" - int main(int argc, char *argv[]) - QApplication a(argc, argv); - Widget w; - return a.exec(); Which approach to choose Which approach to choose depends on your needs. When creating a shared library, you need to deploy it with your application. On the plus side, applications and libraries linked against a shared library are small. Whether to use QLibrary to load the .dll or just standard linking, depends on whether you have access to the headers and the .lib files, if you don’t have access to those, then QLibrary is an alternative. Static linking results in a stand-alone executable. The advantage is that you will only have a few files to deploy. The disadvantage is that the executables are large. See the Deployment documentation [doc-snapshot.qt-project.org] for more details on shared and static builds.
1.1 2.1 3.1 4.1 5.1 6.1 7.1 8.1 9.1 10.1 11.1 12.1 13.1 14.1 15.1 16.1 17.1 18.1 19.1 20.1 21.1 22.1 23.1 24.1 25.1 26.1 27.1 28.1 30.1 31.1 33.1 35.1 37.1 38.1 39.1 40.1 41.1 42.1 44.1 46.1 47.1 48.1 49.1 50.1 51.1 53.1 54.1 56.1 57.1 58.1 59.1 60.1 61.1 63.1 65.1 67.1 69.1 71.1 72.1 75.1 86.1 101.1 104.1 113.1 114.1 115.1 116.1 117.1 118.1 119.1
Table of Content Türkçe English 简体中文 فارسی Español Giriş Bu ders Qt-Creator tümleşik geliştirme ortamı (IDE) kullanarak pragramlama için ilk adımları ayrıntılı olarak açıklamaktadır. Not: Bu ders sadece Qt’ye yeni başlayanlar için bir giriş niteliğindedir. Ot ile grafik kullanıcı arayüzü (GUI) hazırlamak oldukça kolaydır. Aynı zamanda hazırdadığınız arayüzler birçok platformda sorunsuz çalışmaktadır. Programlamaya başlamadan önce aşağıdakilerin sisteminizde kurulu olması gerekmektedir. - Qt Creator (Yaygın tüm platformlarda kullanabilirsiniz. Windows, Linux, Mac os) - Qt Libraries 4.8.3 for windows (Windows için ikili paketi) Kurulum Dosyalarını Buradan indirebilirsiniz. —> http://qt-project.org/downloads Kurulumun nasıl yapıldığıyla ilgili bu sayfadan [qt-project.org] bilgi alabilirsiniz. Not: Diğer işletim sistemleri üzerinde kullanmak isteyen arkadaşlarda aynı şekilde ilgili paketleri indirdikten sonra kullanmaya başlayabilir. Aynı zamanda Windows işletim sistemi üzerinde Visual Studio kullanılarakta geliştirme yapılabilir. Visual Studio kullanacak arkadaşlar Qt Libraries 4.8.3 veya başka bir sürümünü indirdikten sonra Qt Visual Studio Add-in eklentisini kurarak Visual Studio üzerinde geliştirme yapabilir. İlk Adım : Yeni Bir Proje Oluşturma - Qt Creator Başlatın - Sırasıyla File – New File or Project – Applications – Qt Gui Application seçtikten sonra Choose butonuna tıklayınız. - Açılan ekranda Name: karşısına proje için bir isim verdikte sonra Create in: karşısına projenin dizinini seçerek Next’e tıklayınız. - Qt ile hangi platformlara derleme yapılacağını soran bu ekranda Desktop seçerek masaüstüne derleme yapacağımızı bildirerek Next butonuna tıklıyoruz. - Açılan ekrandan Base Class yazan kısımdan hangi sınıftan türetme yapacağımızı şeçiyoruz. QMainWindow seçerek uygulamamız için bir anapencere oluşturmasını bununla birlikte bir başlık dosyası ve kaynak dosyası ile birlikte tasarım yapacağımız .ui uzantılı dosyayı oluşturmasını söylüyoruz. Next Butonuna tıklıyoruz. - Bu son dialog penceresinde ise eğer bir version kontrol sistemi kullanıyorsak Add toversion control: kısmından bunu seçebiliriz. Şu an none seçili kalacaktır. Son olarak Finish butonuna tıklayarak projemi oluşturuyoruz. Proje açıldıktan sonra 4 adet dosya oluşacaktır. Bunlar: - main.cpp - mainwindow.h - mainwindow.cpp - mainwindow.ui İkinci Adım : Proje Dosyalarına Gözatma - main.cpp - #include "mainwindow.h" - #include - int main(int argc, char *argv[]) - QApplication a(argc, argv); - MainWindow w; - return a.exec(); Yukarıda bulunan main fonksiyonu programın başlangıç fonksiyonudur. Main fonksiyonu içerisinde bir adet QApplication nesnesi oluşturuyoruz, Qt ile uygulamamızı çalıştırmak için tüm programlarda bu nesne oluşturulmak zorundadır, bu nesne programımız için arkaplanda bir döngü oluşturarak programımızın sürekli ekranda kalmasını sağlıyor. Daha sonra yaptığımız arayüzden bir nesne oluşturuyoruzki bu nesne bizim ana ekranımız yani QMainWindow sınıfından türetme yaptığımız sınıfın bir örneğini oluşturuyoruz. w.show(); fonksiyonunu çalıştırarak ekranda gözükmesini sağlıyoruz. return a.exec(); fonksiyonu ile uygulamayı QApplication’a devrediyoruz. - mainwindow.h - #ifndef MAINWINDOW_H - #define MAINWINDOW_H - #include - namespace Ui { - class MainWindow; - class MainWindow : public QMainWindow - Q_OBJECT - public: - explicit MainWindow(QWidget *parent = 0); - ~MainWindow(); - private: - Ui::MainWindow *ui; - #endif // MAINWINDOW_H Burası ana penceremizin başlık dosyasıdır. Q_OBJECT makrosu Qt içerisinde bulunan sinyal slot mekanızmasını kullanmak için eklenen bir makrodur. Bu konu ileride anlatılacaktır. explicit MainWindow(QWidget *parent = 0); burası sınıfın yapıcı fonksiyonu, QWidget *parent = 0 diyerek sınıfımızın başka bir sınıfa veyahut widgette diyebiliriz ait olmadığını belirtir, ileride görecemiz gibi bir nesne başka bir nesneye ait olabilmektedir. ~MainWindow(); burası yıkıcı fonksiyonumuz. private kısımda bulunan Ui::MainWindow *ui; designer ekranında oluşturduğumuz arayüze bir gösterici tanımlamaktadır. - mainwindow.cpp - #include "mainwindow.h" - #include "ui_mainwindow.h" - MainWindow::MainWindow(QWidget *parent) : - QMainWindow(parent), - ui(new Ui::MainWindow) - ui->setupUi(this); - MainWindow::~MainWindow() - delete ui; Burası projemizin kaynak dosyası, başlık dosyamızda tanımlanan fonksiyonların içerikleridir. ui->setupUi(this); fonksiyonu #include “ui_mainwindow.h” olarak eklediğimiz dosya içerinde Qt Creator tarafından oluşturulan otomatik bir fonksiyondur. Qt ile hazırladığımız arayüzler .ui dosyalarında xml yapısı kullanılarak tutulur. Projeji derlediğimizde MOC tarafından bunlar kaynak koda çevrilirler işte bu kaynak kod ui_mainwindow.h dosyasının ta kendisidir. Bunun içeriğini görebilmek için en az bir kez derleme yapmalıyızki MOC tarafından kodları oluşturulsun. - mainwindow.ui Bu dosyanın içeriği aşağıdaki gibi bir xml yapı içerisindedir. Bunlarda genellikle üzerinde değişiklik yapılmaz bu dosya sadece ekran üzerinde bulunan nesnelerin konum bilgileri vs. gösterir. Programın çalışma anına ilişkin bir dosya değildir. Derleyicinin gördüğü asıl dosya üretilen ui_mainwindow.h dosyasının içeriğidir. -  MainWindow -  MainWindow -  TopToolBarArea -  false Üçüncü Adım : Proje Dosyalarını Düzenleme Proje üzerine bir adet yazı gösteren bileşen ve bir adet tıklama ögesi yani buton eklenmek istenmektedir. Bu 2 bileşene widget denilmektektedir. Qt üzerinde kullanacağınız tüm arayüz nesneleri widget olarak adlandırılır. Birçok widget hazır olarak kurulu gelmiş olsada kendinizde bir widget ekleyebilirsiniz, lakin bunlar biraz ileri seviye konular olduğu için bu kısımda anlatılmayacaktır. mainwindow.ui dosyasına çift tıkladığınızda bir designer penceri açılacak, orta kısımda üzerinde çalıştığımız form nesnesi bulunmaktadır.(MainWindow Arayüzü). sol tarafta ise form üzerinde kullanacağımız widgetler bulunur. Sol taraftan bir adet QLabel ve QPushButton widgetini sürükleyerek form üzerine bırakınız. Dördüncü Adım : Proje Derleme ve Çalıştırma Projeyi kaydettikten sonra Build menüsünden Build Project seçerek veya Ctrl + B tuş kombinasyonunu kullanarak derleyebilirsiniz. Veya Derlemek ve sonrasında çalıştırmak için Build menüsünden Run seçerek veya Ctrl + R tuş kombinasyonunu kullanarak hem derleyip hem çalıştırabilirsiniz. Not: Aynı zamanda komut satırı kullanılarakta ilgili derleyiciye bağlı olarak derleme ve bağlama işlemini gerçekleştirebilirsiniz.