Meningkatkan kode dengan pemeriksaan lint

Selain membangun pengujian untuk memastikan aplikasi Anda memenuhi persyaratan fungsionalnya, Anda harus menjalankan kode melalui alat lint untuk membantu memastikan kode tidak memiliki menyelesaikan semua jenis permasalahan. Alat lint ini membantu menemukan struktur kode yang buruk, yang dapat memengaruhi keandalan dan efisiensi aplikasi Android serta membuat kode semakin sulit dipelihara. Sangat disarankan agar Anda memperbaiki setiap kesalahan yang dideteksi lint sebelum memublikasikan aplikasi.

Misalnya, jika file resource XML Anda berisi namespace yang tidak terpakai, file ini akan menghabiskan ruang dan memerlukan pemrosesan yang tidak perlu. Masalah struktural lainnya, seperti penggunaan elemen yang usang atau panggilan API yang tidak didukung oleh versi API target, dapat menyebabkan kode gagal dijalankan dengan benar. Lint dapat membantu Anda mengatasi masalah ini.

Untuk meningkatkan performa lint, Anda juga dapat menambahkan anotasi ke kode Anda.

Ringkasan

Android Studio menyediakan alat pemindaian kode yang disebut lint yang dapat membantu Anda mengidentifikasi dan memperbaiki masalah kualitas struktur kode Anda tanpa harus mengeksekusi aplikasi atau menulis kasus pengujian. Setiap masalah yang terdeteksi oleh alat ini dilaporkan dengan pesan deskripsi dan tingkat keparahan sehingga Anda dapat memprioritaskan perbaikan penting yang perlu dilakukan. Anda juga dapat menurunkan tingkat keparahan suatu masalah untuk mengabaikan masalah yang tidak relevan dengan proyek Anda atau menaikkan tingkat keparahan untuk menyoroti masalah spesifik.

Alat lint memeriksa file sumber project Android untuk menemukan kemungkinan bug dan peningkatan pengoptimalan guna mencapai ketepatan, keamanan, performa, kegunaan, aksesibilitas, serta internasionalisasi. Saat menggunakan Android Studio, lint yang dikonfigurasi dan pemeriksaan IDE akan dijalankan saat Anda membangun aplikasi. Namun, Anda dapat menjalankan pemeriksaan secara manual atau menjalankan lint dari command line, seperti yang dijelaskan di halaman ini.

Alat lint bawaan akan memeriksa kode selagi Anda menggunakan Android Studio. Anda dapat menampilkan peringatan dan error dengan dua cara:

  • Sebagai teks pop-up di jendela editor. Saat menemukan masalah, lint akan menandai kode yang bermasalah berwarna kuning. Untuk masalah yang lebih serius, menggarisbawahi kode dengan warna merah.
  • Di jendela Inspection Results lint saat Anda mengklik Code > Memeriksa Kode.

Catatan: Saat kode Anda dikompilasi di Android Studio, Pemeriksaan kode IntelliJ dijalankan untuk menyederhanakan kode ulasan.

Gambar 1 menampilkan cara alat lint memproses file sumber aplikasi.

Alur kerja pemindaian kode dengan alat lint.
Gambar 1. Alur kerja pemindaian kode dengan lint alat ini.
File sumber aplikasi
File sumber terdiri dari file yang menyusun project Android Anda, termasuk Kotlin, Java, dan File XML, ikon, dan file konfigurasi ProGuard.
File lint.xml
File konfigurasi yang dapat Anda gunakan untuk menetapkan pemeriksaan lint yang ingin dikecualikan dan untuk menyesuaikan tingkat keparahan masalah.
Alat lint
Alat pemindaian kode statis yang dapat Anda jalankan di project Android baik dari command line atau dalam Android Studio. Lint pemeriksaan alat untuk masalah kode struktural yang dapat memengaruhi kualitas dan performa aplikasi Android.
Hasil pemeriksaan lint
Anda dapat melihat hasil dari lint di konsol atau Inspection Results jendela di Android Studio. Jika Anda menjalankan lint dari command line, hasilnya adalah yang ditulis ke folder build/. Untuk detail lebih lanjut, lihat bagian tentang menjalankan pemeriksaan secara manual.

Menjalankan lint dari command line

Jika Anda menggunakan Android Studio atau Gradle, gunakan Wrapper Gradle untuk memanggil tugas lint untuk project Anda dengan memasukkan salah satu perintah berikut dari direktori utama project Anda:

  • Di Windows:
    gradlew lint
    
  • Di Linux atau macOS:
    ./gradlew lint
    

Anda akan melihat output yang mirip dengan berikut ini:

> Task :app:lintDebug
Wrote HTML report to file:<path-to-project>/app/build/reports/lint-results-debug.html

Setelah menyelesaikan pemeriksaannya, alat lint akan menyediakan jalur ke laporan lint versi XML dan HTML. Selanjutnya, Anda dapat mengakses laporan HTML dan membukanya di browser, seperti yang ditunjukkan pada gambar 2.

Contoh laporan lint versi HTML
Gambar 2. Contoh laporan lint HTML.

Jika project Anda menyertakan build varian, lint hanya akan memeriksa varian default. Jika Anda ingin menjalankan lint pada varian, Anda harus menuliskan nama varian dengan huruf kapital dan mengawalinya dengan lint.

./gradlew lintRelease

Untuk mempelajari lebih lanjut cara menjalankan Tugas Gradle dari command line, baca Membangun aplikasi dari command line.

Menjalankan lint menggunakan alat mandiri

Jika Anda tidak menggunakan Android Studio atau Gradle, instal alat command line Android SDK untuk menggunakan alat lint mandiri. Menemukan alat lint pukul android_sdk/cmdline-tools/version/bin/lint.

Catatan: Jika Anda mencoba menjalankan alat mandiri pada project Gradle, alat ini akan mengalami {i>error.<i} Anda harus selalu menggunakan gradle lint (di Windows) atau ./gradlew lint (di macOS atau Linux) untuk menjalankan lint di project Gradle.

Untuk menjalankan lint pada daftar file dalam sebuah direktori project, gunakan perintah berikut:

lint [flags] <project directory>

Misalnya, Anda dapat mengeluarkan perintah berikut untuk memindai file dalam direktori myproject dan subdirektorinya. ID masalah MissingPrefix memberi tahu lint untuk hanya memindai atribut XML yang tidak memiliki awalan namespace Android.

lint --check MissingPrefix myproject 

Untuk melihat daftar lengkap flag dan argumen command-line yang didukung oleh alat ini, gunakan perintah berikut:

lint --help

Contoh berikut menampilkan output konsol saat perintah lint dijalankan terhadap bernama Earthquake:

$ lint Earthquake

Scanning Earthquake: ...............................................................................................................................
Scanning Earthquake (Phase 2): .......
AndroidManifest.xml:23: Warning: <uses-sdk> tag appears after <application> tag [ManifestOrder]
  <uses-sdk android:minSdkVersion="7" />
  ^
AndroidManifest.xml:23: Warning: <uses-sdk> tag should specify a target API level (the highest verified version; when running on later versions, compatibility behaviors may be enabled) with android:targetSdkVersion="?" [UsesMinSdkAttributes]
  <uses-sdk android:minSdkVersion="7" />
  ^
res/layout/preferences.xml: Warning: The resource R.layout.preferences appears to be unused [UnusedResources]
res: Warning: Missing density variation folders in res: drawable-xhdpi [IconMissingDensityFolder]
0 errors, 4 warnings

Contoh output mencantumkan empat peringatan dan tidak ada error.

Dua peringatan terkait dengan file AndroidManifest.xml project:

  • ManifestOrder
  • UsesMinSdkAttributes
Satu peringatan terkait dengan file tata letak Preferences.xml: UnusedResources.

Satu peringatan terkait dengan direktori res: IconMissingDensityFolder.

Mengonfigurasi lint untuk menyembunyikan peringatan

Secara default, saat Anda menjalankan pemindaian lint, alat bantu akan memeriksa semua masalah yang didukung lint. Anda juga bisa membatasi masalah yang akan diperiksa lint, dan Anda bisa menetapkan tingkat keparahan tingkat layanan untuk masalah. Misalnya, Anda bisa menyembunyikan pemeriksaan lint untuk masalah tertentu yang tidak relevan dengan project, dan Anda bisa mengonfigurasi lint untuk melaporkan masalah non-kritis tingkat keparahan yang lebih rendah.

Tingkat keparahannya adalah:

  • enable
  • disable atau ignore
  • informational
  • warning
  • error
  • fatal

Anda dapat mengonfigurasi pemeriksaan lint dengan beberapa tingkat:

  • Global (keseluruhan project)
  • Modul project
  • Modul produksi
  • Modul pengujian
  • File terbuka
  • Hierarki class
  • Cakupan Sistem Kontrol Versi (VCS)

Mengonfigurasi file lint

Anda dapat menentukan preferensi pemeriksaan lint dalam file lint.xml. Jika Anda membuat file ini secara manual, tempatkan file tersebut dalam direktori utama project Android Anda.

File lint.xml terdiri dari satu tag induk <lint> penutup yang berisi satu atau beberapa elemen <issue> turunan. Lint mendefinisikan Nilai atribut id untuk setiap <issue>:

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- list of issues to configure -->
</lint>

Untuk mengubah tingkat keparahan masalah atau menonaktifkan pemeriksaan lint untuk masalah tersebut, Tetapkan atribut tingkat keparahan dalam tag <issue>.

Tips: Untuk melihat daftar lengkap masalah yang didukung oleh lint dan ID masalah yang terkait, jalankan perintah lint --list.

File contoh lint.xml

Contoh berikut menampilkan konten file lint.xml:

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disable the IconMissingDensityFolder check in this project -->
    <issue id="IconMissingDensityFolder" severity="ignore" />

    <!-- Ignore the ObsoleteLayoutParam issue in the specified files -->
    <issue id="ObsoleteLayoutParam">
        <ignore path="res/layout/activation.xml" />
        <ignore path="res/layout-xlarge/activation.xml" />
    </issue>

    <!-- Ignore the UselessLeaf issue in the specified file -->
    <issue id="UselessLeaf">
        <ignore path="res/layout/main.xml" />
    </issue>

    <!-- Change the severity of hardcoded strings to "error" -->
    <issue id="HardcodedText" severity="error" />
</lint>

Contoh ini menunjukkan cara berbagai jenis masalah dilaporkan. Tujuan IconMissingDensityFolder pemeriksaan dinonaktifkan sepenuhnya, dan pemeriksaan ObsoleteLayoutParam dinonaktifkan dalam file yang ditentukan dalam deklarasi <ignore ... /> yang disertakan.

Mengonfigurasi pemeriksaan lint untuk file sumber Kotlin, Java, dan XML

Anda dapat menonaktifkan pemeriksaan lint untuk file sumber Kotlin, Java, dan XML dalam dialog Preferences:

  1. Pilih File > Settings (di Windows) atau Android Studio > Preferensi (di macOS atau Linux).
  2. Pilih Editor > Inspeksi.
  3. Untuk menonaktifkannya, batalkan pilihan file sumber yang sesuai.

Anda dapat menetapkannya untuk IDE atau untuk masing-masing proyek dengan memilih profil yang sesuai.

Mengonfigurasi pemeriksaan lint di Java atau Kotlin

Untuk menonaktifkan pemeriksaan lint khusus untuk class atau metode dalam project Android Anda, tambahkan anotasi @SuppressLint ke kode tersebut.

Contoh berikut menunjukkan cara menonaktifkan pemeriksaan lint untuk masalah NewApi dalam metode onCreate. Alat lint akan terus memeriksa masalah NewApi dalam metode lain class ini.

Kotlin

@SuppressLint("NewApi")
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

Java

@SuppressLint("NewApi")
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

Hal yang sama dapat dilakukan di Composable apa pun. Cuplikan kode berikut menunjukkan cara mengubah memeriksa NewApi pada Composable apa pun.

Kotlin

  @SuppressLint("NewApi")
  @Composable
  fun MyComposable{
    ...
  }
  

Contoh berikut menunjukkan cara menonaktifkan pemeriksaan lint untuk masalah ParserError di class FeedProvider:

Kotlin

@SuppressLint("ParserError")
class FeedProvider : ContentProvider() {

Java

@SuppressLint("ParserError")
public class FeedProvider extends ContentProvider {

Untuk menyembunyikan pemeriksaan atas semua masalah lint dalam file ini, gunakan kata kunci all:

Kotlin

@SuppressLint("all")

Java

@SuppressLint("all")

Anda dapat menggunakan anotasi yang sama untuk menyembunyikan pemeriksaan lint pada fungsi Composable.

Mengonfigurasi pemeriksaan lint di XML

Gunakan atribut tools:ignore untuk menonaktifkan pemeriksaan lint untuk bagian dari file XML Anda. Masukkan nilai namespace berikut dalam file lint.xml agar alat lint dapat mengenali atribut tersebut:

namespace xmlns:tools="http://schemas.android.com/tools"

Contoh berikut menampilkan cara menonaktifkan pemeriksaan lint untuk Masalah UnusedResources dalam elemen <LinearLayout> dari XML file tata letak. Atribut ignore diwarisi oleh elemen turunan dari induk tempat atribut dideklarasikan. Dalam contoh ini, pemeriksaan lint juga dinonaktifkan untuk elemen <TextView> turunan:

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:ignore="UnusedResources" >

    <TextView
        android:text="@string/auto_update_prompt" />
</LinearLayout>

Untuk menonaktifkan lebih dari satu masalah, cantumkan masalah tersebut dalam string yang dipisahkan koma. Contoh:

tools:ignore="NewApi,StringFormatInvalid"

Untuk menyembunyikan pemeriksaan atas semua masalah lint dalam elemen XML, gunakan all kata kunci:

tools:ignore="all"

Mengonfigurasi opsi lint dengan Gradle

Plugin Android untuk Gradle memungkinkan Anda mengonfigurasi opsi lint tertentu, seperti pemeriksaan mana yang akan dijalankan atau diabaikan, dengan menggunakan Blok lint{} di level modul File build.gradle.

Cuplikan kode berikut menunjukkan beberapa properti yang dapat Anda konfigurasi:

Kotlin

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable += "TypographyFractions" + "TypographyQuotes"
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable += "RtlHardcoded" + "RtlCompat" + "RtlEnabled"
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly += "NewApi" + "InlinedApi"
        // If set to true, turns off analysis progress reporting by lint.
        quiet = true
        // If set to true (default), stops the build if errors are found.
        abortOnError = false
        // If set to true, lint only reports errors.
        ignoreWarnings = true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies = true
    }
}
...

Groovy

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable 'TypographyFractions','TypographyQuotes'
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable 'RtlHardcoded','RtlCompat', 'RtlEnabled'
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly 'NewApi', 'InlinedApi'
        // If set to true, turns off analysis progress reporting by lint.
        quiet true
        // If set to true (default), stops the build if errors are found.
        abortOnError false
        // If set to true, lint only reports errors.
        ignoreWarnings true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies true
    }
}
...

Semua metode lint yang mengganti tingkat keparahan masalah yang diberikan akan urutan konfigurasi. Misalnya, menetapkan masalah sebagai fatal dalam finalizeDsl() mengganti penonaktifannya di DSL utama.

Membuat dasar pengukuran peringatan

Anda dapat mengambil snapshot kumpulan peringatan saat ini untuk project Anda, lalu menggunakan snapshot tersebut sebagai dasar untuk pemeriksaan di masa mendatang, sehingga hanya masalah baru yang dilaporkan. Snapshot baseline memungkinkan Anda mulai menggunakan lint untuk menggagalkan build tanpa harus kembali dan mengatasi semua masalah yang ada terlebih dahulu.

Untuk membuat snapshot dasar pengukuran, ubah file build.gradle project Anda sebagai berikut:

Kotlin

android {
    lint {
        baseline = file("lint-baseline.xml")
    }
}

Groovy

android {
    lintOptions {
        baseline file("lint-baseline.xml")
    }
}

Saat Anda menambahkan baris ini untuk pertama kalinya, file lint-baseline.xml akan dibuat untuk menetapkan baseline Anda. Selanjutnya, alat hanya membaca file tersebut untuk menentukan baseline. Jika Anda ingin untuk membuat dasar pengukuran baru, hapus file secara manual dan jalankan lagi lint untuk membuatnya kembali.

Lalu, jalankan lint dari IDE dengan memilih Code > Memeriksa Kode atau dari command line sebagai berikut. Output-nya akan menunjukkan lokasi file lint-baseline.xml. Tujuan lokasi file untuk konfigurasi Anda mungkin berbeda dengan yang ditampilkan di sini:

$ ./gradlew lintDebug -Dlint.baselines.continue=true
...
Wrote XML report to file:///app/lint-baseline.xml
Created baseline file /app/lint-baseline.xml

Menjalankan lint akan merekam semua masalah saat ini dalam file lint-baseline.xml. Rangkaian masalah saat ini adalah yang disebut baseline. Anda dapat memeriksa lint-baseline.xml ke kontrol versi jika Anda ingin membaginya dengan orang lain.

Menyesuaikan baseline

Jika Anda hanya ingin menambahkan jenis masalah tertentu ke dasar pengukuran, tentukan masalah yang perlu ditambahkan dengan mengedit file build.gradle project Anda sebagai berikut:

Kotlin

android {
    lint {
        checkOnly += "NewApi" + "HandlerLeak"
        baseline = file("lint-baseline.xml")
    }
}

Groovy

android {
    lintOptions {
        checkOnly 'NewApi', 'HandlerLeak'
        baseline file("lint-baseline.xml")
    }
}

Jika Anda menambahkan peringatan baru ke codebase setelah membuat dasar pengukuran, lint hanya mencantumkan {i>bug<i} yang baru diperkenalkan.

Peringatan baseline

Ketika dasar pengukuran diberlakukan, Anda akan mendapatkan peringatan informasi yang memberi tahu Anda bahwa satu atau beberapa masalah disaring karena mereka tercantum sebagai dasar pengukuran. Ini membantu Anda mengingat bahwa Anda telah mengonfigurasi dasar pengukuran dan bahwa Anda perlu memperbaiki semua masalah suatu saat.

Peringatan yang informatif ini juga melacak masalah yang tidak lagi dilaporkan. Informasi ini memungkinkan Anda tahu apakah Anda telah benar-benar memperbaiki masalah, sehingga Anda dapat memilih untuk membuat ulang dasar pengukuran untuk mencegah {i>error<i} agar tidak kembali secara tidak terdeteksi.

Catatan: Baseline diaktifkan saat Anda menjalankan pemeriksaan dalam mode batch di IDE, tetapi diabaikan untuk pemeriksaan dalam-editor yang berjalan di latar belakang saat Anda mengedit file. Hal ini karena dasar pengukuran ditujukan untuk kasus di mana codebase memiliki banyak peringatan yang sudah ada, tetapi Anda ingin memperbaiki masalah secara lokal saat Anda menyentuh kodenya.

Menjalankan pemeriksaan secara manual

Untuk menjalankan lint yang telah dikonfigurasi dan pemeriksaan IDE lainnya secara manual, pilih Kode > Memeriksa Kode. Hasil pemeriksaan akan muncul di jendela Inspection Results.

Menetapkan cakupan dan profil pemeriksaan

Pilih file yang ingin Anda analisis (cakupan pemeriksaan) dan pemeriksaan yang ingin Anda jalankan (profil pemeriksaan) sebagai berikut:

  1. Di tampilan Android, buka project Anda dan pilih project, folder, atau yang ingin Anda analisis.
  2. Dari panel menu, pilih Code > Memeriksa Kode.
  3. Pada dialog Specify Inspection Scope, periksa setelan.

    Specify Inspection Scope
    Gambar 3. Tinjau setelan cakupan pemeriksaan.

    Opsi yang muncul dalam dialog Define Inspection Scope bervariasi tergantung pada apakah Anda memilih project, folder, atau file:

    • Saat Anda memilih satu proyek, file, atau direktori, Menentukan Cakupan Inspeksi dialog yang menampilkan jalur ke proyek, file, atau yang Anda pilih.
    • Saat Anda memilih lebih dari satu project, file, atau direktori, perintah Tentukan Inspeksi Dialog Scope menampilkan tombol pilihan yang dipilih untuk Selected files.

    Untuk mengubah apa yang akan diperiksa, pilih salah satu tombol pilihan lainnya. Lihat Dialog Menentukan Cakupan Inspeksi untuk deskripsi semua mungkin kolom pada dialog Identify Inspection Scope.

  4. Di bagian Inspection profile, pilih profil yang ingin Anda gunakan.
  5. Klik OK untuk menjalankan pemeriksaan.

    Gambar 4 menunjukkan lint dan inspeksi IDE lainnya hasil setelah menjalankan Inspect Code:

    Pilih masalah untuk melihat penyelesaiannya.
    Gambar 4. Hasil dari inspeksi. Pilih masalah untuk melihat resolusi.
  6. Di panel Inspection Results, lihat hasil pemeriksaan dengan meluaskan dan memilih kategori, jenis, atau masalah kesalahan.

    Panel Inspection Report menampilkan laporan pemeriksaan untuk kategori error, jenis, atau masalah yang dipilih di panel Inspection Results dan menampilkan nama serta lokasi error. Jika ada, laporan pemeriksaan akan menampilkan informasi lainnya, seperti sinopsis masalah, untuk membantu Anda mengoreksi masalah.

  7. Di tampilan hierarki panel Inspection Results, klik kanan sebuah kategori, jenis, atau masalah untuk layar menu konteks.

    Bergantung pada konteksnya, Anda dapat:

    • Beralih ke sumber.
    • Kecualikan dan sertakan item yang dipilih.
    • Menyembunyikan masalah.
    • Edit setelan.
    • Kelola peringatan pemeriksaan.
    • Jalankan kembali pemeriksaan.

Untuk deskripsi tombol toolbar, item menu konteks, dan pemeriksaan bidang laporan, lihat Jendela alat Inspection Results.

Menggunakan cakupan kustom

Gunakan salah satu cakupan kustom yang disediakan di Android Studio sebagai berikut:

  1. Dalam dialog Specify Inspection Scope, pilih Custom scope.
  2. Klik daftar Cakupan kustom untuk menampilkan opsi Anda:

    Memilih Cakupan Pemeriksaan
    Gambar 5. Pilih cakupan kustom yang ingin Anda digunakan.
    • Semua Tempat: Semua file.
    • Project Files: Semua file dalam project saat ini.
    • Project Source Files: Hanya file sumber dalam project saat ini.
    • Project Production Files: Hanya file produksi dalam project saat ini.
    • Project Test Files: Hanya file pengujian dalam project saat ini.
    • Scratches dan Console: Hanya file dan konsol scratch yang Anda buka di project saat ini.
    • File yang Baru Dilihat: Hanya file yang baru-baru ini dilihat dalam project saat ini.
    • Current File: Hanya file terbaru dalam project saat ini. Muncul bila Anda memiliki file atau folder yang dipilih.
    • Selected Directory: Hanya folder saat ini dalam project Anda saat ini. Muncul saat Anda memiliki folder yang dipilih.
    • Class Hierarchy: Jika Anda memilih opsi ini dan mengklik OK, dialog akan muncul dengan semua class dalam project saat ini. Dalam dialog, gunakan kolom Telusuri menurut Nama untuk memfilter dan memilih kelas untuk memeriksa. Jika Anda tidak memfilter daftar kelas, pemeriksaan kode akan memeriksa semua Google Cloud Platform.

    Jika Anda memiliki VCS yang dikonfigurasi untuk project, ada juga opsi untuk membatasi penelusuran hanya untuk file yang telah dimodifikasi.

  3. Klik OK.

Membuat cakupan kustom

Saat Anda ingin memeriksa sekumpulan file dan direktori yang tidak tercakup dalam cakupan kustom yang saat ini tersedia, Anda dapat membuat cakupan kustom:

  1. Dalam dialog Specify Inspection Scope, pilih Custom scope.
  2. Klik tiga titik setelah daftar Custom Scope.

    Dialog Specify Inspection Scope
    Gambar 6. Dialog Define Inspection Scope.

    Dialog Scopes akan muncul.

    Membuat cakupan kustom
    Gambar 7. Buat cakupan kustom.
  3. Klik di sudut kiri atas dialog untuk mendefinisikan ruang lingkup baru.
  4. Dalam daftar Add Scope yang muncul, pilih Local.

    Baik cakupan lokal maupun cakupan bersama digunakan dalam project untuk fitur Inspect Code. Cakupan Shared juga dapat digunakan bersama fitur project lainnya yang memiliki kolom cakupan. Misalnya, saat Anda mengklik Edit Settings untuk mengubah setelan untuk Find Usages, dialog yang dihasilkan memiliki kolom Scope tempat Anda dapat memilih cakupan bersama.

    Memilih cakupan bersama dari dialog Find Usages
    Gambar 8. Pilih cakupan bersama dari Dialog Find Usages.
  5. Beri nama cakupan tersebut, lalu klik OK.

    Panel kanan dialog Scopes diisi dengan opsi yang memungkinkan Anda menentukan cakupan kustom.

  6. Dari daftar, pilih Project.

    Daftar project yang tersedia akan ditampilkan.

    Catatan: Anda dapat membuat cakupan kustom untuk project atau paket. Tujuan langkahnya sama.

  7. Luaskan folder proyek, pilih mana yang ingin Anda tambahkan ke cakupan khusus, dan pilih untuk menyertakan atau mengecualikannya.

    Menentukan cakupan kustom
    Gambar 9. Tentukan cakupan kustom.
    • Include: Menyertakan folder ini dan file-filenya, tetapi tidak menyertakan subfoldernya.
    • Include Recursically: Menyertakan folder ini dan file-nya serta subfoldernya dan .
    • Exclude: Mengecualikan folder ini dan file-filenya, tetapi tidak mengecualikan subfoldernya.
    • Kecualikan Rekursif: Mengecualikan folder ini dan filenya serta subfoldernya dan .

    Gambar 10 menunjukkan bahwa folder main disertakan, dan folder java dan res disertakan secara rekursif. Warna biru menunjukkan folder yang disertakan sebagian, dan hijau menunjukkan folder dan file yang disertakan secara rekursif.

    Contoh pola untuk cakupan kustom
    Gambar 10. Contoh pola untuk cakupan kustom.
    • Jika Anda memilih folder java dan mengklik Exclude Recurs tugasnya, tanda hijau akan hilang di folder java dan semua folder serta file di bawahnya.
    • Jika Anda memilih file MainActivity.kt yang disorot hijau dan klik Exclude, MainActivity.kt tidak lagi ditandai dengan warna hijau, tetapi item lain dalam folder java akan tetap berwarna hijau.
  8. Klik OK. Cakupan kustom muncul di bagian bawah daftar.

Meninjau dan mengedit profil pemeriksaan

Android Studio memiliki sekumpulan lint dan profil pemeriksaan lainnya yang telah diupdate sampai Update Android. Anda dapat menggunakan profil ini apa adanya, atau edit nama, deskripsi, tingkat keseriusan, dan cakupan. Anda juga dapat mengaktifkan dan menonaktifkan seluruh grup profil atau satu per satu profil dalam sebuah grup.

Untuk mengakses setelan Inspections:

  1. Pilih File > Setelan. (di Windows) atau Android Studio > Preferensi (di macOS atau Linux).
  2. Pilih Editor > Inspeksi.
  3. Panel Inspections menampilkan daftar pemeriksaan yang didukung dan deskripsi.

    Pemeriksaan yang didukung dan deskripsinya
    Gambar 11. Inspeksi yang didukung dan deskripsi.
  4. Pilih daftar Profile untuk beralih antara Default (Android Studio) dan Pemeriksaan Project Default (project aktif).

    Untuk informasi selengkapnya, lihat IntelliJ Kelola profil.

  5. Dalam daftar Inspections di panel kiri, pilih kategori profil level teratas atau luaskan grup dan pilih profil tertentu.

    Saat memilih kategori profil, Anda dapat mengedit semua pemeriksaan dalam kategori itu sebagai satu pemeriksaan.

  6. Pilih daftar Show Schema Actions Ikon Tampilkan Tindakan Skema untuk menyalin, mengganti nama, menambahkan deskripsi ke, mengekspor, dan mengimpor pemeriksaan.
  7. Setelah selesai, klik OK.