M Haidar Hanif avatar M Haidar Hanif committed 63b1266

Merge general specification and explanation

Also add quick building guide.

Comments (0)

Files changed (2)

 [![Status Buat](https://secure.travis-ci.org/mhaidarh/kargu.png)](http://travis-ci.org/mhaidarh/kargu/ "Status pembuatan dari Travis CI")
 
 ```
-nama = Kargu
-subnama = Kalkulator Perkiraan Penggunaan Energi Listrik
-deskripsi pendek = Kargu adalah aplikasi kalkulator untuk memperkiraan penggunaan energi listrik yang bisa untuk variasi pelanggan prabayar atau pascabayar serta mencanangkan budaya hemat energi dengan aturan biaya oleh PLN.
-deskripsi panjang = (baca penjelasan di bawah)
+Nama        = Kargu
+Subnama     = Kalkulator Perkiraan Penggunaan
+Nama Edisi  = Energi Listrik
+Judul       = Kargu, kalkulator untuk memperkiraan penggunaan energi listrik serta mencanangkan budaya hemat energi
+Judul Alt.  = Kargu, mencanangkan budaya hemat energi dengan memperkiraan penggunaan energi listrik
+deskripsi pendek  = Kargu adalah aplikasi kalkulator untuk memperkiraan penggunaan energi listrik yang bisa untuk variasi pelanggan prabayar atau pascabayar serta mencanangkan budaya hemat energi dengan aturan biaya oleh PLN.
+deskripsi panjang = Terdapat di [deskripsi](/#deskripsi)
+Tanggal     = 2013-03-XX XX:XX:XX
+Foto Produk = ./screen/kargu_x.x_screen-hr.png
+Berkas APK  = ./bin/Kargu_x.x.apk
+Kategori    = Energi, Edukasi, Budaya, Referensi, Perkakas
 ```
 
 
 
 Kargu, disingkat dari [Ka]lkulator Perki[r]aan Peng[gu]naan, adalah aplikasi kalkulator sederhana dengan penyesuaian pendekatan ketetapan biaya oleh PLN dan undang-undang yang berlaku. Bermula dari keraguan pada kala ingin membeli dan alat elektronik baru, perlu tahu tagihan yang akan didapat nantinya jika pascabayar atau pulsa yang harus disiapkan jika prabayar.
 
-Pada awalnya bertujuan utama untuk memperkiraan dengan perhitungan terdekat, sehingga belum menggunaan pendekatan simulasi secara nyata. Jadi hanya mencatat penggunaan rata-rata sehari dan mengalikannya untuk sebulan. Sehingga bukan mencatat penggunaan setiap hari dalam sebulan, walaupun fitur tersebut mungkin akan didukung nanti. Akan dilengkapi dengan ekstensi/perluasan pengetahuan budaya nasional (Indonesia) dalam penggunaan listrik sehari-hari di berbagai tempat, golongan, dan kegunaan. Masih dibuat khusus untuk penggunaan energi listrik dan amat sederhana. Tapi jika diperlukan dapat diperluas dengan energi bahan bakar minyak, gas, dan lain-lain.
+Pada awalnya bertujuan utama untuk memperkiraan dengan perhitungan terdekat, sehingga belum menggunaan pendekatan simulasi secara nyata. Jadi hanya mencatat penggunaan rata-rata sehari dan mengalikannya untuk sebulan. Sehingga bukan mencatat penggunaan setiap hari dalam sebulan, walaupun fitur tersebut mungkin akan didukung nanti. Akan dilengkapi dengan ekstensi/perluasan pengetahuan budaya nasional (Indonesia) dalam penggunaan listrik sehari-hari di berbagai tempat, golongan tarif, dan kegunaan. Masih dibuat khusus untuk penggunaan energi listrik dan amat sederhana. Tapi jika diperlukan dapat diperluas dengan energi bahan bakar minyak, gas, dan lain-lain.
 
-Kemampuan dan nilai masih dibatasi oleh informasi perhitungan dari PLN dan pemerintah yang belum terbuka dan diketahui secara mudah untuk publik. Sehingga sebagian besar menggunakan perkiraan terdekat yang umumnya dipakai. Juga memang saat ini belum ada pemilihan golongan tarif dengan simbol, untuk mempercepat pengembangan awal. Lagipula akan lebih memudahkan pengguna untuk memulai tanpa harus mengetahui.
+Kemampuan dan nilai masih dibatasi oleh informasi perhitungan dari PLN dan pemerintah yang belum terbuka dan diketahui secara mudah untuk publik. Sehingga sebagian besar menggunakan perkiraan terdekat yang umumnya dipakai. Juga memang saat ini untuk mempercepat pengembangan awal belum ada pemilihan golongan tarif dengan simbol seperti Rumah Tangga (R1, R2, R3), Sosial (S1, S2), Bisnis (B1, B2), dan lainnya. Lagipula akan lebih memudahkan pengguna untuk memulai tanpa harus mengetahui walaupun bisa agak mengurangi akurasi.
 
 Dibuat berdasarkan pengalaman akan keraguan perhitungan untuk memperkirakan biaya dari penggunaan listrik secara manual. Sebagian besar pengguna atau pelanggan listrik ingin mengetahui dan seharusnya mengetahui lebih mengenai tagihan atau biaya yang perlu disiapkan per bulan tanpa harus berada pada kondisi setelah satu bulan pemakaian listrik. Sehingga bisa menjadi alternatif untuk mengatasi keraguan jika terdapat alat elektronik baru dalam lingkungan yang digunakan. Perlu diketahui bahwa ini masih dalam tahap eksperimen dan bertujuan utama untuk edukasi karena berawal dari tugas pembelajaran.
 
-Perlu diketahui bahwa banyak sekali aplikasi seperti ini dalam berbagai bentuk seperti situs web, aplikasi, dan cara manual. Tapi yang ditekankan dalam aplikasi ini adalah penyesuaian dengan aturan PLN serta preferensi prayabar dan pascabayar.
+Perlu diketahui bahwa banyak sekali aplikasi seperti ini dalam berbagai bentuk seperti situs web, aplikasi, dan cara manual. Tapi yang ditekankan dalam aplikasi ini adalah penyesuaian dengan aturan PLN serta preferensi jenis layanan prayabar dan pascabayar. Terlebih lagi proyek ini lebih digagas dengan serius namun tetap santai dan dikembangkan secara terbuka.
 
-Kode sumber aplikasi ini dirilis secara terbuka ( _open source_ ) di [GitHub](https://github.com/mhaidarh/kargu) dan diberikan secara gratis. Anda dapat berkontribusi dengan apa saja seperti kode program, dokumentasi, gambar, suara, dan lain-lain.
+### Informasi Tambahan
+
+Dokumentasi seperti petunjuk penggunaan terdapat di [laman dokumentasi/wiki](https://github.com/mhaidarh/kargu/wiki).
+
+Kode sumber aplikasi ini dirilis secara terbuka ( _open source_ ) dalam repositori [Kargu di GitHub](https://github.com/mhaidarh/kargu) dan diberikan secara gratis.
+
+Kode sumber perintis, proyek Kargupy, terdapat dalam repositori [Kargupy di GitHub](https://github.com/mhaidarh/kargupy).
+
+Proyek ini dibuat awal oleh [M Haidar Hanif](https://github.com/mhaidarh). Lengkapnya silakan baca berkas [AUTHORS](AUTHORS).
+
+### Kontribusi
+
+Kontribusi sangat disambut dalam bentuk dan ukuran apa saja seperti:
+
+-  kode program, fitur, perbaikan, terjemahan: Silakan ['garpu'](https://github.com/mhaidarh/kargu/fork_select)( _fork_ ) proyek ini lalu [kirim permintaan tarik](https://github.com/mhaidarh/kargu/pull/new/develop) ( _pull request_ ) di cabang ( _branch_ ) develop.
+-  dokumentasi: Silakan edit/sunting [laman dokumentasi/wiki](https://github.com/mhaidarh/kargu/wiki).
+-  isu, komentar, permintaan, laporan kerusakan: Silakan tulis di [laman isu](https://github.com/mhaidarh/kargu/issues).
+-  berkas multimedia seperti gambar, suara, dan lain-lain: Silakan kirim ke [surel ( _email_ ) ini](mailto:mhaidarhanif@gmail.com).
+
+Harap menggunakan bahasa Inggris untuk pesan perubahan ( _commit message_ ) agar lebih mudah diakses untuk pengembangan. Nanti jika diterima maka akan termasuk dalam rilis stabil selanjutnya dan Anda akan diberi kredit.
+
+### Tips hemat energi
+
+(Untuk orang umum, khususnya Indonesia)
+
+-  Membuat kebiasaan hemat energi menjadi budaya nasional.
+-  Menggunakan peralatan listrik seperlunya.
+-  Membiasakan mengecek meteran secara berkala.
+-  Menyiapkan pulsa/token listrik untuk berjaga-jaga bagi pelanggan listrik prabayar.
+-  Menghindari biaya keterlambatan (BK) dengan bersiap setiap bulan atau beralih ke langganan listrik prabayar.
+-  Mengcegah penyalahgunaan listrik oleh orang lain.
+-  Mengotomatisasi alat elektronik dengan menjadwalkan proses. Seperti di komputer atau ponsel yang terdapat aplikasi untuk menjadwalkan kapan sistemnya akan dihibernasi ( _hibernate_ ) atau dimatikan ( _shut down_ ) secara otomatis setelah pemakaian tertentu. Sehingga baterai dan penggunaan energi lebih irit.
+-  Mencegah putusya arus listrik secara tiba-tiba dengan mengetahui batas daya listrik.
+-  Mengetahui adanya Penertiban Pemakaian Tenaga Listrik (P2TL).
+-  Mengetahui adanya Hari Listrik Nasional (HLN) setiap tanggal 27 Oktober/
+-  Mengetahui adanya Jam Bumi ( _Earth Hour_ ) setiap akhir bulan Maret.
+
+### Daftar Berita
+
+-  [Catatan Hari Listrik Nasional Ke-67](http://finance.detik.com/read/2012/10/27/121041/2073884/1034/catatan-hari-listrik-nasional-ke-67)
+-  [Budaya Penggunaan Listrik yang Baik Karena Pengetahuan yang Baik](http://id.shvoong.com/writing-and-speaking/presenting/2160587-budaya-penggunaan-listrik-yang-baik)
+-  [Budaya Hemat Energi Menjaga Kelangsungan Kelistrikan Nasional](http://palembang.tribunnews.com/m/index.php/08/03/2011/budaya-hemat-energi--menjaga-kelangsungan-kelistrikan-nasional)
 
 
 *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *
 -  Inisialiasi proyek dengan [Apache Maven™ 3.0.5](http://maven.apache.org) dan [Apache Ant™ 1.9.0](http://ant.apache.org)
 -  Ditambah dengan [Android Maven Plugin 3.5.1](https://maven-android-plugin.googlecode.com)
 -  Inisialisasi konfigurasi untuk [Jetbrains](http://jetbrains.org) [IntelliJ IDEA 12 CE](http://jetbrains.com/idea)
+-  Dengan isi teks pengantar bahasa Indonesia
+-  Kode sumber dan wiki dipublikasi di repositori GitHub
 
 Kargu 0.2
 
 -  Menambah beberapa komentar dan mempersingkat penulisannya
 -  Memungkinkan untuk mengembalikan nilai saat aplikasi dimulai kembali
 -  Menambah petunjuk penggunaan
+-  Menggunakan pengetesan ( _testing_ ) dengan [Calabash-Android](https://github.com/calabash/calabash-android) (berbasis [Cucumber](http://cukes.info))
 
 Kargu x.x (TODO)
 
 *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *
 
 
-Petunjuk Penggunaan
--------------------
-
-0. Selamat datang di aplikasi Kargu! Sekarang adalah pertama kali Anda menggunakan Kargu.
-   Apakah Anda perlu petunjuk penggunaan?
-   -  Ya, perlu
-   -  Tidak perlu
-1. Untuk memulai perhitungan, Anda perlu mengetahui:
-   -  Batas daya listrik bangunan seperti rumah atau kamar
-   -  Alat elektronik apa saja yang digunakan
-   -  Waktu penggunaan rata-rata sehari dalam jam
-2. Masukkan nilai daya listrik (dalam VA atau Volt Ampere)
-3. Pilih alat elektronik yang tersedia atau tambahkan sendiri
-   -  Jika memilih yang sudah ada, beri nilai waktu
-   -  Jika menambah sendiri, beri nilai Watt dan waktu
-4. Tekan tombol hitung dan silakan lihat hasil laporannya
-
+Membangun
+---------
 
-*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *
+Untuk membangunnya direkomendasikan dengan spesifikasi kebutuhan ( _dependency_ ) berikut:
 
+-  Sistem operasi seperti Unix:
+   -  Ubuntu
+   -  Arch
+   -  Mac OS X
+-  Git
+-  IDE untuk Java seperti Eclipse atau IntelliJ IDEA
+-  Ant versi 1.8.0+
+-  Maven versi 3.0.0+
+-  SDK (KPPL) Android versi 21+
+-  Ruby versi 2.0.0+ (untuk tes dengan Calabash)
+-  dan lainnya sesuai preferensi Anda
 
-Spesifikasi Lain
-----------------
+Juga direkomendasikan dengan variabel alamat lintasan ( _path_ ) di konfigurasi shell (bash/zsh/dll) seperti berikut jika belum diatur:
 
 ```
-Judul       : Kargu, kalkulator untuk memperkiraan penggunaan energi listrik serta mencanangkan budaya hemat energi
-Judul Alt.  : Kargu, mencanangkan budaya hemat energi dengan memperkiraan penggunaan energi listrik
-Tanggal     : 2013-03-XX XX:XX:XX
-Foto Produk : ./screen/kargu_x.x_screen-hr.png
-Berkas APK  : ./bin/Kargu_x.x.apk
-Kategori    : Energi, Edukasi, Budaya, Referensi, Perkakas
-```
+export ANDROID_HOME = "/alamat/lintasan/ke/android-sdk/"
+export ANDROID_TOOLS = "/alamat/lintasan/ke/android-sdk/tools/"
+export ANDROID_PTOOLS = "/alamat/lintasan/ke/android-sdk/platform-tools/"
 
-### Tips hemat energi
+export JAVA_HOME="/usr/lib/jvm/java-7-oracle"
+export ANT_HOME = "/usr/local/apache-ant-1.8.4/"
+export MAVEN_HOME = "/usr/local/apache-maven-3.0.5/"
+export M3_HOME = "/usr/local/apache-maven-3.0.5/"
+export M3 = "/usr/local/apache-maven-3.0.5/"
 
--  Membuat kebiasaan hemat energi menjadi budaya indonesia.
--  Membiasakan mengecek meteran secara berkala.
--  Menyiapkan pulsa/token listrik untuk berjaga-jaga bagi pelanggan listrik prabayar.
--  Menghindari biaya keterlambatan (BK) dengan bersiap setiap bulan atau beralih ke langganan listrik prabayar.
--  Mengcegah penyalahgunaan listrik oleh orang lain.
--  Mengotomatisasi alat elektronik dengan menjadwalkan proses. Seperti di komputer atau ponsel yang terdapat aplikasi untuk menjadwalkan kapan sistemnya akan dihibernasi ( _hibernate_ ) atau dimatikan ( _shut down_ ) secara otomatis setelah pemakaian tertentu. Sehingga baterai dan penggunaan energi lebih irit.
--  Mencegah putusya arus listrik secara tiba-tiba dengan mengetahui batas daya listrik.
--  Mengetahui adanya Penertiban Pemakaian Tenaga Listrik (P2TL).
--  Mengetahui adanya Hari Listrik Nasional (HLN) setiap tanggal 27 Oktober/
--  Mengetahui adanya Jam Bumi ( _Earth Hour_ ) setiap akhir bulan Maret.
+PATH=$PATH:$ANDROID_TOOLS:$ANDROID_PTOOLS:$ANT_HOME/bin:$MAVEN_HOME/bin:$M2_HOME/bin:$M2/bin
+```
 
+Lalu jalankan dengan salah satu perintah berikut:
 
-*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *
+-  `mvn clean package` untuk membuat APK saja
+-  `mvn clean install` untuk membuat APK dan menjalankan tes integrasi (membutuhkan perangkat Android di emulator atau nyata)
+-  `ant clean debug` untuk membuat APK mode antikutu ( _debug_ ) saja
 
+Untuk hal pengembangan lain seperti:
 
-Sumber, Lisensi, dan Kredit
----------------------------
+-  pengetesan:
+   -  [Calabash](http://calaba.sh) versi 0.4.0+ (Instal dengan `sudo gem install calabash-android` jika belum ada)
+   -  [Robotium](http://robotium.org)
+-  pengendali kebutuhan:
+   -  [Roboguice](https://github.com/roboguice/roboguice)
+-  pemecahan masalah ( _troubleshooting_ ):
+   -  periksa kembali seluruh hal penting yang dibutuhkan
+   -  cek jika ada kesalahan ketik
 
-### Pengembangan
 
-Repositori [Kargu di GitHub](https://github.com/mhaidarh/kargu).
+*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *
 
-Repositori [Kargupy di GitHub](https://github.com/mhaidarh/kargupy).
 
-Dibuat awal oleh [M Haidar Hanif](https://github.com/mhaidarh). Lengkapnya silakan baca berkas [AUTHORS](AUTHORS).
+Kata-Kata Lain
+--------------
 
 ### Lisensi
 
 Kode sumber dirilis di bawah [Lisensi MIT](LICENSE).
 
-Berkas gambar, visual, dan suara dirilis di bawah lisensi [Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported](http://creativecommons.org/licenses/by-nc-sa/3.0/).
+Berkas gambar, visual, dan suara dirilis di bawah lisensi [Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported](http://creativecommons.org/licenses/by-nc-sa/3.0).
 
-### Daftar Berita
+### Ucapan Terima Kasih
 
--  [Catatan Hari Listrik Nasional Ke-67](http://finance.detik.com/read/2012/10/27/121041/2073884/1034/catatan-hari-listrik-nasional-ke-67)
--  [Budaya Penggunaan Listrik yang Baik Karena Pengetahuan yang Baik](http://id.shvoong.com/writing-and-speaking/presenting/2160587-budaya-penggunaan-listrik-yang-baik/)
--  [Budaya Hemat Energi Menjaga Kelangsungan Kelistrikan Nasional](http://palembang.tribunnews.com/m/index.php/08/03/2011/budaya-hemat-energi--menjaga-kelangsungan-kelistrikan-nasional)
+-  Google, Android, dan Open Handset Alliance
+-  Komunitas Sumber Terbuka
+-  Proyek, aplikasi, dan perpus:
+   -  Android-Maven-Plugin
+   -  ActionBarSherlock
+   -  Calabash
+   -  RoboGuice
+-  dan lain-lain
 
-Bahan, referensi, atau tautan yang belum disebutkan di sini terdapat di [berkas pengembangan](misc/docs/development.mkd).
+Bahan, referensi, atau tautan yang belum disebutkan di sini terdapat di [berkas pengembangan](misc/docs/development.mkd) atau mungkin tersebar di beberapa berkas teks berekstensi `.mkd`.
 
 
 *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *

res/values-en/strings.xml

-<?xml version="1.0" encoding="utf-8"?>
-
-<!-- Language: English -->
-
-<resources>
-
-    <!-- Core -->
-
-    <string name="name_app">Kargu</string>
-    <string name="name_edition">Electric</string>
-    <string name="name_appedition">Kargu Electric</string>
-    <string name="version_app">Version 0.1</string>
-    <string name="tagline_app">Predicting usage cost without a doubt</string>
-
-    <!-- Menu -->
-
-    <string name="title_settings">Complete Settings</string>
-    <string name="action_settings">Settings</string>
-    <string name="button_settings">Settings</string>
-
-    <!-- Help -->
-
-    <string name="title_help">Usage Help</string>
-    <string name="action_help">Help</string>
-    <string name="button_help">Help</string>
-    <string name="dialog_help">Input data about household power and electronic appliances which you will use</string>
-
-    <!-- About -->
-
-    <string name="title_about">About Application</string>
-    <string name="button_about">About</string>
-    <string name="action_about">About</string>
-    <string name="dialog_about">Kargu Electric, predicting usage cost without a doubt and civilize to save energy</string>
-
-    <!-- Dialog -->
-
-    <string name="button_close">Close</string>
-
-    <!-- Calculation -->
-
-    <string name="edit_inputNumber">0</string>
-    <string name="button_count">Calculate</string>
-    <string name="button_reset">Reset</string>
-
-    <string name="title_number">Input number</string>
-
-</resources>
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.