Codelab ini adalah bagian dari kursus Dasar-Dasar Android Kotlin. Anda akan mendapatkan manfaat maksimal dari kursus ini jika menyelesaikan codelab secara berurutan. Semua codelab kursus tercantum di halaman landing codelab Dasar-Dasar Android Kotlin.
Pengantar
Dalam codelab ini, Anda akan membuat dan menjalankan aplikasi Android pertama Anda, HelloWorld, di emulator dan di 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 (integrated development environment) seperti Android Studio.
- Anda harus memiliki pengalaman minimal satu tahun 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) agar Anda dapat menjalankan aplikasi di komputer.
- Jalankan aplikasi HelloWorld di perangkat virtual dan fisik.
- Jelajahi tata letak project.
- Jelajahi file
AndroidManifest.xml
.
Aplikasi HelloWorld menampilkan string "Hello World" di layar perangkat virtual Android atau perangkat fisik. Berikut tampilan aplikasi:
Dalam tugas ini, Anda akan membuat project aplikasi baru untuk memverifikasi bahwa Android Studio telah diinstal dengan benar.
- Buka Android Studio jika belum dibuka.
- Dalam dialog Welcome to Android Studio utama, klik Start a new Android Studio project.
- Dialog Choose your project akan muncul. Pilih Empty Activity seperti yang ditunjukkan di bawah, lalu klik Next.
Activity
adalah satu hal terfokus yang dapat dilakukan pengguna. Setiap aplikasi harus memiliki setidaknya satu aktivitas sebagai titik entri. Anggap aktivitas titik entri ini sebagai fungsimain()
dalam program lain. Aktivitas biasanya memiliki tata letak yang terkait dengannya yang menentukan cara elemen antarmuka pengguna (UI) muncul di layar. Android Studio menyediakan beberapa templateActivity
untuk membantu Anda memulai. - Di dialog Configure your project, masukkan "HelloWorld" untuk Name.
- Terima 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 Lokasi penyimpanan default adalah tempat Anda ingin menyimpan aplikasi. Jika tidak, ubah lokasi ke direktori pilihan Anda.
- Pastikan Language adalah Kotlin.
- Pastikan Level API Minimum adalah API 19: Android 4.4 (KitKat). Pada saat codelab ini ditulis, Android Studio menunjukkan bahwa dengan level API ini, aplikasi akan berjalan di sekitar 95,3% perangkat.
(Anda akan mempelajari lebih lanjut level API minimum dalam codelab berikutnya. Untuk mempelajari lebih lanjut sekarang, klik Bantu saya memilih, yang akan membuka jendela berisi informasi tentang level API.) - Centang kotak Use AndroidX artifacts.
- Biarkan semua kotak centang lainnya tidak dicentang, lalu klik Selesai. 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 perintah dan setujui opsi default.
Android Studio kini membuat project Anda, yang dapat memerlukan waktu beberapa saat. Anda tidak akan mendapatkan 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: Jelajahi panel Project
- Jika tab Project belum dipilih, pilih tab tersebut. Tab Project berada di kolom tab vertikal di sisi kiri jendela Android Studio. Panel Project akan terbuka.
- Untuk melihat project sebagai hierarki project Android standar, pilih Android dari menu drop-down di bagian atas panel Project. (Android adalah default.) Anda dapat melihat file project dengan berbagai cara, termasuk melihat file seperti yang muncul dalam hierarki sistem file. Namun, project lebih mudah dikerjakan menggunakan tampilan Android.
Langkah 2: Jelajahi folder aplikasi
Semua kode dan resource untuk aplikasi Anda berada 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 di folder java. Konvensi tersebut memungkinkan Kotlin beroperasi dengan lancar dengan 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. Khususnya, 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 membangun aplikasi. Jangan mengedit apa pun di folder ini, karena perubahan Anda dapat diganti saat Anda membangun ulang aplikasi. Namun, folder ini berguna untuk diketahui saat Anda perlu melihat file ini selama proses debug.
Langkah 3: Jelajahi folder res
- Di panel Project > Android, luaskan folder res.
Folder res berisi resource. Resource di Android adalah konten statis yang digunakan dalam aplikasi Anda. Resource mencakup gambar, string teks, tata letak layar, gaya, dan nilai seperti warna heksadesimal atau dimensi standar.
Aplikasi Android memisahkan kode dan resource Kotlin sebanyak mungkin. Dengan begitu, Anda akan lebih mudah menemukan semua string atau ikon yang digunakan di UI aplikasi. Selain itu, saat Anda mengubah salah satu file resource ini, perubahan akan diterapkan di mana pun file tersebut 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 ditentukan sebagai file XML di direktori res/layout
. File tata letak tersebut biasanya diberi nama sesuai dengan aktivitasnya. Dalam hal ini, nama aktivitasnya adalah MainActivity
, sehingga tata letak terkaitnya adalah activity_main
.
Langkah 4: Jelajahi folder manifes dan AndroidManifest.xml
Folder manifests
berisi file yang memberikan 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
dirujuk dalam elemen<activity>
. SetiapActivity
di aplikasi Anda harus dideklarasikan dalam manifes. Berikut 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 lebih lanjut filter intent dalam codelab berikutnya.
File AndroidManifest.xml
juga merupakan tempat Anda akan menentukan izin apa pun yang dibutuhkan 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.)
Jelajahi sistem Gradle:
- Luaskan folder Gradle Scripts. Di panel Project > Android, folder ini berisi semua file yang dibutuhkan 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 teratas. File ini menentukan 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 level SDK yang didukung aplikasi Anda, atau saat mendeklarasikan dependensi baru di bagiandependencies
. Anda akan mempelajari kedua hal ini lebih lanjut di codelab berikutnya.
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 harus membuat konfigurasi yang menjelaskan perangkat virtual.
- Di Android Studio, pilih Tools > AVD Manager, atau klik ikon AVD Manager
di toolbar. Dialog Your Virtual Devices akan muncul. Jika Anda telah membuat perangkat virtual, dialog akan menampilkannya (seperti yang ditunjukkan pada gambar di bawah). Jika tidak, Anda akan melihat daftar kosong.
- Klik +Create Virtual Device di kiri bawah dialog. Dialog Select Hardware akan muncul, menampilkan daftar perangkat hardware yang telah dikonfigurasi sebelumnya. Untuk setiap perangkat, tabel menyediakan kolom untuk ukuran tampilan diagonal (Size), resolusi layar dalam piksel (Resolution), dan kepadatan piksel (Density).
- Pilih perangkat seperti Nexus 5x atau Pixel XL, lalu klik Next. 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 Anda, lalu klik Selesai.
Langkah 2: Jalankan aplikasi di perangkat virtual
Dalam tugas ini, Anda akan menjalankan aplikasi baru.
- Di Android Studio, pilih Run > Run app atau klik ikon Run di toolbar. [IMAGEINFO]: ic_run.png, ikon Run Android Studio" style="width: 24.00px" src="img/6c65750f2ce7f651.png"> di toolbar. Dialog Select Deployment Target akan muncul dan memperingatkan Anda bahwa tidak ada perangkat yang tersedia. Anda akan melihat peringatan ini jika tidak memiliki perangkat fisik yang terhubung ke komputer pengembangan, atau jika Anda belum meluncurkan perangkat virtual.
- Pada dialog Select Deployment Target, di bagian Available Virtual Devices, pilih perangkat virtual yang Anda buat. Klik OK.
Emulator memulai dan melakukan booting seperti perangkat fisik. Bergantung pada kecepatan komputer Anda, proses ini mungkin memerlukan waktu beberapa saat. 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 ditunjukkan pada gambar berikut.
Dalam tugas ini, Anda akan menjalankan aplikasi di perangkat seluler fisik seperti ponsel atau tablet, jika Anda memilikinya. 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 Anda menggunakan sistem Linux atau Windows, Anda mungkin perlu melakukan langkah-langkah tambahan. Lihat dokumentasi Menjalankan aplikasi di perangkat hardware. Anda mungkin juga perlu menginstal driver USB yang sesuai untuk perangkat Anda. 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 Anda, buka Setelan, telusuri Tentang ponsel, ketuk Tentang ponsel, lalu ketuk Nomor build tujuh kali.
- Kembali ke halaman sebelumnya (Setelan / Sistem). Opsi developer akan muncul dalam daftar. Ketuk Opsi developer.
- Pilih Proses debug USB.
Langkah 2: Jalankan aplikasi 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 menyatakannya sebagai "unauthorized", ikuti langkah-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 di perangkat hardware.
Tantangan: Setelah Anda menyiapkan dan memahami alur kerja pengembangan dasar, lakukan hal berikut:
- Buat project baru di Android Studio.
- Ubah ucapan "Hello World" menjadi "Happy Birthday to " dan nama seseorang yang baru saja berulang tahun.
- Untuk menginstal Android Studio, buka Android Studio dan 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.
- Saat Anda perlu menambahkan dependensi baru ke project atau mengubah versi dependensi, edit file
build.gradle(Module:app)
. - Semua kode dan resource untuk aplikasi berada di dalam 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 Anda, 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, lalu ketuk Nomor build tujuh kali. Kemudian, buka Setelan > Opsi developer, lalu 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. Instruktur menentukan hal berikut:
- Memberikan pekerjaan rumah jika diperlukan.
- Memberi tahu siswa cara mengirimkan tugas pekerjaan rumah.
- Memberi nilai tugas pekerjaan rumah.
Instruktur bisa menggunakan saran ini sesuai kebutuhan, dan bebas menugaskan pekerjaan rumah lain yang dirasa cocok.
Jika Anda menyelesaikan codelab ini sendiri, gunakan tugas pekerjaan rumah ini untuk menguji pengetahuan Anda.
Membangun 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, yang menargetkan versi Android apa pun yang Anda inginkan, lalu jalankan aplikasi. Perhatikan bagaimana judul aplikasi berubah.
Jawab pertanyaan-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 Anda gunakan untuk membuat emulator baru?
- Android Device Monitor
- AVD Manager
- SDK Manager
- Editor Tema
Mengirimkan aplikasi Anda untuk dinilai
Periksa untuk memastikan aplikasi memiliki hal berikut:
Activity
yang menampilkan "Hello World" di layar.- Panel judul yang bertuliskan "My Dice Roller".
Mulai pelajaran berikutnya:
Untuk link ke codelab lain dalam kursus ini, lihat halaman landing codelab Dasar-Dasar Android Kotlin.