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:
- BlackBerry Configuration
- Aktualisieren der BlackBerry
- BlackBerry-Plugins
- BlackBerry-Befehlszeilentools
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. Dasexample
-Verzeichnis enthält ein komplettes Cordova-Projekt. Kopie derexample
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: