이 튜토리얼에서는 안드로이드 앱에서 프로그래밍 방식(코드)으로 앱 언어를 변경하는 방법을 단계별로 알아봅니다. 사용자의 기기 설정과 무관하게 앱 내부에서 직접 언어를 전환해야 하는 다국어 앱을 개발할 때 유용하게 활용할 수 있습니다.
1단계: 새 프로젝트 만들기
Android Studio를 열고 File → New Project 메뉴로 이동한 뒤, 새 프로젝트 생성에 필요한 모든 정보를 입력하여 프로젝트를 만듭니다.
2단계: 레이아웃 파일 작성
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.
<?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:text="@string/hello_world" android:textSize="30dp" android:textStyle="bold" android:textColor="@color/colorPrimary" android:layout_centerInParent="true"/> </RelativeLayout>
3단계: MainActivity에 언어 변경 로직 구현
src/MainActivity.java 파일에 아래 코드를 추가합니다. 핵심은 setAppLocale() 메서드로, 원하는 언어 코드를 받아 리소스 설정(Configuration)에 적용하는 역할을 합니다.
import android.content.res.Configuration;
import android.content.res.Resources;
import android.os.Build;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.DisplayMetrics;
import java.util.Locale;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setAppLocale("bg");
setContentView(R.layout.activity_main);
}
private void setAppLocale(String localeCode){
Resources resources = getResources();
DisplayMetrics dm = resources.getDisplayMetrics();
Configuration config = resources.getConfiguration();
if (Build.VERSION.SDK_INT>=Build.VERSION_CODES.JELLY_BEAN_MR1){
config.setLocale(new Locale(localeCode.toLowerCase()));
} else {
config.locale = new Locale(localeCode.toLowerCase());
}
resources.updateConfiguration(config, dm);
}
}위 코드에서는 API 17(JELLY_BEAN_MR1) 이상에서는 setLocale() 메서드를 사용하고, 그 이하 버전에서는 config.locale 필드에 직접 값을 할당하도록 분기 처리했습니다.
4단계: 불가리아어 strings.xml 리소스 추가
res 폴더 우클릭 → New → File을 선택하고, 파일 이름을 values-bg/strings.xml로 지정한 후 아래 코드를 입력합니다.
<resources> <string name="app_name">Sample</string> <string name="hello_world">дравей свят</string> </resources>
여기서 bg는 불가리아어(Bulgarian)의 ISO 언어 코드입니다. 다른 언어를 지원하려면 해당 언어 코드에 맞는 values 폴더(예: values-ko, values-en)를 추가로 만들면 됩니다.
5단계: 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>
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 상단 툴바의 Run(실행) 아이콘을 클릭하세요. 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 불가리아어로 변경된 인사말이 표시되는 것을 확인할 수 있습니다.
추가 팁: Android 13 이상에서의 권장 방식
Android 13(API 33)부터는 시스템 차원의 앱별 언어 설정(Per-app language preferences) API가 도입되었습니다. 최신 버전을 지원한다면 LocaleManager.setApplicationLocales()를 활용하거나, AppCompat 라이브러리의 AppCompatDelegate.setApplicationLocales()를 사용하는 것이 더 권장됩니다. 다만 위에서 소개한 Configuration 방식은 하위 버전 호환성이 필요한 경우 여전히 널리 쓰이고 있습니다.