Codelab ini adalah bagian dari kursus Dasar-Dasar Kotlin Android. Anda akan mendapatkan manfaat maksimal dari kursus ini jika Anda mengerjakan codelab secara berurutan. Semua codelab kursus tercantum di halaman landing codelab Dasar-Dasar Android Kotlin.
Pengantar
Dalam codelab ini, Anda membuat dan menjalankan aplikasi Android pertama Anda, HelloWorld, di emulator dan perangkat fisik. Anda juga akan mempelajari seperti apa project Android itu.
Yang harus sudah Anda ketahui
- Anda harus memahami proses pengembangan software umum untuk aplikasi berorientasi objek menggunakan IDE (lingkungan pengembangan terintegrasi) seperti Android Studio.
- Anda harus memiliki minimal satu tahun pengalaman dalam pemrograman berorientasi objek, dengan setidaknya pemahaman tentang Java dan Kotlin.
Yang akan Anda pelajari
- Cara membuat aplikasi Android dasar di Android Studio.
- Cara membuat project Android dari template.
- Cara menemukan komponen utama project Android.
- Cara menjalankan aplikasi Android di emulator atau perangkat fisik.
Yang akan Anda lakukan
- Buat project Android baru dan aplikasi default bernama HelloWorld.
- Buat emulator (perangkat virtual) sehingga Anda dapat menjalankan aplikasi di komputer.
- Jalankan aplikasi HelloWorld di perangkat virtual dan fisik.
- Pelajari tata letak project.
- Jelajahi file
AndroidManifest.xml
.
Aplikasi HelloWorld menampilkan string "Hello World" pada layar perangkat virtual atau perangkat fisik Android. Seperti inilah tampilan aplikasi:
Dalam tugas ini, Anda membuat project aplikasi baru untuk memverifikasi bahwa Android Studio telah diinstal dengan benar.
- Buka Android Studio jika belum terbuka.
- Di dialog utama Welcome to Android Studio, klik Start a new Android Studio project.
- Dialog Choose your project akan muncul. Pilih Aktivitas Kosong seperti yang ditunjukkan di bawah, lalu klik Berikutnya.
Activity
adalah satu aktivitas terfokus yang dapat dilakukan pengguna. Setiap aplikasi harus memiliki setidaknya satu aktivitas sebagai titik masuknya. Anggap aktivitas titik awal ini sebagai fungsimain()
dalam program lain. Aktivitas biasanya memiliki tata letak yang terkait dengannya yang menentukan bagaimana elemen antarmuka pengguna (UI) muncul di layar. Android Studio menyediakan beberapa templateActivity
untuk membantu Anda memulai. - Pada dialog Configure your project , masukkan "HelloWorld" untuk Nama.
- Setujui android.example.com default untuk Domain perusahaan, atau buat domain perusahaan yang unik. Nilai ini ditambah nama aplikasi adalah nama paket untuk aplikasi Anda. Jika Anda tidak berencana memublikasikan aplikasi, terima nilai default. Anda dapat mengubah nama paket aplikasi nanti, tetapi akan merepotkan.
- Pastikan Save location default adalah tempat Anda ingin menyimpan aplikasi. Jika tidak, ubah lokasi ke direktori pilihan Anda.
- Pastikan Language adalah Kotlin.
- Pastikan API level minimum adalah API 19: Android 4.4 (KitKat). Pada saat codelab ini ditulis, Android Studio menunjukkan bahwa dengan API level ini, aplikasi akan berjalan pada sekitar 95,3% perangkat.
(Anda akan mempelajari API level minimum lebih lanjut dalam codelab berikutnya. Untuk mempelajari lebih lanjut sekarang, klik Help me choose, yang akan membuka jendela yang berisi informasi tentang API level.) - Pilih kotak centang Use AndroidX artifacts.
- Biarkan semua kotak centang lainnya kosong, lalu klik Finish. Jika project Anda memerlukan lebih banyak komponen untuk SDK target yang dipilih, Android Studio akan menginstalnya secara otomatis, yang mungkin memerlukan waktu beberapa saat. Ikuti petunjuknya dan terima opsi default.
Android Studio kini membuat project Anda, yang dapat memerlukan waktu agak lama. Anda tidak akan mengalami error apa pun. Jika Anda mendapatkan peringatan, abaikan.
Dalam tugas ini, Anda akan menjelajahi project HelloWorld di Android Studio dan mempelajari dasar-dasar pengembangan dengan Android Studio.
Langkah 1: Pelajari panel Project
- Jika tab Project belum dipilih, pilih tab tersebut. Tab Project ada di kolom tab vertikal di sisi kiri jendela Android Studio. Panel Project terbuka.
- Untuk melihat project sebagai hierarki project Android standar, pilih Android dari menu drop-down di bagian atas panel Project. (Android adalah setelan default.) Anda dapat melihat file project dalam berbagai cara, termasuk melihat file saat muncul dalam hierarki sistem file. Namun, project lebih mudah digunakan dengan tampilan Android.
Langkah 2: Jelajahi folder aplikasi
Semua kode dan resource untuk aplikasi Anda terletak di dalam folder app
.
- Di panel Project > Android, luaskan folder app. Di dalam folder
app
, terdapat empat subfolder:manifests
,java
,generatedJava
, danres
. - Luaskan folder java, lalu luaskan folder com.example.android.HelloWorld untuk melihat file Kotlin MainActivity.
Folder java berisi semua kode Kotlin utama untuk aplikasi Android. Ada alasan historis mengapa kode Kotlin Anda muncul dalam folder java. Konvensi tersebut memungkinkan Kotlin untuk saling bertukar dan memahami dengan lancar menggunakan kode yang ditulis dalam bahasa pemrograman Java, bahkan dalam project dan aplikasi yang sama.
File class aplikasi Anda terdapat dalam tiga subfolder, seperti yang ditunjukkan pada gambar di atas. Folder com.example.hello.helloworld (atau nama domain yang telah Anda tentukan) berisi semua file untuk paket aplikasi. Secara khusus, classMainActivity
adalah titik entri utama untuk aplikasi Anda. Anda akan mempelajariMainActivity
lebih lanjut di codelab berikutnya. Dua folder lainnya di folderjava
digunakan untuk kode yang terkait dengan pengujian, seperti pengujian unit.
- Perhatikan folder generatedJava. Folder ini berisi file yang dihasilkan Android Studio saat membuat aplikasi. Jangan mengedit apa pun di folder ini, karena perubahan Anda mungkin akan diganti saat Anda mem-build ulang aplikasi. Namun, berguna untuk mengetahui tentang folder ini jika Anda perlu melihat file ini selama proses debug.
Langkah 3: Jelajahi folder res
- Di panel Project > Android, luaskan folder res.
Folder res menampung resource. Resource di Android adalah konten statis yang digunakan di aplikasi Anda. Resource mencakup gambar, string teks, tata letak layar, gaya, dan nilai seperti warna heksadesimal atau dimensi standar.
Aplikasi Android memisahkan kode Kotlin dan resource sebanyak mungkin. Hal tersebut mempermudah dalam menemukan semua string atau ikon yang digunakan dalam UI aplikasi. Selain itu, jika Anda mengubah salah satu file resource ini, perubahan tersebut akan diterapkan di mana pun file digunakan dalam aplikasi. - Dalam folder res, luaskan folder layout untuk melihat file
activity_main.xml
.
Activity
Anda biasanya dikaitkan dengan file tata letak UI, yang didefinisikan sebagai file XML di direktori res/layout
. File tata letak tersebut biasanya diberi nama setelah aktivitasnya. Dalam hal ini, nama aktivitas adalah MainActivity
, sehingga tata letak terkait adalah activity_main
.
Langkah 4: Jelajahi folder manifes dan AndroidManifest.xml
Folder manifests
berisi file yang menyediakan informasi penting tentang aplikasi Anda ke sistem Android.
- Luaskan folder manifests dan klik dua kali AndroidManifest.xml untuk membukanya. File
AndroidManifest.xml
menyertakan detail yang diperlukan sistem Android untuk menjalankan aplikasi Anda, termasuk aktivitas apa saja yang merupakan bagian dari aplikasi. - Perhatikan bahwa
MainActivity
direferensikan dalam elemen<activity>
. SetiapActivity
di aplikasi Anda harus dideklarasikan dalam manifes. Berikut adalah contoh untukMainActivity
:
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity>
- Perhatikan elemen
<intent-filter>
di dalam<activity>
. Elemen<action>
dan<category>
dalam filter intent ini memberi tahu Android tempat untuk memulai aplikasi saat pengguna mengklik ikon peluncur. Anda akan mempelajari filter intent lebih lanjut di codelab berikutnya.
File AndroidManifest.xml
juga merupakan tempat yang Anda inginkan untuk menentukan izin apa pun yang diperlukan aplikasi Anda. Izin mencakup kemampuan aplikasi Anda untuk membaca kontak telepon, mengirim data melalui internet, atau mengakses hardware seperti kamera perangkat.
Gradle adalah sistem otomatisasi build yang menggunakan bahasa khusus domain untuk menjelaskan struktur, konfigurasi, dan dependensi project aplikasi. Saat mengompilasi dan menjalankan aplikasi, Anda akan melihat informasi tentang build Gradle yang sedang berjalan. Anda juga akan melihat informasi tentang Android Package Kit (APK) yang sedang diinstal. (APK adalah format file paket yang digunakan sistem operasi Android untuk mendistribusikan dan menginstal aplikasi seluler.)
Pelajari sistem Gradle:
- Luaskan folder Gradle Scripts. Di panel Project > Android, folder ini berisi semua file yang diperlukan sistem build.
- Cari file build.gradle(Project: HelloWorld).
File ini berisi opsi konfigurasi yang umum untuk semua modul yang membentuk project Anda. Setiap project Android Studio berisi satu file build Gradle tingkat atas. File ini mendefinisikan repositori dan dependensi Gradle yang sama untuk semua modul dalam project. - Cari file build.gradle(Module:app).
Selain filebuild.gradle
level project, setiap modul memiliki filebuild.gradle
sendiri. Filebuild.gradle
level modul memungkinkan Anda mengonfigurasi setelan build untuk setiap modul. (Aplikasi HelloWorld hanya memiliki satu modul, yaitu modul untuk aplikasi itu sendiri.) Filebuild.gradle
ini adalah file yang paling sering Anda edit saat mengubah konfigurasi build level aplikasi. Misalnya, Anda mengedit filebuild.gradle
ini saat mengubah tingkat SDK yang didukung aplikasi, atau saat mendeklarasikan dependensi baru di bagiandependencies
. Anda akan mempelajari kedua hal ini lebih lanjut di codelab selanjutnya.
Dalam tugas ini, Anda menggunakan Android Virtual Device (AVD) manager untuk membuat perangkat virtual (emulator). Perangkat virtual menyimulasikan konfigurasi untuk jenis perangkat Android tertentu. Kemudian Anda dapat menggunakan perangkat virtual tersebut untuk menjalankan aplikasi.
Android Emulator adalah aplikasi independen, dan memiliki persyaratan sistem sendiri. Perangkat virtual dapat menggunakan banyak ruang disk. Jika Anda mengalami masalah, lihat Menjalankan aplikasi di Android Emulator.
Langkah 1: Buat perangkat virtual Android (AVD)
Untuk menjalankan emulator di komputer, Anda perlu membuat konfigurasi yang menjelaskan perangkat virtual tersebut.
- Di Android Studio, pilih Tools > AVD Manager, atau klik ikon AVD Manager
di toolbar. Dialog Your Virtual Devices akan muncul. Jika Anda sudah membuat perangkat virtual, dialog akan menampilkannya (seperti yang ditunjukkan pada gambar di bawah), atau Anda akan melihat daftar kosong.
- Klik +Create Virtual Device di kiri bawah dialog. Dialog Select Hardware akan muncul, yang menampilkan daftar perangkat hardware yang telah dikonfigurasi sebelumnya. Untuk setiap perangkat, tabel menyediakan kolom untuk ukuran layar diagonal (Ukuran), resolusi layar dalam piksel (Resolusi), dan kepadatan piksel (Kepadatan).
- Pilih perangkat seperti Nexus 5x atau Pixel XL, lalu klik Berikutnya. Dialog System Image akan muncul.
- Klik tab Recommended, lalu pilih versi sistem Android yang akan dijalankan di perangkat virtual (seperti Pie).
- Setelah Anda memilih image sistem, klik Next. Dialog Android Virtual Device (AVD) akan terbuka. Periksa konfigurasi, lalu klik Finish.
Langkah 2: Jalankan aplikasi di perangkat virtual
Dalam tugas ini, Anda akhirnya menjalankan aplikasi baru.
- Di Android Studio, pilih Run > Run app atau klik ikon Run
di toolbar. Dialog Select Deployment Target akan muncul dan memperingatkan bahwa perangkat tidak tersedia. Anda akan melihat peringatan ini jika tidak memiliki perangkat fisik yang terhubung ke komputer pengembangan, atau jika belum meluncurkan perangkat virtual.
- Pada dialog Select Deployment Target, di bagian Available Virtual Devices, pilih perangkat virtual yang Anda buat. Klik OK.
Emulator dimulai dan melakukan booting seperti perangkat fisik. Proses ini mungkin memerlukan waktu beberapa saat, bergantung pada kecepatan komputer Anda. Aplikasi Anda akan dibuat, dan saat emulator sudah siap, Android Studio akan mengupload APK aplikasi ke emulator dan menjalankannya.
Anda akan melihat aplikasi HelloWorld seperti yang ditampilkan dalam gambar berikut.
Dalam tugas ini, Anda menjalankan aplikasi di perangkat seluler fisik seperti ponsel atau tablet, jika ada. Selalu uji aplikasi Anda di perangkat virtual dan fisik.
Yang Anda perlukan:
- Perangkat Android seperti ponsel atau tablet.
- Kabel data USB untuk menghubungkan perangkat Android ke komputer melalui port USB.
- Jika menggunakan sistem Linux atau Windows, Anda mungkin perlu melakukan langkah tambahan. Lihat dokumentasi Menjalankan aplikasi pada perangkat hardware. Anda mungkin juga perlu menginstal driver USB yang sesuai dengan perangkat. Untuk driver USB berbasis Windows, lihat Menginstal driver USB OEM.
Langkah 1: Aktifkan proses debug USB
Agar Android Studio dapat berkomunikasi dengan perangkat Android, Anda harus mengaktifkan Proses debug USB di setelan Opsi developer di perangkat.
Di Android 4.2 (Jellybean) dan versi yang lebih tinggi, setelan Opsi developer disembunyikan secara default. Untuk menampilkan opsi developer dan mengaktifkan Proses debug USB:
- Di perangkat, buka Setelan, telusuri Tentang ponsel, ketuk Tentang ponsel, lalu ketuk Nomor versi tujuh kali.
- Kembali ke halaman sebelumnya (Setelan/Sistem). Opsi developer akan muncul dalam daftar. Ketuk Opsi developer.
- Pilih USB debugging.
Langkah 2: Jalankan aplikasi Anda di perangkat Android
Sekarang Anda dapat menghubungkan perangkat dan menjalankan aplikasi dari Android Studio.
- Hubungkan perangkat Android ke mesin pengembangan dengan kabel USB. Dialog yang meminta untuk mengizinkan Proses debug USB akan muncul di perangkat.
- Pilih opsi Selalu izinkan untuk mengingat komputer ini. Ketuk Oke.
- Di komputer, di toolbar Android Studio, klik tombol Run
. Dialog Select Deployment Target akan terbuka dengan daftar emulator yang tersedia dan perangkat yang terhubung. Anda akan melihat perangkat fisik Anda beserta semua emulator.
- Pilih perangkat, lalu klik OK. Android Studio akan menginstal aplikasi di perangkat, lalu menjalankannya.
Pemecahan masalah
Jika Android Studio tidak mengenali perangkat Anda, coba langkah berikut:
- Lepas kabel USB, lalu sambungkan kembali.
- Mulai ulang Android Studio.
Jika komputer masih tidak menemukan perangkat atau menyatakan "unauthorized," ikuti langkah berikut:
- Lepas kabel USB.
- Di perangkat, buka Opsi developer di aplikasi Setelan.
- Ketuk Cabut otorisasi debug USB.
- Hubungkan kembali perangkat ke komputer.
- Jika diminta, berikan otorisasi.
Anda mungkin perlu menginstal driver USB yang sesuai dengan perangkat. Lihat Menjalankan aplikasi pada perangkat hardware.
Tantangan: Setelah Anda siap dan terbiasa dengan alur kerja pengembangan dasar, lakukan hal berikut:
- Buat project baru di Android Studio.
- Ubah "Hello World" salam untuk "Selamat Ulang Tahun menjadi " dan nama seseorang yang baru saja berulang tahun.
- Untuk menginstal Android Studio, buka Android Studio lalu ikuti petunjuk untuk mendownload dan menginstalnya.
- Untuk melihat hierarki Android aplikasi di panel Project, klik tab Project di kolom tab vertikal. Kemudian, pilih Android di menu drop-down di bagian atas.
- Jika Anda perlu menambahkan dependensi baru ke project atau mengubah versi dependensi, edit file
build.gradle(Module:app)
. - Semua kode dan resource untuk aplikasi terletak di folder
app
danres
. Folderjava
mencakup aktivitas, pengujian, dan komponen lain dalam kode sumber Kotlin atau Java (atau keduanya). Folderres
menyimpan resource, seperti tata letak, string, dan gambar. - Untuk menambahkan fitur, komponen, dan izin ke aplikasi Android, edit file
AndroidManifest.xml
. Semua komponen aplikasi, seperti aktivitas tambahan, harus dideklarasikan dalam file XML ini. - Untuk membuat perangkat virtual Android (emulator) agar dapat menjalankan aplikasi Anda, gunakan AVD Manager.
- Untuk menjalankan aplikasi di perangkat Android fisik menggunakan Android Studio, aktifkan proses debug USB di perangkat. Untuk melakukannya, buka Setelan > Tentang ponsel dan ketuk Nomor versi tujuh kali. Kemudian, buka Setelan > Opsi developer dan pilih Proses debug USB.
Kursus Udacity:
Dokumentasi Android Studio:
- Halaman download Android Studio
- Catatan rilis Android Studio
- Mengenal Android Studio
- Membuat dan mengelola perangkat virtual
- Ringkasan Manifes Aplikasi
- Mengonfigurasi build Anda
- Membuat dan mengelola perangkat virtual
Lainnya:
Bagian ini mencantumkan kemungkinan tugas pekerjaan rumah untuk siswa yang mengerjakan codelab ini sebagai bagian dari kursus yang dipimpin oleh instruktur. Terserah instruktur untuk melakukan hal berikut:
- Tugaskan pekerjaan rumah jika diperlukan.
- Berkomunikasi dengan siswa cara mengirimkan tugas pekerjaan rumah.
- Beri nilai tugas pekerjaan rumah.
Instruktur dapat menggunakan saran ini sesedikit atau sebanyak yang mereka inginkan, dan harus bebas memberikan pekerjaan rumah lain yang dirasa sesuai.
Jika Anda mengerjakan codelab ini sendiri, silakan gunakan tugas pekerjaan rumah ini untuk menguji pengetahuan Anda.
Membuat dan menjalankan aplikasi
- Buat project Android baru dari Template Kosong.
- Buka file
res/strings.xml
. - Ubah nilai string
app_name
menjadi "My Dice Roller". Nama ini muncul di panel judul. - Buat emulator untuk perangkat, menargetkan versi Android yang Anda suka, dan menjalankan aplikasi. Perhatikan bagaimana judul aplikasi berubah.
Jawab pertanyaan berikut
Pertanyaan 1
Apa nama file tata letak untuk aktivitas utama?
MainActivity.java
AndroidManifest.xml
activity_main.xml
build.gradle
Pertanyaan 2
Apa nama resource string yang menentukan nama aplikasi?
app_name
xmlns:app
android:name
applicationId
Pertanyaan 3
Alat apa yang akan Anda gunakan untuk membuat emulator baru?
- Android Device Monitor
- AVD Manager
- SDK Manager
- Editor Tema
Mengirimkan aplikasi untuk dinilai
Periksa untuk memastikan aplikasi memiliki hal berikut:
Activity
yang menampilkan "Hello World" di layar.- Bilah judul yang bertuliskan "My Dice Roller."
Mulai tutorial berikutnya:
Untuk link ke codelab lainnya dalam kursus ini, lihat halaman landing codelab Dasar-Dasar Kotlin Android.