Handbuch für die Plattform von BlackBerry 10
Diese Anleitung zeigt wie Sie die Entwicklungsumgebung zum Erstellen und Bereitstellen von Cordova apps für BlackBerry 10 Geräte aufsetzen. Für frühere Versionen von BlackBerry müssen Sie einen anderen Satz von Befehlszeilentools, beschrieben im Handbuch der BlackBerry-Plattform zu verwenden.
Anforderungen
Die Entwicklungsumgebung ist auf Windows, Mac und Linux verfügbar.
Entwickler sollten verwenden, die cordova
in Verbindung mit der Blackberry-Native-SDK-Dienstprogramm. Die Command-Line Interface Informationen finden Sie unter Gewusst wie: Installieren Sie cordova
, Projekte, hinzufügen dann erstellen und bereitstellen für jede Plattform.
Das BlackBerry-Native-SDK installieren
Die BlackBerry-Native-SDK steht von developer.blackberry.comzur Verfügung. Nach der Installation müssen Sie die Befehlszeilenprogramme zum Systempfad hinzufügen.
Unter Windows:
Gehen Sie zu mein Computer → Eigenschaften → erweitert → Umgebungsvariablen.
Hängen Sie die Native SDK-Installationsverzeichnis auf den Pfad, z.B.:
;C:\bbndk\host_10_1_0_132\darwin\x86\usr\bin\
Auf Mac und Linux:
Bearbeiten Sie die
~/.bash_profile
-Datei eine Zeile wie die folgende, je nachdem, wo die Native SDK installiert wurde hinzugefügt:$ Export PATH = ${PATH}: / Anwendungen/Bbndk/host_10_1_0_132/Darwin/X 86/Usr/bin /
oder für das 10.2 Native SDK:
$ Export PATH=${PATH}:/Applications/Momentics.app/host_10_2_0_15/darwin/x86/usr/bin/
Führen Sie folgendermaßen vor, um die Änderung in der aktuellen Sitzung zu übernehmen:
$ Quelle ~/.bash_profile
Für Signierung einrichten
Wenn Sie auf einem Gerät zu testen oder apps durch BlackBerry World verteilen möchten, muss Ihr System Setup zum Signieren von Code sein.
Um einen Signaturschlüssel zu erhalten, besuchen Sie die BlackBerry-Website, und achten Sie darauf, das Kennwort zu kennen, die, das Sie angeben. Führen Sie das blackberry-signer
-Dienstprogramm, das mit dem systemeigenen BlackBerry-SDK enthalten ist.
Detaillierte Anweisungen finden Sie hier:
Erstellen Sie ein Projekt
Verwendung der cordova
Utility für ein neues Projekt, wie in der Command-Line Interface beschrieben einrichten. Zum Beispiel in einem Quellcode-Verzeichnis:
$ cordova create hello com.example.hello
$ cd hello
$ cordova platform add blackberry10
$ cordova build
Bereitstellen auf Emulator
Wenn Sie einen Geräteemulator ausführen möchten, downloaden und Installieren der BlackBerry-10-Simulator.
Sie müssen vor der Prüfung einer app auf einem Emulator oder ein Gerät, ein Ziel zu Ihrem Projekt hinzufügen. Jedes ist mit einem eindeutigen Namen identifiziert und einer IP-Adresse zugeordnet. Sie müssen die IP-Adresse vom Emulator zu erhalten, bevor Sie es verwenden, um apps anzusehen.
Starten Sie das Emulator-Image, dann wählen Sie Einstellungen aus dem home-Bildschirm:
Navigieren Sie zu der Sicherheit und Datenschutz → Entwicklungsmodus section, aktivieren Sie die Option und die IP-Adresse beziehen:
Eine weitere Gruppe von Befehlszeilen-Dienstprogramme sind enthalten, wenn Sie die BlackBerry 10-Plattform für Ihr Projekt einrichten. Der folgende Befehl, in diesem Fall aus dem Projektverzeichnis auf oberster Ebene aufgerufen verknüpft ein Ziel mit dem Namen emu mit oben angezeigten IP-Adresse.
Unter Windows:
$ platforms\blackberry10\cordova\target.bat add emu 169.254.0.1 -t simulator
Auf Mac/Linux:
$ platforms/blackberry10/cordova/target add emu 169.254.0.1 -t simulator
Führen Sie dann den emulate
Befehl, um die app anzuzeigen:
$ cordova emulate blackberry10
Bereitstellung auf Gerät
Um auf ein Gerät bereitzustellen, sicherzustellen Sie, dass es an Ihrem Computer angeschlossen ist. Entwicklungsmodus aktivieren und die IP-Adresse als beschriebenen Emulator oben im Abschnitt zu erhalten. Sie müssen auch den Anschluß von erhalten die lagereinstellungsanwendung unter über → Hardware:
Führen Sie das Ziel-Befehlszeilenprogramm, um eine IP-Adresse, Gerätekennwort und PIN einen Namen zuzuordnen.
Unter Windows:
$ platforms\blackberry10\cordova\target.bat add mydevice 169.254.0.1 -t device --password 123456 --pin FFFF972E
Auf Mac/Linux:
$ platforms/blackberry10/cordova/target add mydevice 169.254.0.1 -t device --password 123456 --pin FFFF972E
Wo:
--password
bezieht sich auf das Kennwort zum Entsperren.--pin
bezieht sich auf das Gerät PIN die Einstellungsanwendung eingeholt.
Führen Sie dann den run
Befehl, um die app anzuzeigen:
$ cordova run blackberry10
Wenn ein Debug-Token nicht noch für das Gerät eingerichtet ist, fordert eine Fehlermeldung Sie nutzen die Plattform, das Skript mit dem Kennwort, die Sie bei Registrierung für Signaturschlüssel.
Unter Windows:
$ platforms\blackberry10\cordova\run.bat --device --keystorepass mysecret
Auf Mac/Linux:
$ platforms/blackberry10/cordova/run --device --keystorepass mysecret
Debuggen mit WebInspector
Beim Debuggen auf dem Gerät oder einen Emulator können Sie WebInspector aus der Ferne, um den internen Zustand der Anwendung anzuzeigen ausführen. Eine Eingabeaufforderung zeigt die URL, die Sie zum Herstellen einer Verbindung mit Ihrer app mit einem standard-Webbrowser ermöglicht. Weitere Informationen finden Sie unter Debuggen verwenden WebInspector.
Erstellen einer Releaseversion
Standardmäßig läuft der cordova build
Befehl erstellt eine vorzeichenlose ...verlegt -Paketdatei geeignet zum Testen auf einem Gerät oder Simulator.
Sie müssen eine andere ausführen build
Befehl aus, um eine Release-Version zu erstellen, die für Verteilung durch BlackBerry Welt geeignet. Es ist nicht angewiesen auf die cordova
CLI-Tool, und stattdessen verwendet die folgende Syntax:
Unter Windows:
$ platforms\blackberry10\cordova\build.bat --release --keystorepass mysecret
Auf Mac/Linux:
$ platforms/blackberry10/cordova/build --release --keystorepass mysecret
Die --keystorepass
Option gibt das Kennwort, die Sie beim Konfigurieren des Computers zum Signieren definiert Anwendungen.