Замечание: Для завершения этого урока вы должны установить Nokia Qt SDK. Инсталлятор установит и настроит необходимый набор инструментов для разработки мобильных приложений.

Этот урок демонстрирует как использовать Qt Creator для написания маленькой программы Qt, Battery Indicator, которая использует System Information Mobility API для получения информации о батареи от устройства.

Создание проекта Battery Indicator

Замечание: Создайте проект с активным режимом Справка чтобы вы могли следовать этим инструкциям во время работы.

1. Выберите Файл > Новый файл или проект... > Проект Qt C++ > Мобильное приложение Qt > Выбрать....

   

   Откроется диалог Введение и размещение проекта.

   

2. В поле Имя введите BatteryIndicator.
3. В поле Создать в введите путь к файлам проекта. Например, C:\Qt\examples, и нажмите Вперёд.

   Откроется диалог Выбор требуемых профилей Qt.

   

4. Выберите цели Maemo, Эмулятор Qt и Устройство Symbian и нажмите Далее.

   Замечание: Данные цели будут присутствовать в списке если вы установили соответствующие среды разработки, например, в составе Nokia Qt SDK.

   Откроется диалог Информация о классе.

   

5. В поле Имя класса введите BatteryIndicator в качестве имени класса.
6. В списке Базовый класс выберите QDialog в качестве типа базового класса.

   Замечание: Поля Заголовочный файл, Файл исходников и Файл формы будут обновлены автоматически в соответствии с выбранным вами именем класса.

7. Нажмите Вперёд.

   Откроется диалог Управление проектом.

   

8. Проверьте настройки проекта и нажмите Завершить для создания проекта.

Проект BatteryIndicator будет содержать следующие файлы:

• batteryindicator.h
• batteryindicator.cpp
• main.cpp
• batteryindicator.ui
• BatteryIndicator.pro

Файлы содержат необходимые строки кода которые вы должны будете изменить как описано в следующих разделах. Вам не требуется изменять файл main.cpp.

Описание мобильного API Qt

Мастер Новый автоматически добавит требуемую при использовании мобильного API Qt или разработки приложений для устройств Symbian информацию в файл .pro. Вы должны изменить эту информацию для описания используемого вами мобильного API Qt.

Этот пример использует System Info API, поэтому вы должны описать его как продемонстрировано в в следующем фрагменте кода:

 CONFIG += mobility
 MOBILITY = systeminfo

Каждый мобильный API имеет своё значение которое вам необходимо добавить в качестве значения MOBILITY для использования этого API. Чтобы посмотреть список API и соответствующих значений которые вы можете присвоить MOBILITY, смотрите Пример Quickstart.

Следующий фрагмент кода демонстрирует необходимую информацию для разработки под Symbian. Qt Creator генерирует UID для тестирования приложения на устройстве. От вас требуется только изменить UID и возможности если вы хотите сделать приложение доступным для всех и получить подпись Symbian Signed.

 symbian {
     TARGET.UID3 = 0xecbd72d7
     # TARGET.CAPABILITY +=
     TARGET.EPOCSTACKSIZE = 0x14000
     TARGET.EPOCHEAPSIZE = 0x020000 0x800000
 }

Проектирование пользовательского интерфейса

1. В режиме Редактор дважды нажмите на файле batteryindicator.ui в виде Проекты для запуска интегрированного Qt Designer.
2. Перетащите виджет Progress Bar (QProgressBar) на форму.

   

3. В панели Свойства измените значение свойства objectName на batteryLevelBar.
4. Нажмите правой кнопкой мыши на объекте BatteryIndicator и выберите Компоновка > Скомпоновать по горизонтали чтобы обеспечить правильную установку размера виджета индикатора батареи на устройстве Maemo.

   Для правильной установки размера виджета в эмуляторе Qt, удалите условие из файла main.cpp (показанного в следующем фрагменте кода) и оставьте одну строку w.showMaximized();:

    #if defined(Q_WS_S60)
        w.showMaximized();
    #else
        w.show();
    #endif

Завершение заголовочного файла

Файл batteryindicator.h содержит некоторые необходимые директивы #include, конструктор, деструктор и объект Ui. Вы должны включить заголовочный файл System Info, добавить ссылку на мобильное пространство имён и добавить закрытую функцию для обновления значения уровня батареи в индикаторе при его изменении.

1. В режиме Проекты нажмите два раза на файле batteryindicator.h чтобы открыть его для редактирования.
2. Включите заголовочный файл System Info как продемонстрировано в следующем фрагменте кода:

    #include <QSystemInfo>

3. Добавьте ссылку на мобильное пространство имён как продемонстрировано в следующем фрагменте кода:

    QTM_USE_NAMESPACE

4. Опишите закрытую функцию в секции private за Ui::BatteryIndicator как продемонстрировано в следующем фрагменте кода:

    private:
        Ui::BatteryIndicator *ui;
        void setupGeneral();
   
        QSystemDeviceInfo *deviceInfo;

Завершение файла исходных кодов

Теперь заголовочный файл завершён, перейдём к файлу исходных кодов batteryindicator.cpp.

1. В режиме Проекты нажмите два раза на файле batteryindicator.cpp чтобы открыть его для редактирования.
2. Создайте объект QSystemDeviceInfo и установите его значение. Затем соедините сигнал который отражает изменение уровня батареи со слотом setValue индикатора выполнения. Это продемонстрировано в следующем фрагменте кода:

    void BatteryIndicator::setupGeneral()
    {
        deviceInfo = new QSystemDeviceInfo(this);
   
        ui->batteryLevelBar->setValue(deviceInfo->batteryLevel());
   
        connect(deviceInfo, SIGNAL(batteryLevelChanged(int)),
                ui->batteryLevelBar, SLOT(setValue(int)));
    }

3. Используйте конструктор для установки начальных значений и проверки того, что созданный объект находится в определённом состоянии, как продемонстрировано в следующем фрагменте кода:

    BatteryIndicator::BatteryIndicator(QWidget *parent) :
        QDialog(parent),
        ui(new Ui::BatteryIndicator),
        deviceInfo(NULL)
    {
        ui->setupUi(this);
        setupGeneral();
    }

Сборка и запуск вашего приложения

Теперь когда у вас есть весь необходимый код, выберите Эмулятор Qt в качестве цели и нажмите кнопку для сборки вашей программы и запуска её в эмуляторе Qt.

В эмуляторе Qt запустите пример скрипта runOutOfBattery.qs чтобы посмотреть как будет меняться значение в приложении Battery Indicator. Выберите Scripting > examples > runOutOfBattery.qs > Run.

Тестирование на устройстве Symbian

Вам также необходимо проверить приложение на реальных устройствах. Прежде чем вы начнёте тестирование на устройствах Symbian, вы должны подключить их к компьютеру и установить на них необходимое программное обеспечение.

1. Установите на устройстве библиотеки Qt 4.6.2, мобильные библиотеки Qt, и приложение отладки TRK. Для получения дополнительной информации смотрите Настройка окружения разработки для Symbian.
2. Запустите TRK на устройстве.
3. Нажмите Выбор цели и выберите Устройство Symbian.
4. Нажмите Выполнить для сборки приложения для устройства Symbian.

Тестирование в эмуляторе Maemo

Эмулятор Maemo эмулирует окружение устройства Nokia N900. Вы можете проверить приложение в условиях, которые практически идентичны устройству Nokia N900 с версией программного обеспечения 1.2 (V10.2010.19-1).

Для получения дополнительной информации смотрите Использование эмулятора Maemo.