license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations

under the License.

Руководство по платформы ежевики

В этом руководстве показано, как настроить среду SDK для приложений для платформы ежевики до версии 10. Если вы хотите цели самой последней версии, смотрите в руководстве платформы BlackBerry 10. Смотрите ниже для более подробной информации конкретной платформы:

BlackBerry конфигурации
Модернизация BlackBerry
Ежевика плагины
Средства командной строки ежевики

Средства командной строки относятся к версии до Cordova 3.0. Сведения о текущем интерфейсе см интерфейс командной строки.

Требования и поддержка

Эта версия BlackBerry не поддерживается cordova средство, описанное в интерфейс командной строки, но отдельный набор средств командной строки. Скачайте дистрибутив Cordova от cordova.apache.org.

Cordova для BlackBerry опирается на BlackBerry WebWorks framework, который доступен для Windows XP (32-разрядная), Windows 7 (32-разрядные и 64-бит) и Mac (OS X 10.6.4+). WebWorks приложения могут только быть развернут на следующих платформах ежевики:

BlackBerry OS 5.0 и выше
BlackBerry PlayBook
Ежевика 10 (QNX)

WebWorks требует Java Development Kit (JDK). Для Windows используйте 32-разрядной версии Oracle JDK. Java в устанавливается по умолчанию в Mac OS X, вплоть до версии 10.7, которая требует отдельной установки. Это также требует Apache Ant, который на Mac является частью установки Java. Windows версия доступна с ant.apache.org.

Установите SDK

Скачать и установить соответствующий WebWorks SDK для вашего развития. BlackBerry PlayBook и BlackBerry смартфон WebWorks SDK можно загрузить из следующих источников.

[BlackBerry PlayBook SDK] (https://developer.blackberry.com/html5/download/#playbook) и Adobe Air SDK
[Ежевики Smartphones SDK] (https://developer.blackberry.com/html5/download/#smartphones)

Зарегистрироваться для ключей подписи

Если вы хотите опубликовать приложение на мире App ежевики, или на фактическом устройстве, вам будет нужно зарегистрировать для набора бесплатные ключи подписывания кода. Для этого заполните BlackBerry клавиш бланке заказа. Как только вы получите ваши ключи подписи, они требуют установки. Смотрите веб-сайт BlackBerry HTML5/WebWorks для получения информации.

Установить Кордова

Скачайте и распакуйте последнюю копию Кордова.

Создание нового проекта

Открыть терминал командной строки и перейдите к где вы распаковали Cordova.
Существует каталог для каждой платформы, которая поддерживает Cordova. Перейдите к blackberry каталог.
blackberryКаталог содержит несколько подкаталогов. exampleКаталог содержит полный проект Cordova. Копия example каталог в другое место на вашем компьютере и перемещаться там.
Редактировать project.properties файла для указания WebWorks SDK, вы используете. Например ниже приведены соответствующие параметры для BlackBerry PlayBook, смартфон BlackBerry (OS5-7) или BlackBerry 10 (QNX):
```
playbook.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks SDK for TabletOS 2.1.0.6\\bbwp
blackberry.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks Packager
qnx.bbwp.dir=C:\\Program Files (x86)\\Research In Motion\\BlackBerry 10 WebWorks SDK 1.0.2.9
```

Они соответствуют параметрам, которые указываются при построении проекта. Первый раз при запуске этих команд, они создают приложения «HelloWorld»:

    cordova/build playbook
    cordova/build blackberry
    cordova/build qnx

Вместе с SDK необходимо зарегистрировать ключ подписи кода и отладки маркер. Ключ подписи позволяет распространять приложения через BlackBerry World. Маркер отладки позволяет проверить неподписанные приложения на BlackBerry эмуляторе или устройстве. Вам не нужно создавать самостоятельно и установить маркер отладки; Если ввести пароль хранилища ключей, сценарий построения создает и устанавливает маркер отладки для вас. Чтобы настроить ключ подписи, перейдите на веб-сайт BlackBerry для получения, убедившись в том сохранить пароль, указанный вами. Затем запустите blackberry-signer Утилита, которая входит в состав SDK. Ежевика предоставляет более подробную информацию здесь:

Развертывание в эмулятор

Эмуляторов смартфонов blackBerry доступны только на Windows. BlackBerry PlayBook Эмуляторы требуют VMWare Player (Windows) или VMWare Fusion (Mac OS X). WebWorks SDK предоставляет по умолчанию эмулятор, но дополнительные Эмуляторы доступны через ежевику.

Из каталога проекта, типа ./cordova/run <target> , заменяя <target> либо с qnx , playbook , или blackberry . Обратите внимание, что для BlackBerry 10 и пьес, эмулятор виртуальный образ уже должен быть запущен.

Смотрите ниже для получения дополнительной информации:

Для BlackBerry Playbook, отредактируйте project.properties для настройки файл playbook.sim.ip и playbook.sim.password Свойства. Эмулятор IP-адрес доступен через Параметры приложения на начальном экране. Включить безопасности и конфиденциальности → режим развития параметр для отображения адреса. Пароль можно также задать в закладке безопасность и конфиденциальность .

Смартфон BlackBerry, отредактируйте project.properties для настройки файл blackberry.sim.dir и blackberry.sim.bin Свойства. Вам нужно бежать разделителей пути при задании пути каталогов в Windows, например:C:\\Program Files\\BlackBerry\\Simulator.

После того, как эмулятор установлена и запущена, выполните одно из следующих действий, чтобы установить приложение на главном экране:

    cordova/run playbook
    cordova/run blackberry

Если вы пробуждены ли устройство подключено к вашему компьютеру, ответить без.

Примечание: На BlackBerry OS 5, приложение установлено в Downloads каталог.

Развернуть устройстве

Для развертывания приложения на устройство, он должен быть подключен, и вы должны быть зарегистрированы для кода ключей подписи, как описано выше. Также, для развертывания приложения на BlackBerry PlayBook, Параметры → Безопасность → режим развития должна быть включена опция.

Измените на BlackBerry PlayBook, project.properties файл и изменить следующие действия, чтобы отразить IP и пароль устройства как descibed выше, вместе с подписания пароль ключа, вы создали:

Из каталога проекта, типа ./cordova/run <target> , заменяя <target> либо с qnx , playbook , илиblackberry.

На смартфон BlackBerry (OS5-7), укажите blackberry.sigtool.password свойства как подписи пароль ключа.

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

    cordova/run playbook
    cordova/run blackberry

Если вы пробуждены ли устройство подключено к вашему компьютеру, ответьте Да.

Примечание: На BlackBerry OS 5, приложение установлено в Downloads каталог.

Дополнительная информация

Следующие статьи может помочь решить общие проблемы при разработке приложений для платформы BlackBerry WebWorks: