Computer >> 컴퓨터 >  >> 프로그래밍 >> Android

안드로이드 앱을 처음 열 때 액티비티를 한 번만 실행하는 방법

이 튜토리얼에서는 안드로이드 앱을 처음 실행했을 때만 특정 액티비티가 화면에 나타나도록 만드는 방법을 단계별로 살펴봅니다. 온보딩 화면, 환영 메시지, 초기 안내 페이지처럼 사용자에게 딱 한 번만 보여주고 싶은 화면이 있다면 SharedPreferences를 이용해 아주 간단하게 구현할 수 있습니다.

동작 원리

핵심 아이디어는 생각보다 단순합니다. 앱이 처음 실행되었는지 여부를 SharedPreferences에 불리언(Boolean) 값으로 저장해 두고, 액티비티가 시작될 때마다 이 값을 확인하는 것입니다.

  • 첫 실행: 저장된 값이 없으므로 액티비티를 정상적으로 표시하고, prevStarted 값을 true로 기록합니다.
  • 두 번째 실행부터: 값이 이미 true이므로 finish()를 호출해 액티비티를 즉시 종료합니다.

구현 단계

1단계 — 새 프로젝트 만들기

안드로이드 스튜디오에서 File → New Project 메뉴로 이동한 뒤, 새 프로젝트 생성에 필요한 정보를 모두 입력해 프로젝트를 만듭니다.

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

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical"
    tools:context=".MainActivity">
    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:text="저는 한 번만 실행됩니다" />
</LinearLayout>

3단계 — 메인 액티비티 작성 (MainActivity.java)

src/MainActivity.java 파일에 아래 코드를 추가합니다.

package app.com.sample;
import androidx.appcompat.app.AppCompatActivity;
import android.content.Context;
import android.content.SharedPreferences;
import android.os.Bundle;
public class MainActivity extends AppCompatActivity {
    String prevStarted = "prevStarted";
    @Override
    protected void onResume() {
        super.onResume();
        SharedPreferences sharedpreferences = getSharedPreferences(getString(R.string.app_name), Context.MODE_PRIVATE);
        if (!sharedpreferences.getBoolean(prevStarted, false)) {
            SharedPreferences.Editor editor = sharedpreferences.edit();
            editor.putBoolean(prevStarted, Boolean.TRUE);
            editor.apply();
        } else {
            finish();
        }
    }
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

코드 설명: onResume()에서 앱 이름을 파일명으로 사용하는 SharedPreferences 객체를 불러온 뒤, prevStarted 키에 저장된 값을 확인합니다. 최초 실행 시에는 이 값이 false이므로 true로 변경해 저장하고 화면을 그대로 보여주며, 그 이후 실행부터는 finish()가 호출되어 액티비티가 곧바로 닫힙니다.

4단계 — 매니페스트 설정 (AndroidManifest.xml)

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

<?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>

실행 결과 확인하기

이제 앱을 직접 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. 안드로이드 스튜디오에서 프로젝트의 액티비티 파일 중 하나를 연 후 툴바의 Run(실행) 아이콘을 클릭하고, 기기 목록에서 본인의 모바일 기기를 선택하세요. 그러면 기기 화면에 아래와 같은 기본 화면이 나타납니다.

안드로이드 앱을 처음 열 때 액티비티를 한 번만 실행하는 방법

마무리 및 참고 사항

이 방식은 별도의 데이터베이스 없이 몇 줄의 코드만으로 '첫 실행 여부'를 판별할 수 있어 온보딩 화면이나 공지 팝업 등에 널리 활용됩니다. 다만 최신 안드로이드 개발 가이드에서는 코루틴과 Flow를 지원하는 Jetpack DataStore 사용을 권장하고 있으니, 규모가 큰 프로젝트라면 이를 참고하는 것이 좋습니다. 또한 앱 데이터를 삭제하거나 앱을 재설치하면 SharedPreferences가 초기화되어 액티비티가 다시 한 번 표시된다는 점도 기억해 두세요.