안드로이드 AlarmManager로 알람 설정하는 방법 — 단계별 코틀린 예제

이 글은 안드로이드에서 AlarmManager(알람 매니저)를 사용하는 방법을 단계별로 설명합니다. AlarmManager는 지정한 시간에 작업을 실행하도록 예약할 수 있는 안드로이드의 핵심 API로, 알람·반복 작업·타이머 기능 구현에 널리 활용됩니다.

1단계 — 새 프로젝트 생성

Android Studio에서 File ⇒ New Project를 선택하고, 새 프로젝트 생성에 필요한 정보를 모두 입력한 뒤 프로젝트를 만듭니다.

2단계 — activity_main.xml 레이아웃 작성

res/layout/activity_main.xml 파일에 다음 코드를 추가합니다. 화면에는 시간을 선택할 수 있는 TimePicker와 알람을 등록하는 버튼이 배치됩니다.

<?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="8dp"
    tools:context=".MainActivity">

    <LinearLayout
        android:id="@+id/linearLayout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerVertical="true"
        android:orientation="vertical">

        <TimePicker
            android:id="@+id/timePicker"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />

        <Button
            android:id="@+id/buttonAlarm"
            android:layout_gravity="center"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Set Alarm" />

    </LinearLayout>
</RelativeLayout>

3단계 — MainActivity.kt 작성

src/MainActivity.kt에 다음 코드를 추가합니다. TimePicker에서 선택한 시간으로 Calendar 객체를 구성한 뒤 setRepeating() 메서드를 호출해 하루 간격으로 반복되는 알람을 등록하며, 알람이 울리면 BroadcastReceiver인 MyAlarm 클래스가 로그를 출력합니다.

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")
        }
    }
}

참고: Android 12(API 31) 이상을 타깃으로 하는 경우, PendingIntent 생성 시 PendingIntent.FLAG_IMMUTABLE 또는 PendingIntent.FLAG_MUTABLE 플래그를 반드시 지정해야 앱이 정상 동작합니다. 예를 들어 PendingIntent.getBroadcast(this, 0, intent, PendingIntent.FLAG_IMMUTABLE)처럼 작성하면 됩니다.

4단계 — AndroidManifest.xml 설정

androidManifest.xml 파일에 다음 코드를 추가합니다.

<?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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭합니다. 실행 기기 목록에서 본인의 모바일 기기를 선택하면 해당 기기의 기본 화면에 결과가 표시됩니다.

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