Обзор инструментов, входящих в состав WebOS SDK
Эта статья посвящена вопросам использования инструментов, входящих в состав Palm® Mojo™ SDK.
При создании приложения для Palm WebOS, используется такая последовательность действий:
На данный момент официальная документация содержит описание всех этапов, кроме этапа подписывания приложения. Соответственно в SDK доступны утилиты командной строки, обеспечивающие работу на каждом из перечисленных выше этапов.
- palm-generate — Для генерирования сцен и приложений
- palm-package — Для создания инсталляционного пакета, который можно установить на устройство или в эмулятор
- palm-install —Для установки пакетов на устройство или в эмулятор
- palm-launch — Для удаленного запуска приложений на устройстве или в эмуляторе
- worm.jar — Для профилировки приложений
palm-generate
Этот скрипт используется для создания приложений и сцен
Синтаксис вызова утилиты:
palm-generate options
Доступны следующие параметры запуска:
| Опция | Описание |
|---|---|
| -f –overwrite |
Перезаписывать существующие файлы |
| -l –list |
Вывести список доступных шаблонов. |
| -p {property} –property={property} |
Определяет свойства генерируемого шаблона. Параметр {property} содержит JSON-объект или пары ключ-значение в формате “ключ=значение”. В обоих случаях необходимо заключение значения в кавычки. Кроме того, если в значениях есть пробелы, то эти значения должны быть заключены в одинарные кавычки. |
| -t {template} –template={template} |
Указывает на необходимость использования шаблона {template}. Если этот параметр не указан, то по умолчанию будет генерироваться новое приложение – шаблон new{{_app}}. |
| –help | Вывод справочной информации. |
Примеры использования
Сгенерировать проект с названием “Sample Application” в папке ~/projects/SampleApp
palm-generate -p "title=Sample Application" ~/projects/SampleApp
Создать новое приложение и указать название, уникальный идентификатор и версию
palm-generate -p "{title:'Super Application', id:com.mystuff.superapp, version:'1.1'}" ~/projects/SuperApp
Добавить новую сцену с названием First в приложение HelloWorld
palm-generate -t new_scene -p "name=First" ~/projects/HelloWorld
palm-package
Утилита-упаковщик, которая создает .ipkg файл, который, в свою очередь, может быть установлен в эмулятор или на устройство.
Синтаксис вызова:
palm-package [options ] application-directory
Доступные опции:
| Опция | Описание |
|---|---|
| -o {directory} –outdir={directory} |
Каталог, в котором должен быть создан .ipkg файл. Если эта опция не задана, то установочный пакет приложения будет создан в текущем каталоге. |
| –exclude={pattern} | Исключает из обработки файлы, которые подпадают под описание {pattern}. Шаблон {pattern} может также содержать символы * и ?. Значение шаблона чувствительно к регистру если не указана опция –ignore-case. |
| -X {pattern_file} –exclude-from={pattern_file} |
Исключает из обработки файлы, названия которых совпадают с любым из шаблонов, указанных в параметре {pattern_file}. В файле {pattern_file} указываются шаблоны названий файлов, по одному в каждой строке. Шаблоны названий файлов могут содержать символы * и ?. Значение шаблона чувствительно к регистру если не указана опция –ignore-case. |
| –ignore-case | Указыват что регистр символов в названиях файлов должен быть проигнорирован. |
| –no-exclude-eclipse | По умолчанию, файлы проектов Eclipse исключаются из обработки. Если нужно их включить в инсталляционный пакет, используется эта опция. |
| –no-exclude-hidden | По умолчанию, скрытые файлы исключаются из обработки. Если нужно их включить в инсталляционный пакет, используется эта опция. |
| –no-exclude-vcs | По умолчанию, файлы и каталоги, необходимые для работы систем контроля версий, исключаются из обработки. Если нужно их включить в инсталляционный пакет, используется эта опция. |
| –help | Выводит справочную информацию. |
Примеры использования
Создать приложение HelloWorld
palm-package ~/projects/HelloWorld
Создать приложение Sample но исключить из дистрибутива текстовые файлы и папку docs.
palm-package --exclude="*.txt" --exclude="docs" ~/projects/Sample
palm-install
Эта утилита устанавливает приложения в эмулятор или на устройство. Нельзя установить приложение если устройство находится в режиме синхронизации (Media Sync mode). Если приложение устанавливается на устройство, то устройство должно находиться в режиме Developer Mode (см. ниже)
Синтаксис вызова:
palm-install [options] [package]
Доступные опции:
| Опция | Описание |
|---|---|
| -d {device} –device={device} |
Указывает устройство, на которое должна производиться установка приложения:
|
| -l –list |
Выдает список приложений, установленных на устройстве. |
| -r {application}–remove {application} | Удаляет приложение, уникальный идентификатор которого соответствует параметру {application}. |
| –help | Выводит справочную информацию. |
Примеры использования
Установить приложение
palm-install ~/projects/packages/com.example.app_1.0_all.ipk
Удалить приложение
palm-install -r com.example.app
Вывести список приложение в эмуляторе
palm-install -d tcp -l
palm-launch
Запускает приложение в эмуляторе или на устройстве
Синтаксис вызова:
palm-launch [options] {application}
{application} – уникальный идентификатор приложения
Доступные опции:
| Опция | Описание |
|---|---|
| -c –close |
Закрывает приложение вместо запуска. |
| -d {device} –device={device} |
Устройство:
|
| -f –relaunch |
Перезапускает приложение. |
| -i | Запускает приложение в . |
| -l –list |
Выводит список установленных приложений. |
| -p {parameters}–params={parameters} | Указывает параметры запуска. Значение {parameters} содержит JSON-объект или пары ключ-значение в формате “ключ=значение”. В обоих случаях необходимо заключать все в двойные кавычки. |
| –help | Выводит справочную информацию. |
Примеры использования
Запустить приложение
palm-launch com.example.app
Запустить приложение в режиме отладки
palm-launch -p "{mojoConfig:true, debuggingEnabled:true}" com.example.app
Включение Developer Mode
- В Card view или в Launcher ввести текст:
upupdowndownleftrightleftrightbastart - Нажать на иконку Developer Mode Enabler.
- В приложении установить значение слайдера Developer Mode в позицию On.
- Нажать Reset the Device.
После перезагрузки режим Developer Mode будет включен.
Еще интересные посты о программировании для мобильных устройств:
2 Comments
Make A CommentComments RSS Feed TrackBack URL
September 25th, 2009 at 09:05
[...] Main. Как создать проект и сцену можно узнать из этой статьи. Затем добавим в созданную сцену [...]
September 26th, 2009 at 09:02
[...] Для начала создадим приложение и в нем сцену с названием Call. Как создать приложение и сцену в нем, можно узнать здесь. [...]