Kotlin으로 Android AlarmManager 구현하는 방법 – 단계별 완벽 가이드

이 튜토리얼에서는 Kotlin을 사용해 Android 앱에서 AlarmManager를 구현하는 방법을 단계별로 살펴봅니다. AlarmManager는 앱이 실행 중이 아니더라도 특정 시간에 작업을 실행할 수 있게 해주는 강력한 시스템 서비스입니다. 이번 예제에서는 TimePicker로 사용자가 원하는 시간을 선택하고, 해당 시간에 매일 반복되는 알람을 등록하는 기능을 만들어 보겠습니다.

1단계: 새 프로젝트 생성

Android Studio에서 File → New Project를 선택한 후, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다. 언어는 Kotlin으로 지정하세요.

2단계: 레이아웃 파일(activity_main.xml) 작성

res/layout/activity_main.xml에 아래 코드를 추가합니다. 화면에는 시간을 선택할 수 있는 TimePicker와 알람을 설정하는 Button이 배치됩니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="2dp"
    tools:context=".MainActivity">
    <TimePicker
        android:id="@+id/timePicker"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true" />
    <Button
        android:id="@+id/buttonAlarm"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@id/timePicker"
        android:layout_centerInParent="true"
        android:layout_marginTop="10dp"
        android:text="Set Alarm" />
</RelativeLayout>

3단계: MainActivity.kt에 알람 로직 구현

src/MainActivity.kt에 아래 코드를 추가합니다. 핵심 흐름은 다음과 같습니다.

• 사용자가 TimePicker에서 선택한 시간을 Calendar 객체에 반영합니다.
• setRepeating() 메서드를 호출해 하루 간격(INTERVAL_DAY)으로 반복되는 알람을 등록합니다.
• 알람이 울리면 BroadcastReceiver(MyAlarm)의 onReceive()가 호출되어 로그를 출력합니다.

import android.app.AlarmManager
import android.app.PendingIntent
import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.os.Build
import android.os.Bundle
import android.util.Log
import android.widget.Button
import android.widget.TimePicker
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import java.util.*
class MainActivity : AppCompatActivity() {
    lateinit var btnSetAlarm: Button
    lateinit var timePicker: TimePicker
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        timePicker = findViewById(R.id.timePicker)
        btnSetAlarm = findViewById(R.id.buttonAlarm)
        btnSetAlarm.setOnClickListener {
            val calendar: Calendar = Calendar.getInstance()
            if (Build.VERSION.SDK_INT >= 23) {
                calendar.set(
                    calendar.get(Calendar.YEAR),
                    calendar.get(Calendar.MONTH),
                    calendar.get(Calendar.DAY_OF_MONTH),
                    timePicker.hour,
                    timePicker.minute,
                    0
                )
            } else {
                calendar.set(
                    calendar.get(Calendar.YEAR),
                    calendar.get(Calendar.MONTH),
                    calendar.get(Calendar.DAY_OF_MONTH),
                    timePicker.currentHour,
                    timePicker.currentMinute, 0
                )
            }
            setAlarm(calendar.timeInMillis)
        }
    }
    private fun setAlarm(timeInMillis: Long) {
        val alarmManager = getSystemService(Context.ALARM_SERVICE) as AlarmManager
        val intent = Intent(this, MyAlarm::class.java)
        val pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0)
        alarmManager.setRepeating(
            AlarmManager.RTC,
            timeInMillis,
            AlarmManager.INTERVAL_DAY,
            pendingIntent
        )
        Toast.makeText(this, "Alarm is set", Toast.LENGTH_SHORT).show()
    }
    private class MyAlarm : BroadcastReceiver() {
        override fun onReceive(
            context: Context,
            intent: Intent
        ) {
            Log.d("Alarm Bell", "Alarm just fired")
        }
    }
}

참고: API 31(Android 12) 이상에서의 플래그 처리

Android 12(API 레벨 31)부터는 PendingIntent 생성 시 가변성(mutability) 플래그를 반드시 명시해야 합니다. 최신 기기를 지원하려면 아래처럼 수정하는 것이 좋습니다.

val pendingIntent = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    PendingIntent.getBroadcast(this, 0, intent, PendingIntent.FLAG_IMMUTABLE)
} else {
    PendingIntent.getBroadcast(this, 0, intent, 0)
}

4단계: AndroidManifest.xml 확인

androidManifest.xml은 아래와 같습니다. BroadcastReceiver를 내부 클래스로 선언했기 때문에 별도의 receiver 등록은 필요하지 않습니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 Android 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭하세요. 목록에서 자신의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.

TimePicker에서 원하는 시간을 선택하고 Set Alarm 버튼을 누르면 "Alarm is set"이라는 토스트 메시지가 나타나며, 설정된 시간마다 Logcat에 "Alarm just fired" 로그가 출력되는 것을 확인할 수 있습니다.