안드로이드 앱에서 캘린더 일정을 추가하는 방법 (코드 예제 포함)

이 튜토리얼에서는 안드로이드 앱에서 캘린더에 일정을 추가하는 방법을 단계별로 알아봅니다. Intent와 Calendar 클래스를 활용하면 별도의 권한 처리 없이도 기기의 기본 캘린더 앱을 호출해 일정을 손쉽게 등록할 수 있습니다.

1단계: 새 프로젝트 생성

Android Studio를 실행한 뒤 File → New Project 메뉴로 이동하여 새 프로젝트를 생성합니다. 프로젝트 생성에 필요한 모든 세부 정보를 입력하고 빈 액티비티(Empty Activity) 템플릿을 선택합니다.

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

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 버튼을 클릭하면 AddCalendarEvent 메서드가 호출되도록 android:onClick 속성을 설정했습니다.

<?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">
    <Button
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:onClick="AddCalendarEvent"
       android:text="Add Calendar Event" />
    <TextView
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_centerInParent="true"
       android:text="Calendar Event In Android"
       android:textSize="18sp"
       android:textStyle="bold" />
</RelativeLayout>

3단계: MainActivity.java 코드 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다. Intent.ACTION_EDIT과 MIME 타입 vnd.android.cursor.item/event를 사용해 캘린더 일정 편집 화면을 호출하며, 시작 시간, 종료 시간, 반복 규칙, 제목 등을 putExtra()로 전달합니다.

import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import java.util.Calendar;
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);
    }
    public void AddCalendarEvent(View view) {
       Calendar calendarEvent = Calendar.getInstance();
       Intent i = new Intent(Intent.ACTION_EDIT);
       i.setType("vnd.android.cursor.item/event");
       i.putExtra("beginTime", calendarEvent.getTimeInMillis());
       i.putExtra("allDay", true);
       i.putExtra("rule", "FREQ=YEARLY");
       i.putExtra("endTime", calendarEvent.getTimeInMillis() + 60 * 60 * 1000);
       i.putExtra("title", "Calendar Event");
       startActivity(i);
    }
}

위 코드에서 각 putExtra()의 역할은 다음과 같습니다.

beginTime: 일정 시작 시간 (밀리초 단위 타임스탬프)
allDay: 종일 일정 여부 설정
rule: 반복 규칙 지정 (예: FREQ=YEARLY는 매년 반복)
endTime: 일정 종료 시간 (시작 시간 + 1시간)
title: 캘린더에 표시될 일정 제목

4단계: AndroidManifest.xml 설정

androidManifest.xml 파일에 아래 코드를 추가합니다. 이 예제는 외부 캘린더 앱의 UI를 호출하는 방식이므로 별도의 런타임 권한 선언이 필요하지 않습니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">
    <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 아이콘을 클릭합니다. 실행 기기 목록에서 연결된 모바일 기기를 선택하면, 기기에 아래와 같은 기본 화면이 표시됩니다.

안드로이드 앱에서 캘린더 일정을 추가하는 방법 (코드 예제 포함)

화면의 Add Calendar Event 버튼을 누르면 기기의 기본 캘린더 앱이 실행되면서 지정한 제목과 반복 규칙이 적용된 일정 등록 화면이 열립니다. 사용자는 여기서 내용을 확인하거나 수정한 뒤 저장하면 됩니다.

안드로이드 앱에서 캘린더 일정을 추가하는 방법 (코드 예제 포함)

마무리

이처럼 Intent를 활용하면 캘린더 권한을 직접 요청하지 않고도 기본 캘린더 앱에 일정을 추가할 수 있습니다. 만약 캘린더 데이터에 직접 읽기·쓰기 작업을 수행해야 한다면 READ_CALENDAR, WRITE_CALENDAR 권한과 CalendarContract API를 사용하는 방식을 추가로 학습해 보시기 바랍니다.