Menampilkan Splash Screen pada Cordova Juli 2015 Tingkat: Oleh : Feri Djuandi Pemula Menengah Mahir Artikel kali ini akan menjelaskan cara menampilkan splash screen dari sebuah aplikasi dengan menggunakan API Cordova. Splash Screen yang dimaksud di sini adalah sebuah tampilan yang akan muncul pertama kali saat sebuah aplikasi dibuka. Splash Screen biasanya menampilkan nama dan logo aplikasi berikut nama pembuat, versi dan sebagainya. Biasanya splash screen akan muncul selama beberapa detik kemudian baru beralih ke halaman utama dari aplikasi mobile. Splash screen dapat dengan mudah ditampilkan dengan menggunakan plugin Splashscreen. 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. Mempersiapkan gambar splash screen Splash screen adalah sebuah gambar dengan format PNG. Idealnya Anda harus mempersiapkan gambar PNG yang sama namun dengan resolusi yang berbeda-beda sesuai dengan ukuran layar perangkat mobile. Tetapi pada contoh kali ini kita hanya menyiapkan sebuah file splash screen walaupun nantinya gambar akan tampak tidak proporsional jika di ditampilkan pada layar perangkat yang tidak sesuai. Namun hal itu tidak masalah jika tujuannya untuk latihan. Pada contoh ini penulis menggunakan sebuah gambar PNG dengan resolusi 300 x 200 pixel seperti di bawah ini. 1
Selanjutnya gambar ini harus diedit menggunakan program Draw 9-patch yang ada di dalam Android SDK. Program Draw 9-patch adalah sebuah editor WYSIWYG untuk membuat sebuah gambar bitmap yang secara otomatis dapat menyesuaikan tampilannya untuk mengakomodasi ukuran layar yang berbeda-beda. Silakan ikuti langkah-langkah berikut ini: 1. Pastikan Android SDK telah terintal pada komputer kerja. 2. Jalankan program draw9patch.bat yang ada di dalam folder..\sdk\tools dari Android SDK. 3. Ambil file PNG yang telah disiapkan dan tarik/geser ke layar program Draw 9-patch di atas. Atau Anda bisa juga menggunakan menu File Open. 2
4. Aktifkan opsi Show patches. Buat area patch pada bagian luar gambar sehingga membentuk seperti bingkai. Pastikan area patch tidak menyentuh gambar yang ingin ditampilkan. Patch adalah area yang akan berubah secara fleksibel baik memanjang atau memendek sesuai ukuran layar. Karena bagian tengah gambar harus tetap proporsional maka pastikan bagian itu terbebas dari area patch. Perhatikan apa yang terjadi jika gambar bagian tengah terkena area patch (yang seharusnya dihindari). 5. Simpan gambar tersebut dengan menu File Save. Program Draw 9-patch akan menambahkan karakter.9 pada nama file-nya. Contoh: splash.9.png 3
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 splash. 3. Jalankan perintah berikut ini: cordova create splash com.excercise.splash SplashScreen Setelah projek berhasil dibuat, file-file projek tersebut akan disimpan di dalam folder..\cordova\workshop\splash. Silakan menuju folder tersebut dan melihat folder-folder dan filefile apa saja yang sudah terbentuk. 4. Tambahkan dukungan untuk platform Android. Silakan masuk ke folder..\cordova\workshop\ splash dan jalankan perintah: cordova platforms add android 5. Tambahkan plugin-plugin yang dibutuhkan. Silakan masuk ke folder..\cordova\workshop\splash dan jalankan perintah: cordova plugin add cordova-plugin-device cordova plugin add cordova-plugin-console cordova plugin add cordova-plugin-splashscreen 6. 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 4
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\splash\platforms\android. Ubah versi API pada bagian target dengan yang sesuai. Buka file AndroidManifest.xml di dalam folder..\workshop\splash\platforms\android. Ubah versi API pada bagian android:targetsdkversion dengan yang sesuai. 7. Salin file flash PNG yang dibuat tadi ke salam folder..\workshop\splash\platforms\android\ res\drawable. 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/ 2. Silakan menyalin file jquery-1.11.3.js ke dalam folder..\splash\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/ 2. Silakan menyalin file jquery.mobile-1.4.5.min.js ke dalam folder..\splash\www\js. 3. Silakan menyalin file jquery.mobile-1.4.5.min.css ke dalam folder..\splash\www\css. 5
Mengedit file html Buka file index.html yang ada di dalam folder..\splash\www. Hapus semua skrip HTML yang asli dan ganti dengan skrip yang baru berikut ini. <!DOCTYPE html> <html> <head> <meta name="format-detection" content="telephone=no"> <meta name="msapplication-tap-highlight" content="no"> <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimumscale=1, width=device-width"> <!--link rel="stylesheet" type="text/css" href="css/index.css"--> <link rel="stylesheet" href="css/jquery.mobile-1.4.5.min.css"> <script src="js/jquery-1.11.3.js"></script> <script src="js/jquery.mobile-1.4.5.min.js"></script> <script type="text/javascript" charset="utf-8"> // Wait for device API libraries to load // function onload() { document.addeventlistener("deviceready", ondeviceready, false); } // device APIs are available // function ondeviceready() { navigator.splashscreen.show(); } </script> </head> <body onload="onload()"> <!-- ################# MAIN PAGE ################# --> <div data-role="page" id="pageone"> <div data-role="header"> <h1>splash Screen</h1> <a href="#about" data-icon="info" data-iconpos="notext">about</a> <div data-role="main" class="ui-content"> <p> <p> <center><h1>splash Screen</h1></center> <p align="center"><img src="img/logo.png"></p> <!--div data-role="footer"> <p align="center">footer text here</p> </div--> <!-- ################# ABOUT ################# --> <div data-role="page" data-dialog="true" data-close-btn="right" id="about"> <div data-role="header"> <h1>about</h1> <div data-role="main" class="ui-content"> <center><h1>splash Screen</h1></center> <p>this is an Apache Cordova sample application.</p> Author: Feri Djuandi <br>email: feri.djuandi@gmail.com 6
<script type="text/javascript" src="cordova.js"></script> <!--script type="text/javascript" src="js/index.js"></script--> </body> </html> Mengedit file config.xml 1. Buka file config.xml yang ada di dalam folder..\workshop\splash. 2. Tambahkan baris baru seperti yang ditandai di bawah ini. <?xml version='1.0' encoding='utf-8'?> <widget id="com.excercise.splash" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0"> <name>splash Screen</name> <description> A sample Apache Cordova application that responds to the Splash Screen. </description> <author email="feri.djuandi@gmail.com" href="http://cordova.io"> Feri Djuandi </author> <content src="index.html" /> <plugin name="cordova-plugin-whitelist" version="1" /> <access origin="*" /> <allow-intent href="http://*/*" /> <allow-intent href="https://*/*" /> <allow-intent href="tel:*" /> <allow-intent href="sms:*" /> <allow-intent href="mailto:*" /> <allow-intent href="geo:*" /> <platform name="android"> <allow-intent href="market:*" /> </platform> <platform name="ios"> <allow-intent href="itms:*" /> <allow-intent href="itms-apps:*" /> </platform> <preference name="splashscreen" value="splash" /> <preference name="splashscreendelay" value="5000" /> </widget> Atribut SplashScreen berisi nama file splash screen, yaitu dalam hal ini adalah splash.9.png yang terletak di dalam folder..\workshop\splash\platforms\android\res\drawable. Anda bebas menggunakan nama file lain. Atribut SplashScreenDelay berisi durasi splash screen akan ditampilkan dalam mili detik. Nilai default-nya adalah 3000. Mempersiapkan file-file gambar File-file gambar ada di dalam folder..\splash\www\img. 7
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 pixel. 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. 4. Di dalam folder drawable terdapat file bernama icon.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. 8
Menjalankan aplikasi 1. Sambungkan kabel data dari komputer ke perangkat Android. Pastikan perangkat Android terdeteksi oleh komputer. 2. Masuk ke dalam folder..\cordova\workshop\splash dan jalankan perintah: cordova run android Tampilan aplikasi saat dijalankan diperlihatkan pada gambar di bawah ini. Tampilan splash screen Tampilan index.html Referensi: https://www.npmjs.com/package/cordova-plugin-splashscreen http://developer.android.com/tools/help/draw9patch.html Proverbs 1:7. The fear of the LORD is the beginning of knowledge: but fools despise wisdom and instruction. 9