Memperbaiki Android Studio Tidak Terdeteksi oleh `flutter doctor` (JetBrains Toolbox)

Saat menjalankan flutter doctor, sebagian developer Flutter menemukan error yang membingungkan: Android Studio dilaporkan tidak ditemukan, padahal aplikasinya sudah terpasang dan bisa dibuka normal lewat shortcut desktop atau dari Toolbox itu sendiri. Masalah ini sangat umum terjadi di macOS dan Linux, terutama bagi yang menginstal Android Studio lewat JetBrains Toolbox alih-alih installer resmi. Penting untuk dipahami sejak awal: masalahnya bukan Flutter yang rusak, melainkan Flutter tidak tahu di mana lokasi Android Studio terpasang. Artikel ini membahas cara memperbaiki masalah ini secara tuntas, beserta beberapa masalah turunan yang sering muncul setelahnya.

Latar Belakang Masalah

Ketika menjalankan:

flutter doctor

Error yang muncul biasanya berbentuk seperti ini:

[!] Android Studio
    ✗ Android Studio not found

Pesan ini terlihat seolah-olah Android Studio memang tidak terpasang, padahal kenyataannya aplikasi tersebut sudah ada di sistem dan bisa dijalankan tanpa masalah lewat shortcut atau JetBrains Toolbox itu sendiri. Kesalahpahaman inilah yang sering membuat developer mencoba menginstal ulang Android Studio — padahal langkah itu tidak akan menyelesaikan apa pun, karena akar masalahnya ada di tempat lain.

JetBrains Toolbox sendiri adalah aplikasi pengelola IDE buatan JetBrains yang memungkinkan instalasi, update, dan manajemen versi berbagai IDE (IntelliJ IDEA, PyCharm, Android Studio, dan lainnya) dari satu tempat terpusat. Kemudahan ini punya konsekuensi: Toolbox tidak menginstal aplikasi ke lokasi standar yang biasa dipakai installer resmi masing-masing IDE, melainkan ke direktori khusus yang dikelola Toolbox sendiri. Bagi pengguna Android Studio yang terbiasa dengan Toolbox untuk semua IDE JetBrains, perbedaan path ini sering tidak disadari sampai muncul error semacam ini di flutter doctor.

Kenapa Ini Terjadi?

Secara default, Flutter hanya mencoba mendeteksi Android Studio di lokasi-lokasi standar yang sudah dikenalnya — biasanya direktori instalasi default seperti /Applications/Android Studio.app di macOS atau /opt/android-studio di Linux. Sementara itu, JetBrains Toolbox menginstal Android Studio di path non-standar yang sepenuhnya berada di luar daftar lokasi yang dicek Flutter, misalnya:

~/.local/share/JetBrains/Toolbox/apps/AndroidStudio/

flowchart TD
    A[flutter doctor dijalankan] --> B{Cek lokasi standar Android Studio}
    B -- Ditemukan --> C[Android Studio: installed]
    B -- Tidak ditemukan --> D[Android Studio not found]
    D --> E{Diinstal via JetBrains Toolbox?}
    E -- Ya --> F[Path berada di lokasi non-standar]
    F --> G[Perlu didaftarkan manual ke Flutter]

Akibat dari perbedaan lokasi ini, tiga hal terjadi sekaligus: Android Studio benar-benar ada di sistem, aplikasi tersebut bisa dibuka secara normal lewat Toolbox, tapi flutter doctor tetap menganggap aplikasi tersebut tidak ada karena ia hanya mencari di lokasi yang sudah dikenalnya, bukan menelusuri seluruh sistem file.

Memverifikasi Instalasi Sebelum Memperbaiki

Sebelum langsung mendaftarkan path, ada baiknya memastikan dulu bahwa Android Studio memang sehat dan tidak mengalami masalah instalasi lain yang tidak berhubungan dengan deteksi path. Buka Android Studio secara manual lewat JetBrains Toolbox dan pastikan aplikasi terbuka tanpa error. Kalau Android Studio sendiri gagal terbuka atau menampilkan error saat startup, masalahnya bukan soal deteksi path oleh Flutter, melainkan instalasi Android Studio itu sendiri yang perlu diperbaiki atau diinstal ulang lewat Toolbox terlebih dahulu.

Setelah memastikan Android Studio berjalan normal, cara paling cepat menemukan path instalasi yang persis adalah lewat menu di dalam Toolbox sendiri — biasanya ada opsi “Settings” atau ikon roda gigi pada entry Android Studio yang menampilkan lokasi instalasi secara eksplisit. Alternatifnya, jalankan pencarian lewat terminal:

find ~/.local/share/JetBrains -maxdepth 4 -iname "*AndroidStudio*"

Perintah find ini menelusuri direktori ~/.local/share/JetBrains hingga kedalaman 4 level subfolder, mencari nama folder yang mengandung kata “AndroidStudio” tanpa memedulikan kapitalisasi (-iname). Hasilnya akan menunjukkan path persis yang dibutuhkan untuk langkah berikutnya, tanpa perlu menebak-nebak nomor versi yang sedang terinstal.

Solusi Utama (Paling Penting)

Cari Lokasi Android Studio

Langkah pertama adalah memastikan path persis tempat JetBrains Toolbox menginstal Android Studio. Path ini biasanya berada di salah satu lokasi berikut, tergantung sistem operasi yang dipakai:

Linux

~/.local/share/JetBrains/Toolbox/apps/AndroidStudio/

macOS

~/Library/Application Support/JetBrains/Toolbox/apps/AndroidStudio/

Di dalam direktori tersebut, biasanya akan ada struktur folder seperti berikut, dengan nomor versi yang bisa berbeda-beda tergantung kapan Android Studio terakhir diperbarui lewat Toolbox:

AndroidStudio/
└── ch-0/
    └── 2023.3.1/
        └── Android Studio.app

ch-0 di sini merujuk pada channel rilis (biasanya channel stable), sementara 2023.3.1 adalah nomor versi spesifik yang terinstal. Path lengkap yang dibutuhkan Flutter adalah path sampai ke folder versi ini, bukan sampai ke file .app itu sendiri.

Kalau kamu memakai Windows, JetBrains Toolbox juga menginstal Android Studio di lokasi non-standar yang serupa, biasanya di:

%LOCALAPPDATA%\JetBrains\Toolbox\apps\AndroidStudio\

Struktur subfoldernya juga mengikuti pola ch-0/<versi>/ yang sama seperti di Linux dan macOS, hanya saja path dasarnya memakai konvensi Windows. Prinsip perbaikannya tetap identik di ketiga sistem operasi — hanya format path yang berbeda.

Daftarkan Path Android Studio ke Flutter

Setelah path ditemukan, daftarkan secara eksplisit ke konfigurasi Flutter dengan perintah:

flutter config --android-studio-dir="/path/ke/AndroidStudio"

Contoh konkret untuk Linux, dengan path yang sudah mencakup channel dan versi:

flutter config --android-studio-dir="$HOME/.local/share/JetBrains/Toolbox/apps/AndroidStudio/ch-0/2023.3.1"

Perintah flutter config menyimpan konfigurasi ini secara permanen di file konfigurasi Flutter, sehingga tidak perlu diulang setiap kali membuka terminal baru. Setelah path terdaftar, cek ulang status Flutter dengan:

flutter doctor

Pada kebanyakan kasus, masalah langsung selesai begitu langkah ini dijalankan dengan path yang benar — flutter doctor akan langsung mengenali Android Studio sebagai terinstal dan siap dipakai.

Kalau JetBrains Toolbox memperbarui Android Studio ke versi baru di kemudian hari, folder versi (2023.3.1 pada contoh di atas) akan berubah namanya, dan kamu perlu menjalankan ulang flutter config --android-studio-dir dengan path versi yang baru. Ini sering jadi penyebab error yang sama muncul kembali setelah update.

Masalah Tambahan yang Sering Muncul

Setelah path Android Studio berhasil didaftarkan, beberapa masalah turunan masih bisa muncul karena saling berkaitan dengan konfigurasi Android Studio itu sendiri.

Plugin Flutter & Dart Belum Terpasang

Kalau flutter doctor masih menampilkan:

✗ Flutter plugin not installed
✗ Dart plugin not installed

Artinya Android Studio sudah terdeteksi, tapi plugin yang dibutuhkan untuk pengembangan Flutter belum terpasang di dalamnya. Untuk memperbaikinya:

1. Buka Android Studio
2. Masuk ke Settings → Plugins
3. Cari dan install plugin Flutter (plugin Dart akan ikut terpasang otomatis sebagai dependency-nya)
4. Restart Android Studio agar plugin baru benar-benar aktif

Android SDK Tidak Terdeteksi

Kalau Flutter tidak menemukan Android SDK, daftarkan lokasinya secara eksplisit:

flutter config --android-sdk="$HOME/Android/Sdk"

Selain itu, pastikan environment variable yang relevan juga sudah diset, karena beberapa tool command-line Android (seperti adb) butuh ANDROID_HOME untuk berfungsi dengan benar:

export ANDROID_HOME="$HOME/Android/Sdk"
export PATH="$ANDROID_HOME/platform-tools:$PATH"

Tambahkan dua baris ini ke file shell profile (.bashrc, .zshrc, atau yang sesuai dengan shell yang dipakai) agar environment variable ini otomatis aktif setiap kali terminal dibuka, bukan hanya untuk sesi terminal saat ini.

Android SDK sendiri biasanya terinstal di lokasi default ~/Android/Sdk di Linux atau ~/Library/Android/sdk di macOS — tapi kalau Android Studio sebelumnya pernah diinstal lewat cara lain (misalnya installer terpisah sebelum beralih ke Toolbox), SDK bisa saja berada di lokasi yang berbeda dari instalasi Android Studio yang sekarang. Memeriksa lokasi SDK lewat Android Studio sendiri (Settings → Languages & Frameworks → Android SDK) adalah cara paling pasti untuk memastikan path yang didaftarkan ke Flutter sesuai dengan yang sebenarnya dipakai.

Command Line Tools Belum Terinstall

Buka Android Studio, lalu masuk ke:

Settings → Android SDK → SDK Tools

Pastikan dua komponen berikut tercentang dan terinstal:

• Android SDK Command-line Tools
• Android SDK Platform Tools

Komponen ini sering jadi penyebab tersembunyi dari error di flutter doctor, karena Android Studio bisa terinstal lengkap sementara komponen command-line tools-nya justru belum terpasang — keduanya dipisah sebagai opsi terpisah di SDK Manager, dan tidak otomatis tercentang semua secara default.

Hal ini terjadi karena Android Studio dan Android SDK sebenarnya adalah dua hal yang terpisah meski biasanya terinstal bersamaan. Android Studio adalah IDE-nya — editor, debugger, dan tooling visual. Android SDK adalah kumpulan tool command-line dan library yang dipakai untuk build, compile, dan menjalankan aplikasi Android, termasuk adb, aapt, dan emulator. SDK Manager di dalam Android Studio menyediakan opsi untuk mengelola komponen SDK ini secara granular, sehingga sangat mungkin Android Studio terinstal sempurna tapi beberapa komponen SDK yang dibutuhkan Flutter belum ikut tercentang.

Setelah mencentang komponen yang hilang di SDK Manager, restart terminal sebelum menjalankan flutter doctor lagi. Beberapa environment variable dan path tool baru tidak langsung terbaca di sesi terminal yang sudah terbuka sebelumnya.

Masalah Java / JDK

Kadang muncul error terkait Java:

Unable to find bundled Java version

Solusi cepat untuk masalah ini adalah mendaftarkan path JDK secara eksplisit:

flutter config --jdk-dir="/path/ke/jdk"

Biasanya JDK sudah dibundel di dalam instalasi Android Studio sendiri (folder jbr, singkatan dari JetBrains Runtime), tapi Flutter gagal mendeteksinya secara otomatis kalau path Android Studio yang terdaftar belum benar di langkah sebelumnya. Memperbaiki --android-studio-dir terlebih dahulu sering secara tidak langsung menyelesaikan masalah JDK ini juga, karena Flutter biasanya mencari JDK relatif terhadap lokasi Android Studio yang terdaftar.

Sebagai referensi cepat, berikut rangkuman masalah-masalah yang dibahas beserta perintah perbaikannya:

Tabel ini berguna sebagai checklist cepat dan referensi yang mudah diakses kalau kamu sudah pernah membaca panduan ini sebelumnya dan hanya butuh mengingat perintah yang tepat, tanpa membaca ulang penjelasan lengkapnya dari awal.

Checklist Akhir

Sebelum menganggap masalah selesai, pastikan semua poin berikut sudah terpenuhi:

□ Android Studio path sudah dikonfigurasi (flutter config --android-studio-dir)
□ Android SDK terdeteksi (flutter config --android-sdk jika perlu)
□ Plugin Flutter & Dart terpasang di Android Studio
□ Command-line tools terinstall (Android SDK Command-line Tools, Platform Tools)
□ Terminal sudah di-restart setelah perubahan konfigurasi

Setelah seluruh poin di atas terpenuhi, jalankan verifikasi akhir dengan:

flutter doctor -v

Flag -v (verbose) menampilkan detail lebih lengkap dibanding flutter doctor biasa, termasuk path persis yang terdeteksi untuk setiap komponen. Kalau semua konfigurasi benar, Android Studio akan muncul sebagai installed dan ready to use di output tersebut, dan seluruh tanda seru atau tanda silang yang sebelumnya muncul akan berubah menjadi tanda centang hijau.

Ringkasan

• Error “Android Studio not found” di flutter doctor biasanya bukan tanda Android Studio rusak — Flutter hanya tidak tahu lokasinya.
• JetBrains Toolbox menginstal Android Studio di path non-standar, sehingga perlu didaftarkan manual lewat flutter config --android-studio-dir.
• Path yang didaftarkan harus sampai ke folder versi (misalnya ch-0/2023.3.1), bukan ke file .app itu sendiri.
• Update Android Studio lewat Toolbox mengubah folder versi, sehingga path perlu didaftarkan ulang setelah update.
• Plugin Flutter & Dart, Android SDK, command-line tools, dan JDK adalah komponen terpisah yang masing-masing bisa jadi sumber error tersendiri.
• Banyak masalah turunan (seperti JDK tidak terdeteksi) otomatis terselesaikan begitu path Android Studio sudah benar.
• Selalu restart terminal setelah mengubah konfigurasi, dan verifikasi akhir dengan flutter doctor -v untuk melihat detail lengkap.