Debug dalam pengembangan seluler — esensi mode debugging dan cara kerjanya

Esensi mode Debug dalam pengembangan seluler

Debug (debugging) — bukan sekadar flag compiler, melainkan serangkaian pengaturan yang membuat aplikasi transparan bagi pengembang. Dalam mode Debug, compiler menambahkan tabel nama simbolik (DWARF) ke file yang dapat dieksekusi, yang menghubungkan kode mesin dengan baris sumber asli. Tanpa tabel ini, debugger tidak dapat menunjukkan baris kode mana yang sedang dieksekusi.

Debugger — program yang menjalankan aplikasi Anda di lingkungan yang terkontrol. Anda dapat menjeda eksekusi di baris mana pun (breakpoint), melihat nilai semua variabel di cakupan saat ini, mengubahnya dengan cepat, dan melanjutkan eksekusi. Untuk platform seluler, debugger standar adalah LLDB — komponen LLVM yang digunakan baik di Xcode maupun Android Studio.

Mode Debug juga mengaktifkan pemeriksaan tambahan yang dinonaktifkan di Release: asersi (assertions), pemeriksaan batas array, detektor kebocoran memori, dan pencatatan yang diperluas. Pemeriksaan ini memperlambat aplikasi tetapi mendeteksi kesalahan pada tahap awal pengembangan — sebelum kode sampai ke pengguna.

Debug dan Release: perbedaan utama build

Perbedaan antara build Debug dan Release sangat mendasar: ini adalah dua set flag compiler, konfigurasi penandatanganan, dan pengaturan pengepakan yang berbeda. Memahami perbedaan ini membantu menghindari situasi di mana “berfungsi di simulator, tetapi di perangkat nyata — tidak”.

Kapan menggunakan apa

Build Debug digunakan di semua tahap pengembangan dan pengujian pada perangkat lokal. Build Release dibuat sebelum dikirim ke App Store Connect atau Google Play Console. Melakukan debugging pada build Release secara teknis mungkin dilakukan, tetapi sangat tidak nyaman karena metode yang diganti namanya (R8) dan tidak adanya symbolication untuk log crash.

Masalah perpindahan mode

Salah satu masalah umum adalah kode yang berfungsi di Debug tetapi gagal di Release. Penyebabnya adalah UB (undefined behavior) dalam kode yang diproses compiler secara berbeda pada tingkat optimalisasi yang berbeda. Contoh tipikal: membaca variabel yang tidak diinisialisasi atau pelanggaran strict aliasing. Untuk mendeteksi kesalahan seperti ini, gunakan penganalisis statis (Clang Static Analyzer, ktlint) sebelum setiap build Release.

Alat debugging: LLDB, breakpoint, dan inspector

LLDB — adalah debugger berkinerja tinggi berbasis LLVM yang mendukung C, C++, Objective-C, Swift, dan Kotlin/Native. LLDB menyediakan antarmuka REPL di mana Anda dapat mengeksekusi ekspresi arbitrer, mengubah nilai variabel, dan memanggil fungsi dalam konteks aplikasi yang dijeda.

Breakpoint dan jenisnya

Breakpoint — alat utama debugger. Anda menempatkan titik pada baris kode, dan aplikasi berhenti ketika eksekusi mencapai baris tersebut. LLDB mendukung beberapa jenis titik: bersyarat (hanya aktif ketika kondisi terpenuhi), simbolik (pada pemanggilan fungsi), dan sekali pakai (aktif sekali dan dihapus otomatis).

Watchpoint dan inspector memori

Watchpoint — titik pengamatan perubahan variabel. Anda menentukan alamat memori, dan debugger menjeda eksekusi pada setiap penulisan ke alamat tersebut. Alat ini sangat diperlukan saat mencari perlombaan data dan mutasi objek bersama yang salah. Untuk melihat hierarki UIKit, gunakan UIView Inspector yang tersedia di Xcode.

// Mengatur breakpoint bersyarat
(lldb) breakpoint set --name "viewDidLoad" --condition "self.isViewLoaded == false"

// Watchpoint pada properti
(lldb) watchpoint set variable self->_loadingState

// Menjalankan kode dalam konteks penghentian
(lldb) expr self.view.backgroundColor = UIColor.redColor

Inspector Xcode dan Android Studio

Kedua IDE menyediakan inspector grafis berbasis LLDB. Android Studio mencakup Layout Inspector (melihat hierarki View), Network Inspector (melacak permintaan HTTP), dan Database Inspector (SQLite waktu nyata). Xcode menyediakan Debug Memory Graph (analisis kebocoran memori) dan View Debugger (tampilan 3D lapisan UIKit).

Debugging jarak jauh dan debugging melalui Wi-Fi

Mulai Android 11, debugging melalui Wi-Fi berfungsi tanpa koneksi USB: cukup pindai kode QR dari Android Studio. iOS mendukung debugging Wi-Fi sejak Xcode 9+ — perangkat terhubung sekali melalui USB, setelah itu sesi debugging dapat berlangsung melalui jaringan. Untuk server CI, debugging Wi-Fi tidak cocok karena latensi yang tidak dapat diprediksi dan kehilangan paket, oleh karena itu dalam pipeline otomatis selalu digunakan USB. Namun, untuk pengembangan lokal, debugging Wi-Fi jauh lebih nyaman — pengembang tidak terikat kabel dan dapat menguji aplikasi pada perangkat di seberang ruangan.

Debug di Android: Android Studio dan debugging melalui ADB

Android Debug Bridge (ADB) — alat universal untuk berinteraksi dengan perangkat Android dari baris perintah. Melalui ADB Anda dapat menginstal aplikasi, memulai debugging, menyalin file, menjalankan perintah shell, dan melihat log. Android Studio menggunakan ADB di belakang layar untuk semua operasi debugging.

Menghubungkan debugger di Android Studio

Android Studio mendukung dua mode debugging: Run (menjalankan biasa) dan Debug (menjalankan dengan debugger terhubung). Dalam mode Debug, Anda dapat mengatur breakpoint langsung di editor, melihat variabel di Debug Tool Window, dan mengevaluasi ekspresi di Evaluate Expression. Untuk debugging proses latar belakang (Service, BroadcastReceiver), gunakan Attach Debugger to Android Process.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Breakpoint di sini akan menjeda eksekusi
        val button = findViewById<Button>(R.id.btn_debug)
        button.setOnClickListener {
            startDebugProcess()
        }
    }

    private fun startDebugProcess() {
        val data = fetchDataFromApi()
        Log.d("Debug", "Data loaded: $data")
    }
}

ADB shell dan inspeksi database

Perintah ADB shell memberikan akses ke sistem file perangkat tanpa hak root. Anda dapat melihat isi direktori databases, menyalin file .db ke komputer, dan membukanya dengan klien SQLite apa pun. Android Studio Database Inspector mengotomatiskan proses ini: Anda melihat data database langsung secara real-time dan dapat menjalankan kueri SQL langsung dari IDE.

Debug di iOS: Xcode, debugger, dan diagnostik

Xcode menyediakan lingkungan debugging terintegrasi berbasis LLDB. Pengembang dapat menjalankan aplikasi di simulator atau perangkat fisik, mengatur breakpoint, dan menggunakan Debug Navigator untuk mengontrol aliran eksekusi. Tidak seperti Android, iOS tidak mengizinkan menjalankan dua build Debug secara bersamaan pada satu perangkat tanpa konfigurasi khusus.

Debugging di simulator dan di perangkat

Simulator menjalankan aplikasi sebagai proses macOS asli, yang memberikan siklus debugging tercepat. Pada perangkat fisik, debugging dilakukan melalui USB atau Wi-Fi (mulai iOS 16), dan LLDB berkomunikasi dengan debugserver di perangkat. Kinerja debugging pada perangkat lebih rendah karena bandwidth USB 2.0 yang terbatas, tetapi hanya perangkat fisik yang memungkinkan pengujian skenario nyata: notifikasi push, kamera, sensor.

import UIKit

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        setupUI()
    }

    private func setupUI() {
        let label = UILabel()
        label.text = "Debug Mode"
        label.textColor = .systemBlue
        view.addSubview(label)
    }
}

Diagnostik dan laporan crash

Xcode Organizer mengumpulkan log crash dari perangkat penguji melalui Crash Logs. Untuk symbolication (konversi alamat menjadi nama fungsi), diperlukan file .dSYM yang dihasilkan pada setiap build Debug. Dalam build Release, dSYM juga dibuat, tetapi log crash dari App Store harus dimuat ke Organizer secara manual atau melalui layanan bitcode.