개요
안드로이드 앱을 개발하다 보면 로그인 정보, 사용자 설정 등 간단한 데이터를 기기에 저장해야 하는 경우가 자주 발생합니다. 이럴 때 가장 손쉽게 활용할 수 있는 것이 바로 SharedPreferences(공유 환경설정)입니다. SharedPreferences는 키-값(Key-Value) 쌍 형태로 데이터를 XML 파일에 저장하며, 앱이 종료되어도 데이터가 유지됩니다.
이 글에서는 Kotlin을 사용하여 로그인 화면에서 입력한 이름과 비밀번호를 저장하고, '내 정보 기억하기' 체크박스를 통해 재실행 시 자동으로 불러오는 예제를 단계별로 살펴보겠습니다.
Step 1 — 새 프로젝트 생성
Android Studio를 실행하고 File → New Project 메뉴로 이동한 뒤, 빈 Activity 템플릿을 선택하여 새 프로젝트를 생성합니다. 언어는 Kotlin으로 지정하세요.
Step 2 — 레이아웃 작성 (activity_main.xml)
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 화면에는 타이틀 TextView, 이름과 비밀번호를 입력받는 두 개의 EditText, 로그인 Button, 그리고 인증 정보를 기억할 CheckBox가 배치됩니다.
<?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"
tools:context=".MainActivity">
<TextView
android:id="@+id/textView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true"
android:layout_marginTop="50dp"
android:text="Tutorials Point"
android:textAlignment="center"
android:textColor="@android:color/holo_green_dark"
android:textSize="32sp"
android:textStyle="bold" />
<EditText
android:id="@+id/etName"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@+id/textView"
android:layout_centerInParent="true"
android:layout_marginTop="75dp"
android:ems="10"
android:hint="Enter Name" />
<EditText
android:id="@+id/etPassword"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@id/etName"
android:layout_centerHorizontal="true"
android:ems="10"
android:hint="Enter Password" />
<Button
android:id="@+id/btnLogin"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@id/etPassword"
android:layout_alignStart="@id/etPassword"
android:layout_marginTop="10dp"
android:text="Login" />
<CheckBox
android:id="@+id/checkBox"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@id/btnLogin"
android:layout_alignStart="@id/btnLogin"
android:layout_marginTop="10dp"
android:text="Remember my credentials" />
</RelativeLayout>Step 3 — MainActivity.kt 구현
src/MainActivity.kt에 아래 코드를 작성합니다. 핵심 로직은 다음과 같습니다.
- PreferenceManager.getDefaultSharedPreferences()로 기본 SharedPreferences 인스턴스를 가져옵니다.
- 앱 실행 시 checkSharedPreference() 함수를 호출하여 저장된 값을 읽어와 EditText와 CheckBox에 반영합니다.
- 로그인 버튼 클릭 시 체크박스 상태에 따라 이름·비밀번호를 저장하거나 삭제합니다.
import android.content.SharedPreferences
import android.os.Bundle
import android.preference.PreferenceManager
import android.widget.Button
import android.widget.CheckBox
import android.widget.EditText
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
private lateinit var sharedPreferences: SharedPreferences
private lateinit var editor: SharedPreferences.Editor
private lateinit var name: EditText
private lateinit var password: EditText
private lateinit var button: Button
private lateinit var checkBox: CheckBox
private lateinit var strName: String
private lateinit var strPassword: String
private lateinit var strCheckBox: String
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
title = "KotlinApp"
name = findViewById(R.id.etName)
password = findViewById(R.id.etPassword)
button = findViewById(R.id.btnLogin)
checkBox = findViewById(R.id.checkBox)
sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this)
editor = sharedPreferences.edit()
checkSharedPreference()
button.setOnClickListener {
if (checkBox.isChecked) {
editor.putString(getString(R.string.checkBox), "True")
editor.apply()
strName = name.text.toString()
editor.putString(getString(R.string.name), strName)
editor.commit()
strPassword = password.text.toString()
editor.putString(getString(R.string.password), strPassword)
editor.commit()
} else {
editor.putString(getString(R.string.checkBox), "False")
editor.commit()
editor.putString(getString(R.string.name), "")
editor.commit()
editor.putString(getString(R.string.password), "")
editor.commit()
}
}
}
private fun checkSharedPreference() {
strCheckBox = sharedPreferences.getString(getString(R.string.checkBox), "False").toString()
strName = sharedPreferences.getString(getString(R.string.name), "").toString()
strPassword = sharedPreferences.getString(getString(R.string.password), "").toString()
name.setText(strName)
password.setText(strPassword)
checkBox.isChecked = strCheckBox == "True"
}
}참고: commit() vs apply()
SharedPreferences에 데이터를 저장할 때는 commit()과 apply() 두 가지 메서드를 사용할 수 있습니다. commit()은 동기적으로 처리되며 저장 성공 여부를 Boolean 값으로 반환하는 반면, apply()는 비동기적으로 디스크에 기록되므로 UI 스레드의 부하를 줄일 수 있습니다. 일반적인 상황에서는 apply() 사용이 권장됩니다.
Step 4 — AndroidManifest.xml 확인
androidManifest.xml은 아래와 같습니다. SharedPreferences를 사용하는 데 별도의 권한(permission) 선언은 필요하지 않습니다.
<?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 ▶ 아이콘을 클릭하여 앱을 실행합니다. 대상 기기 목록에서 연결된 모바일 기기를 선택하면 앱이 설치되고 기본 화면이 표시됩니다.
이름과 비밀번호를 입력한 뒤 체크박스를 선택하고 로그인 버튼을 눌러보세요. 이후 앱을 완전히 종료했다가 다시 실행하면, 입력했던 정보가 SharedPreferences에서 불러와져 자동으로 채워져 있는 것을 확인할 수 있습니다.