← blog

xcrun simctl not found? Dua penyebab dan cara memperbaikinya

25 Oktober 2026 · 5 menit baca

Anda mengetik xcrun simctl list dan yang muncul error, bukan daftar simulator. Ada dua masalah berbeda yang menyebabkannya, dan perbaikannya juga berbeda. Teks error-nya memberi tahu mana yang Anda alami.

Kami mengalami yang kedua di satu rak Mac mini baru. Xcode sudah terpasang dan xcodebuild -version berjalan normal. Tapi setiap build simulator iOS tetap akan gagal. Berikut arti tiap error dan perintah persis yang memperbaikinya.

Error mana yang Anda alami?

Penyebab 1: yang dipilih Command Line Tools

Pesannya seperti ini:

xcrun: error: unable to find utility "simctl", not a developer tool or in PATH

Command Line Tools memberi Anda compiler dan git, tapi tanpa simulator. Jika itu direktori developer yang aktif, xcrun mencari di sana dan tidak menemukan simctl. Cek mana yang aktif:

xcode-select -p
# /Library/Developer/CommandLineTools          (the problem)
# /Applications/Xcode.app/Contents/Developer   (what you want)

Arahkan ke Xcode. Pakai path yang sebenarnya jika nama Xcode Anda memuat nomor versi.

sudo xcode-select -s /Applications/Xcode.app
xcrun simctl list runtimes

Penyebab 2: first launch Xcode tidak pernah berjalan

Yang ini terlihat lebih aneh. Xcode sudah dipilih, tapi simctl sendiri gagal:

Install Started
Install Failed: Authorization is required to install the packages.
/Applications/Xcode.app/Contents/Developer/usr/bin/simctl: line 15:
  /Library/Developer/PrivateFrameworks/CoreSimulator.framework/Versions/A/Resources/bin/simctl:
  No such file or directory

Saat Xcode dibuka pertama kali, ia memasang beberapa paket sistem. Salah satunya CoreSimulator, di /Library/Developer/PrivateFrameworks. simctl di dalam Xcode hanyalah script kecil yang meneruskan ke framework itu. Jika Xcode terpasang tapi tidak pernah dibuka, framework itu tidak ada.

Ini umum di mesin CI dan Mac headless. Tidak ada yang membuka Xcode di sana. Tool yang memasang Xcode untuk Anda, seperti xcodes, menyalin aplikasinya tapi tidak menjalankan first launch. Anda bisa memastikannya:

xcodebuild -checkFirstLaunchStatus; echo $?
# 69 means first launch has not run. 0 means it has.

Perbaikannya dua perintah:

# 1. install Xcode's first-launch packages, including CoreSimulator
sudo xcodebuild -runFirstLaunch

# 2. install an iOS simulator runtime if there is none
sudo xcodebuild -downloadPlatform iOS

Di mini M6 kami dengan Xcode 26.6, perintah pertama selesai dalam 8 detik. Perintah kedua mengunduh runtime iOS 26.5 dalam sekitar empat setengah menit dan memakai sekitar 9 GB disk. Tidak perlu Apple ID. Lalu:

xcrun simctl list runtimes
== Runtimes ==
iOS 26.5 (26.5 - 23F77) - com.apple.CoreSimulator.SimRuntime.iOS-26-5

Buat Mac CI memeriksa dirinya sendiri

Jebakannya, xcodebuild -version berjalan normal di Mac yang punya masalah ini. Health check yang dibangun di atasnya akan lulus, lalu build simulator pertama gagal. Jadi periksa hal yang benar-benar Anda butuhkan:

Kini kami menjalankan pemeriksaan ini setiap kali Mac bergabung ke armada kami. Setiap mesin MacRun datang dengan first launch Xcode sudah selesai dan runtime simulator iOS sudah terpasang. Jadi build pertama di sana langsung jalan.

Pertanyaan

Kenapa xcrun bilang tidak bisa menemukan simctl?
Biasanya karena direktori developer yang aktif adalah Command Line Tools, bukan Xcode. Command Line Tools tidak punya tool simulator. Arahkan xcode-select ke Xcode dengan sudo xcode-select -s /Applications/Xcode.app, lalu coba lagi.
Apa arti "simctl: No such file or directory"?
Xcode sudah dipilih, tapi paket first launch-nya tidak pernah dipasang. Paket itu menaruh CoreSimulator di /Library/Developer/PrivateFrameworks. Jalankan sudo xcodebuild -runFirstLaunch untuk memasangnya.
Apakah xcodebuild -downloadPlatform iOS butuh Apple ID?
Tidak. Di Mac kami dengan Xcode 26.6, perintah ini mengunduh dan memasang runtime simulator iOS 26.5 tanpa login. Prosesnya sekitar empat setengah menit dan memakai sekitar 9 GB disk.
Bagaimana cara memastikan Mac CI siap sebelum build?
Jalankan xcodebuild -checkFirstLaunchStatus. Hasilnya 0 jika first launch sudah selesai. Lalu jalankan xcrun simctl list runtimes dan pastikan ada minimal satu baris iOS.

Hitung angka Anda sendiri dengan kalkulator atau sewa runner.