怎样在Qopia中新增应用

怎样在Qopia中新增应用

      

 

       发现很多新手不知道如何在Qtopia中新增自己的应用，为了不至于走弯路，本文旨在做个简单介绍，不妥之处欢迎批评指出。  : )

 

1.    Step 1.

        在qtopia-phone-version/src/applications/目录下，新建appname目录；

        如果是游戏的话，你可以把applications改成games，当然，appname指的是你应用的目录。具体是自己的喜好。将源文件，和一个.pro文件放置此处。

main.cpp文件修改如下：

 

//main.cpp

#include "xxxxx.h"        

 

#include <qtopia/qpeapplication.h>

 

QTOPIA_ADD_APPLICATION("appname ",CAppMainClass);

QTOPIA_MAIN

 

        其中，appname指的是你应用的名字，CAppMainClass是主类名(CAppMainClass:public QMainWindow)，xxxx.h是你声明主类的地方。

新建appname.pro文件，内容如下：

 

CONFIG          += qtopiaapp

 

TARGET          = appname

 

HEADERS         = xxx.h appanme.h

SOURCES         = appname.cpp

TRANSLATABLES = $${HEADERS} $${SOURCES}

 

help.files=$${QTOPIA_DEPOT_PATH}/help/html/appname*

help.path=/help/html

 

desktop.files=$${QTOPIA_DEPOT_PATH}/apps/Applications/appname.desktop

desktop.path=/apps/ Applications

 

pics.files=$${QTOPIA_DEPOT_PATH}/pics/ appname /*

pics.path=/pics/appname

 

INSTALLS+=desktop help

PICS_INSTALLS+=pics

 

       TARGET指明应用生成的名字，HEADERS指出源码头文件，SOURCES指出源码实现文件，help指出帮助文件，如果没有，可以去掉；desktop这是指出应用放在桌面的哪个位置，待会儿我们后面会讲到，pics指的是应用所要用到的图标资源文件。上面desktop.files, help.files, 和pics.files是源文件位置，pics.path, desktop.path, 和help.path是编译安装后的位置，INSTALLS和PICS_INSTALLS指的是要进行安装。

这些搞定，我们进入第二步

 

2.    Step 2.

       在目录qtopia-phone-version/src中，找到general.pri文件，并在文中下面位置进行修改，插入你应用的名字：

....

...

!QTOPIA_CORE {

    APP_PROJECTS+=/

        applications/addressbook /

        applications/calculator /

        applications/camera /

        applications/clock /

        applications/datebook /

        applications/mediarecorder /

        applications/music /

        applications/videos /

        applications/photoedit /

        applications/sysinfo /

        applications/textedit /

        applications/todo/

        applications/appname/

        games/fifteen/

        games/minesweep/

        games/parashoot/

        games/qasteroids/

        games/snake/

        games/solitaire

    !free_package:APP_PROJECTS+=settings/words

}

...

...

 

3.    Step 3

       准备你的.desktop 文件。在qtopia-phone-version/apps/Applications目录下，新建你的appname.desktop文件，还记得前面appname.pro文件里提及的desktop的内的desktop.files=$${QTOPIA_DEPOT_PATH}/apps/Applications/appname.desktop

吗？

appname.desktop内容如下：

[Translation]

File=QtopiaApplications

Context=Appname

[Desktop Entry]

Comment[]=My App Demo

Exec=appname

Icon=Appname

Type=Application

Name[]=MyApp

 

       Exec指出的名字必须与应用的目标二进制文件名一致，Icon指出的是应用在desktop中的小图标的文件名(不含扩展名.png)，

 

4.    Step 4

       你的图标文件，放置qtopia-phone-version/pics/appname/目录下，与.pro文件中pics.files=$${QTOPIA_DEPOT_PATH}/pics/ appname /* 指出的一致。

 

       这时你可以编译，最后在qtopia-phone-version目录下会生成一个新的qtopia目录image/opt/Qtopia，里面就是编译安装好的程序，目录结构和源基本一致，如果编译的事目标板版本，将此目录拷贝至目标版的qtopia目录即可。

    

       建议初学者参照Qtopia自带源代码进行学习，这样可取得较好效果，如snake游戏。

 

附：几个文件的详细介绍

项目文件

项目文件（*.pro）用于生成 Makefile 文件，详细介绍可以参考《qmake 使用手册》（qmake-manual.html）；

“=”操作符

这个操作符简单分配一个值给一个变量。使用方法如下：   

TARGET = myapp

这将会设置TARGET变量为myapp。这将会删除原来对TARGET的任何设置。

“+=”操作符

这个操作符将会向一个变量的值的列表中添加一个值。使用方法如下：

             DEFINES += QT_DLL

这将会把QT_DLL添加到被放到makefile中的预处理定义的列表中。

“-=”操作符

这个操作符将会从一个变量的值的列表中移去一个值。使用方法如下：

            DEFINES -= QT_DLL

这将会从被放到makefile中的预处理定义的列表中移去QT_DLL。

“#”注释

你可以为项目文件添加注释。注释由“#”符号开始，一直到这一行的结束。

“TEMPLATE”变量

告诉qmake为这个应用程序生成哪种makefile。下面是可供使用的选择：

app - 建立一个应用程序的makefile。这是默认值，所以如果模板没有被指定，这个将被使用。

lib - 建立一个库的makefile。

“CONFIG”变量

配置变量指定了编译器所要使用的选项和所需要被连接的库。配置变量中可以添加任何东西，但只有下面这些选项可以被qmake识别。

 

下面这些选项控制着使用哪些编译器标志：

release    - 应用程序将以release模式连编。如果“debug”被指定，它将被忽略。

debug      - 应用程序将以debug模式连编。

warn_on    - 编译器会输出尽可能多的警告信息。如果“warn_off”被指定，它将被忽略。

warn_off   - 编译器会输出尽可能少的警告信息。

 

下面这些选项定义了所要连编的库/应用程序的类型：

qt         - 应用程序是一个Qt应用程序，并且Qt库将会被连接（这里是qtopia）。

thread     - 应用程序是一个多线程应用程序。

x11        - 应用程序是一个X11应用程序或库。

windows    - 只用于“app”模板：应用程序是一个Windows下的窗口应用程序。

console    - 只用于“app”模板：应用程序是一个Windows下的控制台应用程序。

dll        - 只用于“lib”模板：库是一个共享库（dll）。

staticlib  - 只用于“lib”模板：库是一个静态库。

plugin     - 只用于“lib”模板：库是一个插件，这将会使dll选项生效。

例如，如果你的应用程序使用Qt库，并且你想把它连编为一个可调试的多线程的应用程序，你的项目文件应该会有下面这行：

    CONFIG += qt thread debug

注意，你必须使用“+=”，不要使用“=”，否则qmake就不能正确使用连编Qt的设置了，比如没法获得所编译的Qt库的类型了

“app”模板

“app”模板告诉qmake为建立一个应用程序生成一个makefile。当使用这个模板时，下面这些qmake系统变量是被承认的。你应该在你的.pro文件中使用它们来为你的应用程序指定特定信息。

HEADERS      - 应用程序中的所有头文件的列表。

SOURCES      - 应用程序中的所有源文件的列表。

FORMS        - 应用程序中的所有.ui文件（由Qt设计器生成）的列表（这里是INTERFACES）。

LEXSOURCES   - 应用程序中的所有lex源文件的列表。

YACCSOURCES  - 应用程序中的所有yacc源文件的列表。

TARGET       - 可执行应用程序的名称。默认值为项目文件的名称。（如果需要扩展名，会被自动加上。）

DESTDIR      - 放置可执行程序目标的目录。

DEFINES      - 应用程序所需的额外的预处理程序定义的列表。

INCLUDEPATH  - 应用程序所需的额外的包含路径的列表。

DEPENDPATH   - 应用程序所依赖的搜索路径。

VPATH        - 寻找补充文件的搜索路径。

DEF_FILE     - 只有Windows需要：应用程序所要连接的.def文件。

RC_FILE      - 只有Windows需要：应用程序的资源文件。

RES_FILE     - 只有Windows需要：应用程序所要连接的资源文件。

你只需要使用那些你已经有值的系统变量，例如，如果你不需要任何额外的INCLUDEPATH，那么你就不需要指定它，qmake会为所需的提供默认值。例如，一个实例项目文件也许就像这样：

TEMPLATE = app

DESTDIR  = c:/helloapp

HEADERS += hello.h

SOURCES += hello.cpp

SOURCES += main.cpp

DEFINES += QT_DLL

CONFIG  += qt warn_on release

如果条目是单值的，比如template或者目的目录，我们是用“=”，但如果是多值条目，我们使用“+=”来为这个类型添加现有的条目。使用“=”会用新值替换原有的值，例如，如果我们写了DEFINES=QT_DLL，其它所有的定义都将被删除。

其它；

TARGET.path = /bin - 可执行文件路径（qtopia-phone-version/image/opt/Qtopia/bin），编译生成的可执行文件必须复制到这个目录下。

 

desktop.files = example.desktop     - 文件名

desktop.path = /apps/Applications   - 路径

INSTALLS += desktop

 

pics.files=Example.png      - 图标文件名

pics.path=/pics/example     - 路径

INSTALLS+=pics

 

help.files=example.html     - 帮助文件

help.path=/help/html        - 路径

INSTALLS+=help

 

相关的文件必须复制到相应的目录下。

 

main.cpp

main.cpp文件格式的详细介绍见“qtopia2.1官方文档/html/mainfunc.html”；形式如下：

QTOPIA_ADD_APPLICATION(NAME,IMPLEMENTATION)

QTOPIA_MAIN

IMPLEMENTATION – 应用程序主窗口类

NAME           - “可执行文件名”

 

desktop文件

    Exec   =example     - 可执行文件名

Icon   =Example     - 图标文件名

Name[] =Example   - 显示的快捷图标的标题

将这个文件复制到qtopia-phone-version/image/opt/Qtopia/apps/Applications/ 目录下，（大概与qpe环境的Application页对应）；

 

图标

将图标文件复制到qtopia-phone-version/image/opt/Qtopia/pics/ 目录（与项目文件中声明的路径一致）；

建议将图标文件复制一份到帮助文件（*.html）相同目录下，否则html文件中的图形可能不会正确显示。