Handbuch der BlackBerry-Plattform

Diese Anleitung zeigt Ihnen wie ein SDK-Umfeld zu Zielanwendungen für die BlackBerry-Plattform vor Version 10 eingerichtet. Wenn Sie die aktuellste Version ansprechen möchten, finden Sie im BlackBerry-10-Plattform-Guide. Finden Sie im folgenden detaillierte Plattform-spezifischen Informationen:

Die Befehlszeilentools, die oben beziehen sich auf Versionen vor 3.0 Cordova. Informationen über die aktuelle Schnittstelle finden Sie unter The Command-Line Interface.

Anforderungen und Unterstützung

Dieser BlackBerry-Version wird nicht unterstützt, durch die cordova in der Command-Line Interface, sondern durch einen separaten Satz von Befehlszeilentools beschriebenen Dienstprogramm. Laden Sie die Cordova-Verteilung von cordova.apache.org.

Cordova für BlackBerry basiert auf dem BlackBerry WebWorks-Rahmen, der für Windows XP (32-Bit) verfügbar ist, Windows 7 (32-Bit und 64-Bit) und Mac (OS X 10.6.4+). WebWorks Anwendungen können nur werden auf die folgenden BlackBerry Plattformen bereitgestellt:

BlackBerry OS 5.0 und höher
BlackBerry PlayBook
BlackBerry 10 (QNX)

WebWorks erfordert das Java Development Kit (JDK). Verwenden Sie für Windows 32-Bit-Version von Oracle JDK. Java in installiert standardmäßig unter Mac OS X bis Version 10.7, die eine separate Installationerfordert. Es erfordert auch Apache Ant, die auf dem Mac ist Bestandteil der Java-Installation. Die Windows-Version ist verfügbar von ant.apache.org.

Das SDK installieren

Downloaden Sie und installieren Sie das entsprechende WebWorks-SDK für Ihre Entwicklung. BlackBerry PlayBook und BlackBerry Smartphone WebWorks SDKs können unter den folgenden Adressen heruntergeladen werden.

[BlackBerry PlayBook SDK] (https://developer.blackberry.com/html5/download/#playbook) und Adobe Air-SDK
[BlackBerry Smartphones SDK] (https://developer.blackberry.com/html5/download/#smartphones)

Registrieren Sie sich für Signaturschlüssel

Wenn Sie Ihre Anwendung auf BlackBerry App World oder auf einem tatsächlichen Gerät veröffentlichen möchten, müssen Sie für eine Reihe von kostenlosen Code Signing Keys registrieren. Hierzu füllen Sie das Bestellformular für BlackBerry-Schlüssel. Sobald Sie Ihre Signatur-Schlüssel erhalten haben, müssen sie Setup. Siehe die BlackBerry HTML5/WebWorks-Website Informationen.

Installieren von Cordova

Herunterladen Sie und extrahieren Sie die neueste Kopie von Cordova.

Einrichten eines neuen Projekts

Öffnen Sie eine Command-Line Terminal und navigieren Sie zum entpackten Cordova.
Es ist ein Verzeichnis für jede Plattform, Cordova unterstützt. Navigieren Sie zu dem blackberry Verzeichnis.
Das blackberry Verzeichnis enthält mehrere Unterverzeichnisse. Das example -Verzeichnis enthält ein komplettes Cordova-Projekt. Kopie der example Verzeichnis an einen anderen Speicherort auf Ihrem Computer, und dorthin navigieren.

Bearbeiten Sie die project.properties Datei im WebWorks-SDK angeben Sie verwenden. Hier sind beispielsweise die jeweiligen Einstellungen für BlackBerry PlayBook, BlackBerry-Smartphone (OS5-7) oder 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

Diese entsprechen den Parametern, die Sie angeben, wenn Sie Ihr Projekt zu erstellen. Zum ersten Mal, wenn, das Sie diese Befehle ausführen, generieren sie eine Anwendung "Hello World":

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

Zusammen mit dem SDK müssen Sie auch für einen Code Signaturschlüssel und Debug-Token zu registrieren. Der Signaturschlüssel können Sie apps durch BlackBerry World verteilen. Das Debug-Token können Sie unsignierte apps auf einem BlackBerry-Emulator oder Gerät zu testen. Sie müssen nicht erstellen und installieren Sie das Debug-Token; Wenn Sie das Schlüsselspeicher-Kennwort angeben, wird das Buildskript erstellt und installiert das Debug-Token für Sie. Um den Signaturschlüssel einzurichten, gehen Sie die BlackBerry-Website, erhalten Sie es, dafür zu sorgen, das Kennwort zu behalten, die, das Sie angeben. Führen Sie das blackberry-signer -Dienstprogramm, das im SDK enthalten ist. BlackBerry bietet weitere Informationen hier:

Bereitstellen auf Emulator

BlackBerry-Smartphone-Emulatoren sind nur unter Windows verfügbar. BlackBerry PlayBook Emulatoren benötigen VMWare Player (Windows) oder VMWare Fusion (Mac OS X). Das WebWorks-SDK enthält einen Standard-Emulator, aber zusätzliche Emulatoren sind über BlackBerry verfügbar.

Geben Sie Ihrem Projektverzeichnis, ./cordova/run <target> , ersetzen <target> mit qnx , playbook , oder blackberry . Beachten Sie, dass für BlackBerry 10 und Textbuch, das Emulator-Computerbild bereits gestartet sein muss.

Weitere Informationen finden Sie unter:

Für BlackBerry Playbook, bearbeiten Sie die project.properties Datei zum Anpassen der playbook.sim.ip und playbook.sim.password Eigenschaften. IP-Adresse des Emulators ist durch die Einstellungsanwendung auf dem home-Bildschirm . Aktivieren der Sicherheit und Datenschutz → Entwicklungsmodus Option, um die Adresse anzuzeigen. Das Kennwort kann auch in der Registerkarte " Sicherheit und Datenschutz " festgelegt werden.

Für BlackBerry-Smartphone, bearbeiten Sie die project.properties Datei zum Anpassen der blackberry.sim.dir und blackberry.sim.bin Eigenschaften. Du musst weg Trennzeichen zu entkommen, wenn Verzeichnispfade unter Windows, z. B. die Angabe:C:\\Program Files\\BlackBerry\\Simulator.

Nachdem der Emulator installiert und ausgeführt wird, führen Sie einen der folgenden Schritte zur Installation einer Anwendung auf dem home-Bildschirm:

    cordova/run playbook
    cordova/run blackberry

Wenn Sie gefragt werden, ob ein Gerät an Ihren Computer angeschlossen ist, Antworten Sie mit Nein.

Hinweis: Auf BlackBerry OS 5, die Anwendung installiert ist, das Downloads Verzeichnis.

Bereitstellung auf Gerät

Zum Bereitstellen Ihrer Anwendung in ein Gerät muss verbunden sein, und Sie müssen registriert sein, für Code signing-Schlüssel wie oben beschrieben. Auch, um apps auf dem BlackBerry PlayBook Bereitstellen der Einstellungen → Sicherheit → Entwicklungsmodus Option muss aktiviert sein.

Auf BlackBerry PlayBook "Bearbeiten" die project.properties Datei und ändern Sie folgendermaßen vor, um das Gerät IP und Passwort als beschreibt oben, zusammen mit dem signing Key Passwort reflektieren Sie einrichten:

Geben Sie Ihrem Projektverzeichnis, ./cordova/run <target> , ersetzen <target> mit qnx , playbook , oderblackberry.

Geben Sie auf BlackBerry-Smartphone (OS5-7), die blackberry.sigtool.password -Eigenschaft, wie das Kennwort für den Neuzugang Schlüssel.

Dann aus dem Projekt-Verzeichnis, führen Sie einen der Befehle würden Sie um die app in einem Emulator anzuzeigen:

    cordova/run playbook
    cordova/run blackberry

Wenn Sie gefragt werden, ob ein Gerät an Ihren Computer angeschlossen ist, Antworten Sie mit Ja.

Hinweis: Auf BlackBerry OS 5, die Anwendung installiert ist, das Downloads Verzeichnis.

Weitere Informationen

Die folgenden Artikel können helfen, gemeinsame Probleme zu lösen, beim Entwickeln von Anwendungen für BlackBerry WebWorks Rahmen gebaut: