Kotlin으로 안드로이드 기기의 현재 설정 언어 가져오는 방법

이 글에서는 Kotlin을 사용하여 안드로이드 기기에 현재 설정되어 있는 언어를 가져오는 방법을 단계별로 알아봅니다. 앱이 다국어를 지원하거나 사용자의 언어 설정에 따라 다른 동작을 해야 할 때 Locale 클래스를 활용하면 매우 간단하게 구현할 수 있습니다.

핵심 원리

안드로이드에서 시스템 언어 정보는 java.util.Locale 클래스를 통해 확인할 수 있습니다. 특히 Locale.getDefault().displayLanguage를 호출하면 기기에 설정된 기본 언어 이름(예: "한국어", "English")을 문자열로 반환받습니다.

구현 단계

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다. 이 예제에서는 Empty Activity 템플릿과 Kotlin 언어를 사용합니다.

2단계 — 레이아웃 파일 작성

res/layout/activity_main.xml에 아래 코드를 추가합니다. 화면 중앙에 현재 언어를 표시할 TextView 하나와 상단에 타이틀용 TextView 하나를 배치했습니다.

<?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:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="70dp"
        android:background="#008080"
        android:padding="5dp"
        android:text="TutorialsPoint"
        android:textColor="#fff"
        android:textSize="24sp"
        android:textStyle="bold" />

    <TextView
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:gravity="center_horizontal"
        android:textColor="@android:color/holo_blue_bright"
        android:textSize="24sp"
        android:textStyle="bold" />

</RelativeLayout>

3단계 — MainActivity.kt 작성

src/MainActivity.kt에 아래 코드를 추가합니다. onCreate() 메서드 안에서 Locale.getDefault().displayLanguage 값을 읽어와 TextView에 출력하는 것이 핵심입니다.

import android.os.Bundle
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
import java.util.*

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"

        val textView: TextView = findViewById(R.id.textView)
        textView.text = "현재 기기 언어: " + Locale.getDefault().displayLanguage
    }
}

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 버튼을 클릭하세요. 실행 옵션 목록에서 연결된 모바일 기기를 선택하면, 기기 화면에 현재 설정된 언어가 표시됩니다.

예를 들어 기기 언어가 한국어로 설정되어 있다면 "한국어", 영어라면 "English"가 화면에 나타납니다.

추가 팁

언어 이름뿐 아니라 더 세부적인 정보가 필요하다면 다음 속성들도 활용할 수 있습니다.

Locale.getDefault().language — ISO 언어 코드(예: "ko", "en")를 반환합니다.
Locale.getDefault().country — 국가/지역 코드(예: "KR", "US")를 반환합니다.
Locale.getDefault().displayName — 언어와 국가가 함께 포함된 전체 표시 이름을 반환합니다.

이처럼 Locale 클래스를 활용하면 별도의 권한 요청 없이 간단히 기기의 언어 설정을 확인할 수 있어, 다국어 지원 앱이나 지역별 맞춤 기능을 개발할 때 유용하게 사용할 수 있습니다.