Menampilkan Battery Status pada Cordova

Artikel kali ini akan menjelaskan cara menampilkan status baterai (battery status) pada perangkat mobile dengan menggunakan API Cordova.

Event yang berkaitan dengan perubahan status baterai adalah batterystatus. Event ini akan terpicu oleh kondisi berikut ini:

  1. Terjadi perubahan kapasitas baterai sedikitnya 1 persen.
  2. Perangkat disambungkan ke atau dicabut dari pengsi baterai (battery charger).

Handler dari status baterai adalah sebuah objek yang memiliki dua atribut:

  1. level (Number):

Persentase dari kapasitas baterai yang bernilai 0-100.

  1. isPlugged (Boolean):

TRUE = perangkat disambungkan ke pengsi baterai

FALSE= perangkat dicabut dari pengsi baterai

 

Sebelum memulai dengan pembuatan aplikasi ini, pastikan komputer kerja Anda telah dipersiapkan dengan API Cordova dan software yang dibutuhkan lainnya. Untuk mempersiapkan lingkungan pengembangan Cordova, silakan membaca artikel “Memulai Cordova” yang dibuat penulis sebelumnya.

 

Catatan:

  • Pada artikel ini platform yang digunakan hanya Android, sehingga semua penjelasan yang diuraikan mengacu pada platform tersebut.
  • Kode program dari contoh aplikasi telah disertakan bersama artikel ini sehingga Anda bisa menggunakannya sambil membaca penjelasan agar lebih mudah memahaminya.

Membuat projek baru

  1. Buat sebuah folder kerja untuk projek Cordova. Pada contoh ini folder tersebut diletakkan pada folder ..\Cordova\workshop. Anda bebas menentukan nama dan lokasi folder tersebut.
  2. Buka sebuah command shell dan masuk ke dalam folder kerja di atas. Pada contoh ini akan dibuat sebuah projek bernama battery.
  3. Jalankan perintah berikut ini:

cordova create battery com.excercise.battery BatteryStatus

Setelah projek berhasil dibuat, file-file projek tersebut akan disimpan di dalam folder ..\Cordova\workshop\battery. Silakan menuju folder tersebut dan melihat folder-folder dan file-file apa saja yang sudah terbentuk.

  1. Tambahkan dukungan untuk platform Android. Silakan masuk ke folder ..\Cordova\workshop\ battery dan jalankan perintah:

cordova platforms add android

  1. Tambahkan plugin-plugin yang dibutuhkan. Silakan masuk ke folder ..\Cordova\workshop\battery dan jalankan perintah:

battery-status-cordova01

  1. Sesuaikan versi API Android yang terinstal pada komputer kerja dengan versi target yang akan dibuat. Pada API Cordova yang digunakan oleh penulis, secara default target yang ditetapkan adalah android-22. Namun karena pada komputer kerja penulis versi API Android yang terinstal adalah 21 maka bagian ini harus diedit secara manual.

Buka file project.properties di dalam folder ..\workshop\battery\platforms\android. Ubah versi API pada bagian target dengan yang sesuai.

Buka file AndroidManifest.xml di dalam folder ..\workshop\battery\platforms\ android. Ubah versi API pada bagian android:targetSdkVersion dengan yang sesuai.

Mempersiapkan jQuery

Langkah ini bertujuan untuk memperindah tampilan dan tidak berhubungan dengan fungsi inti dari aplikasi yang sedang dibuat.

jQuery dibutuhkan untuk digunakan bersama-sama jQuery Mobile. Versi jQuery yang digunakan pada contoh program ini adalah jquery-1.11.3. Dianjurkan untuk tidak menggunakan jQuery 2.x karena terbatasnya versi browser yang didukung oleh versi tersebut.

  1. Silakan mengunduh jQuery dari situs beralamat:

https://jquery.com/download/

  1. Silakan menyalin file jquery-1.11.3.js ke dalam folder ..\battery\www\js.

Mempersiapkan jQuery Mobile

Pada contoh ini framework jQuery Mobile akan digunakan untuk memperindah tampilan antar muka (User Interface= UI). jQuery Mobile adalah UI framework yang sangat populer dan cukup mudah digunakan. Versi jQuery Mobile yang digunakan pada contoh program ini adalah jquery.mobile-1.4.5, namun demikian tidak ada batasan untuk menggunakan versi yang lebih baru.

  1. Silakan mengunduh jQuery Mobile dari situs beralamat:

https://jquerymobile.com/

  1. Silakan menyalin file mobile-1.4.5.min.js ke dalam folder ..\battery\www\js.
  2. Silakan menyalin file mobile-1.4.5.min.css ke dalam folder ..\battery\www\css.

 

Mengedit file html

Buka file index.html yang ada di dalam folder ..\battery\www. Hapus semua skrip HTML yang asli dan ganti dengan skrip yang baru berikut ini.

 

Mempersiapkan file-file gambar

File-file gambar ada di dalam folder ..\battery\www\img.

Mempersiapkan file icon

Sebuah icon baru telah dipersiapkan untuk menggantikan icon standar dari aplikasi Cordova.

  1. Siapkan sebuah gambar dengan format PNG dan berukuran 96 x 96
  2. Pada folder projek aplikasi Cordova, silakan masuk ke sub-folder ..\platforms\android\res. Di situ akan dijumpai beberapa folder drawable dan drawable-xxx seperti pada gambar berikut ini.
  3. Hapus semua folder drawable-xxx dan tinggalkan sebuah folder bernama drawable. Dengan dihapusnya folder-folder drawable-xxx maka perangkat mobile selalu akan mencari gambar icon di dalam folder drawable.

cordova-dgn-bootstrap01

  1. Di dalam folder drawable terdapat file bernama png. File inilah yang dapat diganti dengan gambar lain supaya icon aplikasi berubah sesuai dengan gambar yang diinginkan. Silakan mengambil gambar icon yang baru dan salin ke dalam folder ini dengan nama file yang sama (hapus file icon.png yang asli). Pastikan resolusinya sama dengan gambar yang asli.

Menjalankan aplikasi

  1. Sambungkan kabel data dari komputer ke perangkat Android. Pastikan perangkat Android terdeteksi oleh komputer.
  2. Masuk ke dalam folder ..\Cordova\workshop\battery dan jalankan perintah:

Tampilan aplikasi saat dijalankan diperlihatkan pada gambar di bawah ini.

battery-status-cordova03

 

end-of-doc

 

Leave a Reply

Your email address will not be published. Required fields are marked *