Android Academy · 강의

디버깅과 프로파일링

Android Studio의 디버깅 및 프로파일링 도구를 익힙니다. 중단점, Logcat, Timber, Memory Profiler, LeakCanary, CPU Profiler, Network Inspector, Layout Inspector를 다룹니다.

디버깅과 프로파일링은(는) CoddyKit의 무료 Android Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Android Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

디버깅 개요

디버깅은 버그를 찾아 수정하는 과정입니다. Android Studio는 강력한 도구를 제공합니다.

디버거 — 실행을 일시 중지하고, 변수를 검사하며, 코드를 단계별로 실행합니다.
Logcat — 기기에서 실시간으로 출력되는 로그입니다.
레이아웃 검사기 — 실행 중인 UI 계층 구조를 검사합니다.
Android Profiler — CPU, 메모리 및 네트워크를 분석합니다.
데이터베이스 검사기 — 실행 중인 Room 데이터베이스를 확인하고 쿼리합니다.

Logcat — 첫 번째 디버깅 도구

Log를 사용하여 Logcat에 메시지를 출력합니다. TAG를 사용하면 로그를 필터링할 수 있습니다.

import android.util.Log

class UserRepository {
    companion object {
        private const val TAG = "UserRepo"
    }

    fun fetchUsers() {
        Log.d(TAG, "fetchUsers() called")        // Debug
        Log.i(TAG, "Fetching ${users.size} users") // Info
        Log.w(TAG, "Cache is empty")               // Warning
        Log.e(TAG, "Network error: $exception")    // Error
    }
}

Timber — 더 나은 로깅

Timber는 Log를 감싸는 얇은 래퍼입니다. 릴리스 빌드에서는 로그 호출을 제거하고 클래스 이름을 TAG로 자동 추가합니다.

// app/build.gradle:
// implementation 'com.jakewharton.timber:timber:5.0.1'

// In Application.onCreate():
if (BuildConfig.DEBUG) {
    Timber.plant(Timber.DebugTree())
}

// Usage anywhere in the app (no TAG needed):
Timber.d("User loaded: %s", user.name)
Timber.e(exception, "Failed to fetch data")
Timber.w("Cache miss for key: %s", key)

중단점과 디버거

Android Studio에서 중단점을 사용하여 디버깅하는 단계입니다.

코드 줄 옆의 거터(왼쪽 여백)를 클릭하면 빨간 점이 나타납니다.
실행 대신 디버그(버그 아이콘)로 앱을 실행합니다.
실행이 중단점에 도달하면 일시 중지됩니다.
변수 창에서 변수를 검사합니다.
Step Over(F8)로 코드를 한 줄씩 실행하고, Step Into(F7)로 함수 내부에 들어갑니다.

식 평가

중단점에서 일시 중지된 동안 식 평가(Alt+F8)를 사용하면 현재 범위에서 Kotlin 코드를 실행할 수 있습니다. 다시 시작하지 않고 가정을 테스트해 보세요.

list.size, user.email.isNotBlank()를 확인합니다.
어떤 메서드든 호출하여 반환 값을 확인합니다.
복잡한 객체를 코드 안에서 바로 검사합니다.

메모리 프로파일러

메모리 프로파일러(보기 → 도구 창 → 프로파일러)를 사용하여 메모리 누수를 찾습니다.

시간에 따른 힙 크기를 확인합니다. 계속 증가한다면 누수일 가능성이 높습니다.
가비지 컬렉션을 강제로 실행하고 메모리가 감소하는지 확인합니다.
힙 덤프를 생성하여 어떤 객체가 살아 있는지 확인합니다.
가비지 컬렉션되었어야 하는 Activity 또는 Fragment 인스턴스를 찾습니다.

LeakCanary — 자동 누수 감지

LeakCanary는 디버그 빌드에서 메모리 누수를 자동으로 감지하고 알림으로 보고합니다.

// app/build.gradle:
debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.12'

// That's it — no code changes needed!
// LeakCanary auto-installs via ContentProvider.
// When a leak is detected, it shows a notification with the leak trace.

// Common causes to watch for:
// - Static references to Context/Activity
// - Not releasing ViewBinding in onDestroyView()
// - Listeners registered to singletons but not unregistered

CPU 프로파일러

CPU 프로파일러로 성능 병목을 찾습니다.

작업을 수행하는 동안 추적을 기록합니다.
불꽃 차트에서 어떤 메서드가 가장 많은 시간을 사용하는지 확인합니다.
메인 스레드에서 오래 실행되는 작업을 찾습니다. 이러한 작업은 UI를 끊기게 만듭니다.
무거운 계산을 Dispatchers.IO 또는 Dispatchers.Default로 옮깁니다.

네트워크 검사기

네트워크 검사기는 앱에서 수행하는 모든 HTTP 호출을 실시간으로 보여 줍니다.

요청 URL, 메서드, 헤더 및 본문을 확인합니다.
응답 코드, 본문 및 소요 시간을 확인합니다.
느리거나 실패하는 요청을 식별합니다.
기본적으로 OkHttp(Retrofit에서 사용하는 라이브러리)와 함께 작동합니다.

보기 → 도구 창 → 앱 검사 → 네트워크 검사기에서 엽니다.

데이터베이스 검사기

실행 중인 기기에서 Room 데이터베이스를 실시간으로 검사하고 쿼리합니다.

테이블과 테이블의 내용을 확인합니다.
사용자 지정 SQL 쿼리를 실행합니다.
앱을 사용하는 동안 데이터가 변경되는 모습을 확인합니다.

앱 검사 → 데이터베이스 검사기에서 엽니다. API 26 이상에서 Room과 함께 작동합니다.

레이아웃 검사기

레이아웃 검사기는 UI 계층 구조를 실시간 3D 화면으로 보여 줍니다.

뷰를 선택하여 속성(여백, 내부 여백, 텍스트, 색상)을 확인합니다.
겹쳐 있는 뷰나 잘못된 표시 상태를 찾습니다.
추측하지 않고 레이아웃 문제를 디버깅합니다.

보기 → 도구 창 → 레이아웃 검사기에서 엽니다. 기기 또는 에뮬레이터에서 실행 중인 앱에 연결합니다.

StrictMode

StrictMode는 메인 스레드에서 실수로 실행된 느린 작업(디스크 읽기, 네트워크 호출)을 감지하고 디버그 빌드에서 로그를 기록하거나 앱을 중단합니다.

// In Application.onCreate() — debug builds only:
if (BuildConfig.DEBUG) {
    StrictMode.setThreadPolicy(
        StrictMode.ThreadPolicy.Builder()
            .detectDiskReads()
            .detectDiskWrites()
            .detectNetwork()
            .penaltyLog()      // log violations instead of crashing
            .build()
    )
}

빠른 확인

추가 코드 없이 Android 디버그 빌드에서 메모리 누수를 자동으로 감지하는 도구는 무엇인가요?

복습: 디버깅 및 프로파일링

문제를 효율적으로 찾고 수정하세요.

Logcat + Timber — 가벼운 로깅이며 릴리스 빌드에서 자동으로 제거됩니다.
중단점 + 디버거 — 실행을 일시 중지하고 실행 상태를 검사합니다.
메모리 프로파일러 — 힙 증가와 누수를 감지합니다.
LeakCanary — 스택 추적과 함께 누수를 자동으로 감지합니다.
CPU 프로파일러 — 메인 스레드에서 느린 메서드를 찾습니다.
네트워크 검사기 — HTTP 호출을 모니터링합니다.
데이터베이스 검사기 — Room을 실시간으로 쿼리합니다.
StrictMode — 실수로 메인 스레드에서 수행한 IO를 감지합니다.

축하합니다. 전체 Android 개발 과정을 완료하셨습니다!

자주 묻는 질문

“디버깅과 프로파일링” 강의는 무료인가요?

네 — “디버깅과 프로파일링” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Android Academy 강의 전체를 잠금 해제할 수 있습니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“디버깅과 프로파일링”에서 뭘 배우나요?

Android Studio의 디버깅 및 프로파일링 도구를 익힙니다. 중단점, Logcat, Timber, Memory Profiler, LeakCanary, CPU Profiler, Network Inspector, Layout Inspector를 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Android Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Android Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Android Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“디버깅과 프로파일링” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Android Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Android Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Android Academy(으)로 돌아가기