Menempatkan Aplikasi ke Tablet BlackBerry PlayBook

Aplikasi BlackBerry
HTML5 WebWorks
untuk Tablet
BlackBerry®
PlayBook™
Modul 4 - Mengetes,
menandatangani, dan
menempatkan aplikasi
Aplikasi BlackBerry HTML5 WebWorks
2
© 2012 Research In Motion Limited Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
Aplikasi BlackBerry HTML5 WebWorks
© 2012 Research In Motion Limited. Semua hak dilindungi. BlackBerry®, RIM®, Research In Motion®, SurePress™, SureType®
dan merek dagang, nama, dan logo terkait adalah properti dari Research In Motion Limited dan telah terdaftar dan/atau digunakan
di A.S. dan di negara-negara seluruh dunia.
Web Inspector adalah merek dagang dari Wintriss Engineering Corporation.; Windows adalah merek dagang dari Microsoft
Corporation; Windows Vista adalah merek dagang dari Microsoft Corporation. Semua merek dagang lainnya adalah properti dari
pemiliknya masing-masing.
Dokumentasi ini termasuk semua dokumentasi yang disatukan menurut referensi, seperti dokumentasi yang telah diberikan atau
disediakan melalui tautan atau dibuat bisa diakses "APA ADANYA" dan "SEBAGAIMANA ADANYA" dan tanpa syarat, dukungan,
jaminan, representasi, atau garansi apa pun oleh Research In Motion Limited dan perusahaan afiliasinya ("RIM") dan RIM tidak
bertanggung jawab terhadap segala kesalahan ketik, teknis, atau ketidakakuratan, kesalahan atau kelalaian lainnya dalam
dokumentasi ini. Demi melindungi kepemilikan RIM dan informasi tertutup dan/atau rahasia dagang, dokumentasi ini mungkin
menerangkan beberapa aspek teknologi RIM dalam istilah umum. RIM berhak mengganti informasi yang terkandung di dalam
dokumentasi ini secara berkala; walau demikian, RIM tidak berkomitmen untuk menyediakan penggantian, pembaruan,
penyempurnaan, atau penambahan lainnya pada dokumentasi ini bagi Anda secara tepat waktu atau bahkan tidak ada sama sekali.
Dokumentasi ini mungkin berisi referensi ke sumber informasi, perangkat keras atau perangkat lunak, produk atau layanan pihak
ketiga; termasuk berbagai komponen dan konten seperti konten yang dilindungi oleh hak cipta dan/atau situs Web pihak ketiga
(secara kolektif disebut "Produk dan Layanan Pihak Ketiga"). RIM tidak mengontrol dan tidak bertanggung jawab atas segala
Produk dan Layanan Pihak Ketiga, termasuk tetapi tidak terbatas pada konten, akurasi, kepatuhan hak cipta, kompatibilitas, kinerja,
jaminan mutu, legalitas, kelayakan, tautan atau aspek lainnya dari Produk dan Layanan Pihak Ketiga. Referensi ke Produk dan
Layanan Pihak Ketiga yang dimasukkan dalam dokumentasi ini tidak menyiratkan dukungan oleh RIM atau Produk dan Layanan
Pihak Ketiga atau pihak ketiga tersebut dengan cara apa pun.
KECUALI SEJAUH YANG DILARANG SECARA SPESIFIK OLEH HUKUM YANG BERLAKU DALAM YURISDIKSI ANDA, SEMUA
SYARAT, DUKUNGAN, JAMINAN, REPRESENTASI, ATAU GARANSI APA PUN, TERSURAT ATAU TERSIRAT, TERMASUK
TANPA BATASAN, SEGALA SYARAT, DUKUNGAN, JAMINAN, REPRESENTASI ATAU GARANSI DURABILITAS, KESESUAIAN
UNTUK TUJUAN ATAU PENGGUNAAN TERTENTU, DAYA JUAL, KUALITAS DAYA JUAL, NON-PELANGGARAN, KUALITAS
KEPUASAN, ATAU HAK, ATAU YANG TIMBUL DARI UNDANG-UNDANG ATAU KEBIASAAN ATAU PERBUATAN YANG
BERKAITAN DENGAN ATAU PENGGUNAAN DAGANG, ATAU BERKAITAN DENGAN DOKUMENTASI ATAU PENGGUNAANNYA,
ATAU KINERJA ATAU NON-KINERJA DARI SEGALA PERANGKAT LUNAK, PERANGKAT KERAS, LAYANAN, ATAU SEGALA
PRODUK DAN LAYANAN PIHAK KETIGA YANG DISEBUTKAN DI SINI, DENGAN INI DIKECUALIKAN. ANDA JUGA MUNGKIN
MEMPUNYAI HAK LAINNYA YANG BERBEDA MENURUT NEGARA BAGIAN ATAU PROVINSI. BEBERAPA YURISDIKSI
MUNGKIN TIDAK MENGIZINKAN PENGECUALIAN ATAU PEMBATASAN TERHADAP JAMINAN DAN SYARAT TERSIRAT.
SEJAUH DIIZINKAN OLEH HUKUM, SEGALA GARANSI ATAU SYARAT TERSIRAT YANG BERKAITAN DENGAN DOKUMENTASI
SEJAUH IA TIDAK BISA DIKECUALIKAN SEBAGAIMANA DITETAPKAN DI ATAS, NAMUN BISA DIBATASI, DENGAN INI DIBATASI
SEMBILAN PULUH (90) HARI SEJAK TANGGAL ANDA MEMPEROLEH DOKUMENTASI ATAU BARANG YANG MENJADI POKOK
MATERI KLAIM.
SEJAUH MAKSIMAL YANG DIIZINKAN OLEH HUKUM YANG BERLAKU DALAM YURISDIKSI ANDA, DALAM KEADAAN APA
PUN RIM TIDAK BERTANGGUNG JAWAB TERHADAP SEGALA JENIS KERUGIAN YANG BERKAITAN DENGAN
DOKUMENTASI INI ATAU PENGGUNAANNYA, ATAU KINERJA ATAU NON-KINERJA DARI SEGALA PERANGKAT LUNAK,
PERANGKAT KERAS, LAYANAN, ATAU SEGALA PRODUK DAN LAYANAN PIHAK KETIGA YANG DISEBUTKAN DI SINI
TERMASUK TANPA BATASAN PADA KERUGIAN BERIKUT: KERUGIAN LANGSUNG, KONSEKUENSIAL, CONTOH,
INSIDENTAL, TIDAK LANGSUNG, KHUSUS, AKIBATNYA, ATAU KERUGIAN SERIUS, KERUGIAN AKIBAT KEHILANGAN LABA
ATAU PENDAPATAN, KEGAGALAN MEWUJUDKAN PENGHEMATAN YANG DIPERKIRAKAN, INTERUPSI BISNIS,
HILANGNYA INFORMASI BISNIS, HILANGNYA KESEMPATAN BISNIS, ATAU KERUSAKAN ATAU HILANGNYA DATA,
KEGAGALAN MENGIRIM ATAU MENERIMA DATA, MASALAH YANG BERKAITAN DENGAN SEGALA APLIKASI YANG
DIGUNAKAN BERSAMA PRODUK ATAU LAYANAN RIM, BIAYA AKIBAT WAKTU MENGANGGUR, KERUGIAN DARI
PEMANFAATAN PRODUK ATAU LAYANAN RIM ATAU BAGIAN DARINYA ATAU LAYANAN AIRTIME, BIAYA BARANG
PENGGANTI, BIAYA PENUTUP, FASILITAS ATAU LAYANAN, BIAYA MODAL, ATAU KERUGIAN FINANSIAL SERUPA
LAINNYA, BAIK KERUGIAN TERSEBUT TELAH DIPERKIRAKAN ATAU PUN TIDAK, DAN SEKALIPUN RIM TELAH DIBERI
TAHU MENGENAI KEMUNGKINAN KERUGIAN DEMIKIAN.
SEJAUH MAKSIMAL YANG DIIZINKAN OLEH HUKUM YANG BERLAKU DALAM YURISDIKSI ANDA, RIM TIDAK MEMPUNYAI
KEWAJIBAN, TUGAS, ATAU TANGGUNGAN APA PUN DALAM KONTRAK, KESALAHAN, ATAU LAINNYA KEPADA ANDA,
TERMASUK SEGALA KEWAJIBAN KARENA KELALAIAN ATAU KEWAJIBAN HUKUM MENYELURUH.
PEMBATASAN, PENGECUALIAN, DAN SANGGAHAN YANG BERLAKU DI SINI: (A) TANPA TERGANTUNG PADA SIFAT
PENYEBAB TINDAKAN, TUNTUTAN, ATAU TINDAKAN ANDA; TERMASUK NAMUN TIDAK TERBATAS PADA PELANGGARAN
KONTRAK, KELALAIAN, KESALAHAN, KEWAJIBAN HUKUM MENYELURUH ATAU TEORI HUKUM LAINNYA DAN
PELANGGARAN DASAR ATAU KEGAGALAN DARI TUJUAN DASAR PERJANJIAN INI ATAU SEGALA PERBAIKAN YANG
DIMUAT DI SINI; DAN (B) PADA RIM DAN PERUSAHAAN AFILIASINYA, PENERUS MEREKA, ORANG YANG DITUNJUK,
AGEN, PEMASOK (TERMASUK PENYEDIA LAYANAN AIRTIME), DISTRIBUTOR RESMI RIM (JUGA TERMASUK PENYEDIA
LAYANAN AIRTIME) DAN PARA DIREKTUR, KARYAWAN, DAN KONTRAKTOR INDEPENDEN MEREKA.
SELAIN PEMBATASAN DAN PENGECUALIAN YANG DITETAPKAN DI ATAS, DALAM KEADAAN APA PUN DIREKTUR,
KARYAWAN, AGEN, DISTRIBUTOR, PEMASOK, KONTRAKTOR INDEPENDEN RIM ATAU AFILIASI RIM TIDAK
BERTANGGUNG JAWAB ATAS SEGALA YANG TIMBUL DARI ATAU BERKAITAN DENGAN DOKUMENTASI.
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
3
Aplikasi BlackBerry HTML5 WebWorks
Sebelum berlangganan, menginstal, atau menggunakan segala Produk dan Layanan Pihak Ketiga, Anda bertanggung jawab
memastikan bahwa penyedia layanan airtime Anda telah setuju untuk mendukung semua fitur mereka. Beberapa penyedia layanan
airtime mungkin tidak menawarkan fungsionalitas untuk menjelajahi Internet dengan berlangganan BlackBerry® Internet Service.
Tanyakan pada penyedia layanan Anda untuk mengetahui status fungsionalitas ini, pengaturan jelajah, paket layanan dan fiturnya.
Instalasi atau penggunaan Produk dan Layanan Pihak Ketiga bersama produk dan layanan RIM mungkin memerlukan satu atau
beberapa paten, merek dagang, hak cipta, atau lisensi lainnya untuk menghindari pelanggaran izin pihak ketiga. Anda bertanggung
jawab penuh untuk menentukan akan menggunakan, Produk dan Layanan Pihak Ketiga dan apakah perlu lisensi pihak ketiga untuk
melakukannya. Jika diperlukan, Anda bertanggung jawab untuk mendapatkannya. Anda tidak boleh menginstal atau menggunakan
Produk dan Layanan Pihak Ketiga hingga diperoleh semua lisensi yang diperlukan. Segala Produk dan Layanan Pihak Ketiga yang
disediakan bersama produk dan layanan RIM disediakan untuk kenyamanan Anda dan disediakan "APA ADANYA" tanpa syarat
tersurat atau tersirat, dukungan, garansi, representasi, atau jaminan dalam bentuk apa pun oleh RIM dan RIM tidak bertanggung
jawab atas apa pun, dalam kaitan tersebut. Penggunaan Anda atas Produk dan Layanan Pihak Ketiga diatur oleh dan tunduk pada
ketentuan yang Anda setujui pada lisensi lain dan perjanjian lainnya yang berlaku dengan pihak ketiga, kecuali sejauh yang
dicantumkan secara tersurat oleh suatu lisensi atau perjanjian lainnya dengan RIM.
Beberapa fitur tertentu yang dijelaskan dalam dokumentasi ini memerlukan versi minimal dari BlackBerry® Enterprise Server
Software, BlackBerry® Desktop Software, dan/atau BlackBerry® Device Software dan mungkin memerlukan produk pengembangan
tambahan atau Produk dan Layanan Pihak Ketiga untuk akses ke aplikasi perusahaan.
Produk ini menyertakan perangkat lunak yang dikembangkan oleh Apache Software Foundation (http://www.apache.org/) dan/atau
atau yang dilisensikan menurut Apache License, Versi 2.0 (http://www.apache.org/licenses/). Untuk informasi lainnya, lihat file
NOTICE.txt yang disertakan bersama perangkat lunak. Kecuali jika diharuskan oleh hukum yang berlaku atau dalam perjanjian
tertulis, perangkat lunak yang didistribusikan di bawah Lisensi adalah didistribusikan atas DASAR "APA ADANYA", TANPA
GARANSI ATAU SYARAT APA PUN, baik tersurat maupun tersirat. Lihat Lisensi untuk bahasa tertentu yang mengatur perizinan
dan pembatasan menurut Lisensi.
Ketentuan penggunaan produk atau layanan RIM ditentukan dalam lisensi terpisah atau perjanjian lainnya dengan RIM yang
berlaku. TIDAK ADA DALAM DOKUMENTASI INI YANG BERMAKSUD MENGGANTIKAN SEGALA PERJANJIAN TERTULIS
ATAU JAMINAN YANG DISEDIAKAN OLEH RIM UNTUK SEBAGIAN DARI PRODUK ATAU LAYANAN RIM SELAIN
DOKUMENTASI INI.
4
© 2012 Research In Motion Limited Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
Aplikasi BlackBerry HTML5 WebWorks
Tentang panduan lab ini
Materi ini dirancang berdasarkan asumsi bahwa semua prasyarat yang diperlukan telah dilengkapi oleh
peserta sebelum mencoba latihan ini.
Agar tidak berpengaruh negatif pada kualitas pengalaman belajar, RIM menyarankan peserta melengkapi
prasyarat.
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
5
Aplikasi BlackBerry HTML5 WebWorks
Daftar Isi
Tentang panduan lab ini ................................................. 5
Ringkasan ............................................................ 7
Pendahuluan ....................................................... 7
Sasaran ........................................................... 7
Prasyarat yang Disarankan ............................................. 7
Mengapa harus menandatangani aplikasi Anda?.............................. 7
Mengonfigurasi Komputer untuk Menandatangani Aplikasi ...................... 8
Langkah-langkah Mengonfigurasi Komputer untuk Menandatangani Aplikasi ......... 8
Pentingnya Mencadangkan File .......................................... 9
Menandatangani Aplikasi Anda ........................................... 10
Menempatkan Aplikasi yang Belum Ditandatangani ke Tablet BlackBerry PlayBook.... 11
Menggunakan Token Debug ........................................... 11
Sebelum Membuat Token Debug ........................................ 11
Membuat Token Debug ............................................... 11
Menginstal Token Debug .............................................. 12
Menyetel Token Debug ............................................... 12
Memaketkan Aplikasi Menggunakan Token Debug ........................... 13
Menempatkan Aplikasi ke Tablet BlackBerry PlayBook ........................ 13
Melakukan Debug Menggunakan Alat Web Inspector .......................... 15
Alasan menggunakan alat Web Inspector .................................. 15
Cara Mengaktifkan Alat Web Inspector untuk Browser BlackBerry Tablet OS ........ 15
Menggunakan Alat Web Inspector untuk Memuat Konten Langsung dari
BlackBerry Tablet OS ................................................ 15
Ringkasan dan Pelajaran Lebih Lanjut...................................... 17
Ringkasan ........................................................ 17
Sumber Daya Tambahan .............................................. 17
6
© 2012 Research In Motion Limited Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
Aplikasi BlackBerry HTML5 WebWorks
Ringkasan
Pendahuluan
Untuk menempatkan aplikasi BlackBerry HTML5 WebWorks ke BlackBerry App World™, Anda perlu
menandatanganinya. Modul ini akan memandu Anda melakukan langkah-langkah yang diperlukan untuk
mengetes, menandatangani, dan menempatkan aplikasi BlackBerry HTML5 WebWorks Anda.
Sasaran
Dalam modul ini peserta akan diperkenalkan dengan konsep-konsep berikut:
Pentingnya menandatangani aplikasi
Cara mengonfigurasi komputer untuk menandatangani aplikasi
Pentingnya mencadangkan file
Cara menandatangani aplikasi
Cara memaketkan dan menempatkan aplikasi yang belum ditandatangani ke tablet dengan
menggunakan token debug
Cara debug aplikasi pada tablet BlackBerry PlayBook dengan menggunakan alat Web
Inspector™ pada browser PlayBook
Prasyarat yang Disarankan
Untuk modul ini, prasyarat keahlian dan bidang pengetahuan yang disarankan adalah:
Pembuatan lab “Hello World” dari modul “Modul 3 - Menulis Aplikasi Pertama Anda untuk
Tablet BlackBerry PlayBook”
Unduh dan instal BlackBerry® WebWorks™ SDK dan Tablet BlackBerry PlayBook dari modul
“Modul 2 – Instalasi Alat Pengembangan HTML5 WebWorks”
Berpengalaman menggunakan alat Windows Command Prompt
Mengapa harus menandatangani aplikasi Anda?
Agar Anda bisa mendistribusikan aplikasi untuk digunakan pada tablet BlackBerry PlayBook, aplikasi
harus ditandatangani. Dengan menandatangani aplikasi, RIM akan dapat memvalidasi kemampuan dan
pengenal unik aplikasi. Menandatangani aplikasi juga akan mengikat identitas pengembang ke aplikasi
tersebut sebagai bukti penulisannya. Alat penandatanganan yang disertakan bersama BlackBerry
WebWorks SDK akan menambahkan nilai hash kriptografik ke paket aplikasi (file .bar) selama proses
penandatanganan. File hash membantu memastikan penulis aplikasi kepada pengguna dan ke sistem
operasi (OS).
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
7
Aplikasi BlackBerry HTML5 WebWorks
Mengonfigurasi Komputer untuk
Menandatangani Aplikasi
Sebelum menempatkan sebuah aplikasi pada tablet BlackBerry PlayBook, komputer milik pengembang
mungkin perlu dikonfigurasi dahulu. Konfigurasi memungkinkan pengembang untuk meminta dan
menginstal token debug. Tugas-tugas konfigurasi ini merupakan penyetelan pertama kali, dan hanya perlu
dilakukan sekali.
Langkah-langkah Mengonfigurasi Komputer untuk
Menandatangani Aplikasi
Sebelum memulai konfigurasi, Anda perlu meminta kunci penandatanganan kode. Kunci
penandatanganan kode bisa diminta dengan mengisi formulir Web yang sesuai di sini.
Ingat PIN yang Anda berikan. PIN melindungi Anda terhadap penggunaan kunci
penandatanganan kode oleh pihak yang tidak sah, sehingga tetap aman.
Setelah aplikasi Anda diterima, Anda akan menerima dua file pendaftaran “.csj” dalam dua pesan email
terpisah. Pesan-pesan ini akan memberikan informasi tambahan tentang setiap file dan kegunaannya.
Simpan file ini ke lokasi yang aman pada komputer Anda. File akan diganti namanya seperti berikut:
client-RDK-xxxxxx.csj - Inilah file yang Anda gunakan untuk menandatangani aplikasi dan
mempublikasikannya ke etalase BlackBerry App World
client-PBDT-xxxxx.csj - Inilah file yang digunakan untuk membuat token debug yang bisa
Anda gunakan untuk mengetes aplikasi pada tablet
Ingatlah bahwa file ini hanya bisa digunakan sekali dan token debug hanya untuk 30 hari. Setelah 30 hari,
token debug harus dibuat kembali. Perangkat BlackBerry secara fisik akan menyimpan token debug
selama 10 hari.
Berikutnya, daftarkan pada Otoritas Penandatanganan RIM menggunakan file pendaftaran “.csj” untuk
penandatanganan aplikasi. Dari folder “\bbwp\blackberry-tablet-sdk\bin” yang berada dalam folder
instalasi BlackBerry WebWorks SDK, jalankan alat penandatanganan “.bar” untuk mendaftar pada server
otoritas penandatanganan.
Dari Konfirmasi Perintah, ketikkan:
blackberry-signer -register -csjpin <csj pin>
-storepass <KeystorePassword> <client-RDK-xxxxxx.csj file>
<client-PBDT-xxxxx.csj file>
<csj pin> adalah PIN yang ditentukan pada formulir Web saat pengembang meminta kunci
penandatanganan kode
8
© 2012 Research In Motion Limited Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
Aplikasi BlackBerry HTML5 WebWorks
<Keystore password> adalah kata sandi yang ditentukan untuk penyimpanan kunci
<client-RDK-xxxxxx.csj file> adalah aplikasi yang menandatangani file “.csj” yang dikirim melalui email
setelah pendaftaran
<client-PBDT-xxxxxx.csj file> adalah token debug file “.csj” yang dikirim melalui email setelah
pendaftaran
Perintah ini akan membuat file berikut: author.p12, barsigner.csk, dan barsigner.db.
Pentingnya Mencadangkan File
File “.csj” yang digunakan untuk menginstal kunci penandatanganan kode hanya bisa digunakan sekali.
Semua akan dinonaktifkan setelah instalasi berhasil. Mencadangkan kunci penandatanganan kode Anda
setelah diinstal merupakan hal yang penting. Kunci penandatanganan kode bisa dipulihkan ke komputer
tempat menginstalnya semula atau ke komputer lain, karena Anda bisa mentransfer kunci
penandatanganan kode ke beberapa komputer dan menandatangani salah satu komputer tersebut.
File barsigner berada dalam direktori yang tadi diuraikan. File ini disimpan di lokasi terpusat di direktori
profil milik pengguna dan digunakan oleh semua alat pengembangan BlackBerry Tablet OS. Lokasinya
berbeda-beda, berdasarkan pada sistem operasi yang digunakan. Anda perlu mencadangkan file
“author.p12.barsigner.csk”, dan” barsigner.db”. Untuk memulihkan kunci penandatanganan kode, salin
kembali file ke direktori yang diuraikan di bawah ini.
Windows® XP: %HOMEPATH%\Local Settings\Application Data\Research In Motion
Windows Vista® and Windows® 7: %HOMEPATH%\AppData\Local\Research In Motion
Secara default, %HOMEPATH% adalah C:\Documents and Settings pada Windows XP dan C:\Users
pada Windows Vista dan Windows 7. Untuk memulihkan kunci penandatanganan kode Anda, salin
kembali file ke direktori yang diuraikan di atas.
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
9
Aplikasi BlackBerry HTML5 WebWorks
Menandatangani Aplikasi Anda
Pengembang bisa menandatangani aplikasi BlackBerry HTML5 WebWorks mereka di saat yang sama
dengan kompilasinya, dengan menggunakan sintaks berikut dengan BlackBerry WebWorks Packager:
bbwp <archive_file> -g <KeystorePassword> -buildId <num> -o
<output_location>
<archive_file> adalah nama dan lokasi file arsip aplikasi
<KeystorePassword> adalah kata sandi yang Anda tentukan untuk penyimpanan kunci
<num> adalah nomor versi kompilasi untuk aplikasi Anda. Biasanya, nomor ini hasil penambahan dari
versi yang telah ditandatangani sebelumnya.
<output_location> adalah lokasi tempat yang Anda inginkan untuk file output yang akan dibuat
Inilah contoh sintaks penandatanganan kode:
bbwp C:\myarchive.zip -g myKeystorePassword -buildId 10 -o C:\myoutputdir
Setelah aplikasi ditandatangani, pengembang bisa mempublikasikannya ke etalase BlackBerry App World.
10
© 2012 Research In Motion Limited Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
Aplikasi BlackBerry HTML5 WebWorks
Menempatkan Aplikasi yang Belum
Ditandatangani ke Tablet BlackBerry
PlayBook
Aplikasi yang belum ditandatangani juga bisa ditempatkan ke tablet BlackBerry PlayBook dengan
menggunakan token debug. Token debug memungkinkan pengembang memisahkan proses pembuatan
dan publikasi aplikasi. Dengan token debug, pengembang bisa membuat dan mengetes aplikasi, kemudian
menyerahkan aplikasi tersebut ke klien/pelanggan mereka untuk penandatanganan dan publikasi.
Menggunakan Token Debug
Menjalankan aplikasi yang belum ditandatangani dengan menggunakan token debug akan memungkinkan
pengembang menghindari:
Mengganti nomor versi aplikasi
Mengakses Internet
Mengekspor rilis kompilasi aplikasi
Token debug harus dibuat oleh perorangan atau organisasi yang mempunyai izin untuk menandatangani
aplikasi BlackBerry Tablet OS. Untuk meminta izin menandatangani aplikasi, isilah formulir Web yang
sesuai. Setelah permintaan untuk menandatangani aplikasi disetujui, Anda akan menerima dua file “.csj”
yang dikirim melalui dua email terpisah. Satu file memungkinkan Anda mengonfigurasi komputer untuk
menandatangani aplikasi dan file lainnya memungkinkan pengembang untuk membuat token debug.
Setelah pengembang menerima file pendaftaran “.csj”, mereka bisa mengonfigurasi komputer untuk
membuat token debug. Bila pengembang membuat token debug, mereka harus menentukan PIN untuk
setiap tablet di mana nanti token bisa digunakan. Mereka bisa mendistribusikan token debug yang mereka
buat kepada para pengembang untuk diinstal pada tablet, atau menginstalnya sendiri. Ingatlah bahwa
seorang pengembang dibatasi hingga total 100 PIN tablet untuk seluruh token debug aktif mereka. Jika
Anda membuat token debug yang menangani lebih dari 100 PIN, Anda harus menunggu berakhirnya
beberapa token debug sebelum Anda bisa membuatnya lagi. Token debug berlaku selama 30 hari. Bila
token debug berakhir, BlackBerry Tablet OS tidak lagi mengizinkan dijalankannya aplikasi yang belum
ditandatangani yang menggunakan token itu.
Sebelum Membuat Token Debug
Komputer milik pengembang harus dikonfigurasi untuk meminta token debug sebelum mulai mengetes
aplikasi yang belum ditandatangani ke tablet. Pelajari hal lainnya tentang “Menandatangani aplikasi tablet
Anda”.
Membuat Token Debug
Di konfirmasi perintah, arahkan ke subfolder bin tempat Anda menginstal BlackBerry WebWorks SDK
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
11
Aplikasi BlackBerry HTML5 WebWorks
C:\ProgramFiles\ResearchInMotion\...
Untuk membuat token debug bagi perangkat Anda, gunakan sintaks dan nilai berikut bagi opsi baris
perintah:
blackberry-debugtokenrequest -storepass <KeystorePassword> devicepin
<PIN tablet>
<debug_token_file_name.bar>
Kata
Sandi Penyimpanan
Kunci ditetapkan
saat kunci penandatanganan kode dibuat selama
konfigurasi proses komputer.
PIN tablet adalah PIN tablet BlackBerry PlayBook tempat Anda ingin menginstal token debug ini. Ini
bisa ditemukan dengan mengklik ikon
, pada menu “Tentang” dan opsi “Perangkat Keras”.
File debug_token_file_name.bar adalah nama file token debug yang akan dibuat. Jika path tidak
ditentukan karena tidak menyertakan nama file, alat blackberry-debugtokenrequest akan menghapus
direktori yang ditentukan dan tidak membuat token debug.
File token debug harus berakhiran “.bar”. Jika Anda menentukan nama file yang ada, alat blackberrydebugtokenrequest akan menghapus file sebelum alat tersebut membuat token debug.
Setelah mengetikkan sintaks ke dalam konfirmasi perintah, pengembang sekarang bisa mendistribusikan
atau menginstal token debug yang telah dibuat.
Menginstal Token Debug
Pada perangkat keras tablet BlackBerry PlayBook, buka opsi tablet BlackBerry PlayBook di sudut kanan
atas layar “Awal”. Pada tablet BlackBerry PlayBook Anda, tekan ikon gir.
1. Dalam daftar opsi, tekan “Keamanan”
2. Dalam daftar opsi keamanan, tekan “Mode Pengembangan”
3. Pilih “Unggah token debug”
4. Pada konfirmasi perintah, masukkan perintah berikut:
blackberry-deploy -installDebugToken <path to debug token> -device <IP
address of tablet> -password <tablet password>
Menyetel Token Debug
Setelah menginstal token debug, edit file bbwp.properties dan sertakan path token debug dengan
menggunakan tag <debug_token> untuk menyetel token debug. File ini berada dalam folder “bbwp/bin”.
Sintaksnya adalah sebagai berikut:
<?xml version="1.0" encoding="UTF-8"?> <wcp> <additional>quiet</additional> <java>C:\Program Files\Research In Motion\BlackBerry
WebWorks SDK for TabletOS 2.1.0\jre</java>
<wcp_template>AirAppTemplates</wcp_template>
<air_template>AirAppTemplates</air_template> <tablet_sdk>C:\Program
Files\Research In Motion\BlackBerry
WebWorks
for Menandatangani,
TabletOS Menempatkan
12
© 2012 Research In Motion Limited
Modul 4 –SDK
Mengetes,
2.1.0\bbwp\blackberry-tablet-sdk</tablet_sdk>
v0.01
<extension_repository>ext</extension_repository>
<debug_token>C:\my_debug_token.bar</debug_token> </wcp>
Aplikasi BlackBerry HTML5 WebWorks
Pengembang sekarang bisa memuat aplikasi berkemampuan debug pada perangkat tablet BlackBerry
tanpa harus menandatanganinya. Dalam tag <debug_token>, masukkan nama file dan lokasi menginstal
token debug.
Memaketkan Aplikasi Menggunakan Token Debug
Untuk menjalankan aplikasi yang belum ditandatangani dengan menggunakan token debug, sertakan
parameter “-d” saat mengkompilasi dan memaketkan aplikasi. Parameter ini menyetel mode pengembang
untuk token debug. Informasi token debug hanya digunakan jika kedua hal berikut adalah benar:
Ada elemen <debug_token> dalam file “bbwp.properties” dan berisi nama path lengkap dari
file token debug yang sah
Penandatanganan belum ditentukan saat Anda memaketkan aplikasi
Di konfirmasi perintah, arahkan ke folder instalasi untuk BlackBerry WebWorks Packager. Path file
mungkin berbeda-beda berdasarkan tempat Anda menginstal BlackBerry WebWorks Packager. Ketikkan
sintaks berikut:
cd C:\ProgramFiles\ResearchInMotion\BlackBerryWebWorks SDK for
TabletOS<x.x.x.x>\bbwp
“xxxx” menyatakan versi BlackBerry HTML5 WebWorks SDK yang telah diunduh dan diinstal. Selama
proses kompilasi, BlackBerry WebWorks Packager menampilkan beberapa pesan dan menunjukkan
kompilasi berhasil jika arsip aplikasi tidak berisi kesalahan.
Kompilasilah aplikasi dengan menggunakan sintaks berikut:
bbwp [drive:][path]archive -d [-o dir]
Misalnya: bbwp C:\myapp\myarchive.zip –d –o
C:\myapp\output
Jika berhasil, proses ini akan membuat file .bar dalam folder yang ditentukan oleh parameter –o. Jika
tidak ada parameter –o yang ditentukan, file .bar dibuat dalam subfolder “bin” yang berada dalam lokasi
folder yang sama dengan file arsip. Jika tidak ada parameter –o yang ditentukan, file .bar dibuat dalam
subfolder “bin” yang berada dalam lokasi folder yang sama dengan file arsip. File “.bar” sekarang bisa
ditempatkan ke tablet BlackBerry PlayBook.
Menempatkan Aplikasi ke Tablet BlackBerry PlayBook
1. Hidupkan “Mode Pengembangan” pada tablet BlackBerry PlayBook
2. Memperoleh alamat IP tablet BlackBerry PlayBook
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
13
Aplikasi BlackBerry HTML5 WebWorks
3. Di konfirmasi perintah, arahkan ke folder bin instalasi untuk BlackBerry WebWorks Packager
4. Tempatkan aplikasi dengan menggunakan sintaks berikut:
blackberry-deploy -installApp -password <tablet password> -device
<IP_address> -package <BAR file path>
Misalnya: blackberry-deploy -installApp -password playbook -device
111.111.111.11 –package C:\myapp\output\hw.bar
Untuk menggunakan alat Web Inspector buat melakukan debug atas aplikasi, gunakan operator perintah
“–d” dalam sintaks di atas saat mengkompilasi aplikasi. Misalnya: c:\myApp\hw.zip –d
14
© 2012 Research In Motion Limited Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
Aplikasi BlackBerry HTML5 WebWorks
Melakukan Debug Menggunakan Alat Web
Inspector
Alat Web Inspector adalah alat pengembangan untuk melakukan debug dan membuat profil bagi konten
Web yang disertakan sebagai bagian dari mesin render WebKit. Ini termasuk beragam fitur dan
kemampuan, seperti pemeriksaan, pembuatan profil, integrasi konsol, dan lainnya.
Alasan menggunakan alat Web Inspector
Yang mendorong para pengembang Web seluler menggunakan alat Web Inspector adalah karena mudah
diakses untuk digunakan bersama konten yang dimuat langsung dalam browser desktop berkemampuan
WebKit, namun tidak diperlukan untuk konten yang telah dimuat pada perangkat seluler. Pengembang
sekarang bisa menggunakan alat Web Inspector untuk melakukan debug dan membuat profil konten Web
langsung dan aplikasi HTML5 WebWorks yang berjalan pada tablet BlackBerry PlayBook atau simulator.
Alat Web Inspector adalah salah satu utilitas paling lengkap dan andal yang bisa digunakan para
pengembang untuk memecahkan masalah dan mengoptimalkan konten Web mereka.
Cara Mengaktifkan Alat Web Inspector untuk Browser
BlackBerry Tablet OS
1. Pilih tab “Privasi dan Keamanan” dari layar “opsi browser” pada tablet BlackBerry PlayBook Anda
2. Ubah “Aktifkan Web Inspector” ke “HIDUP”
3. Bila dikonfirmasi, masukkan kata sandi perangkat tablet BlackBerry PlayBook Anda. Setelah
Anda memasukkan kata sandi, alat Web Inspector akan diaktifkan.
Menggunakan Alat Web Inspector untuk Memuat Konten
Langsung dari BlackBerry Tablet OS
1. Buka browser Web desktop seperti Chrome, Firefox, Safari, atau Internet Explorer
2. Dalam bilah alamat, masukkan alamat IP tablet BlackBerry PlayBook yang menjadi target dan
port 1337 (mis. http://198.168.1.7:1337).
3. Anda akan dikonfirmasi dengan daftar judul halaman yang telah dimuat ke memori oleh alat Web
Inspector (seperti konten browser atau aplikasi BlackBerry HTML5 WebWorks).
4. Klik salah satu judul halaman untuk memulai dengan menggunakan alat Web Inspector guna
melakukan debug dan membuat profil konten Web Anda.
Catatan: Aplikasi HTML5 WebWorks hanya ada dalam indeks Web Inspector jika telah dikompilasi
(menggunakan konfirmasi perintah Windows) bersama operator baris perintah “-d” dengan menggunakan
langkah-langkah yang diterangkan dalam “Menempatkan Aplikasi ke Tablet”
Untuk informasi tambahan, harap lihat ke http://devblog.blackberry.com/2011/06/debugging-blackberryweb-apps/.
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
15
Aplikasi BlackBerry HTML5 WebWorks
16
© 2012 Research In Motion Limited Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
Aplikasi BlackBerry HTML5 WebWorks
Ringkasan dan Pelajaran Lebih Lanjut
Ringkasan
Dalam modul ini, Anda membahas topik berikut:
Pentingnya menandatangani aplikasi Anda
Mengonfigurasi komputer untuk menandatangani aplikasi
Pentingnya mencadangkan file Anda
Cara menandatangani aplikasi
Cara menempatkan aplikasi yang belum ditandatangani
Cara membuat dan menginstal token debug
Memaketkan dan menempatkan aplikasi yang belum ditandatangani ke tablet
Menggunakan alat Web Inspector di browser PlayBook untuk melakukan debug
Sumber Daya Tambahan
Berikutnya, mencari jalan untuk memadukan berbagai fitur tambahan ke aplikasi Anda, seperti:
-
Geo-lokasi
Monetisasi dan pembayaran
Elemen antarmuka pengguna (UI) lanjutan
Informasi tambahan, termasuk kode contoh, tentang memadukan berbagai fitur ini ke sebuah aplikasi,
bisa ditemukan pada situs Web BlackBerry Jam.
Jika aplikasi Anda sudah siap, pelajari hal lainnya tentang mendistribusikan aplikasi Anda melalui
BlackBerry App World.
Untuk informasi lainnya tentang penandatanganan kode, harap lihat Kunci Penandatanganan Kode: Dulu,
Sekarang, dan Akan Datang.
Modul 4 – Mengetes, Menandatangani, Menempatkan
v0.01
© 2012 Research In Motion Limited
17