안드로이드에서 문자열 인코딩하는 방법 – Base64 예제로 쉽게 배우기

이 튜토리얼에서는 안드로이드(Android)에서 문자열을 인코딩하는 방법을 단계별로 알아봅니다. 가장 널리 사용되는 Base64 인코딩을 활용해, 사용자가 입력한 문자열을 인코딩한 뒤 화면에 표시하는 간단한 예제를 만들어 보겠습니다.

1단계: 새 프로젝트 생성

Android Studio를 실행하고 File ⇒ New Project로 이동한 뒤, 새 프로젝트 생성에 필요한 정보를 모두 입력하여 프로젝트를 만듭니다.

2단계: 레이아웃 구성 (activity_main.xml)

아래 코드는 입력창(EditText), 버튼(Button), 결과 표시 영역(TextView)으로 구성된 기본 레이아웃입니다.

<?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"
    android:gravity="center_horizontal"
    android:layout_marginTop="30dp"
    tools:context=".MainActivity">
    <EditText
        android:id="@+id/edit_query"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <Button
        android:id="@+id/buttonPanel"
        android:text="Check"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
    <TextView
        android:id="@+id/text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

사용자가 EditText에 값을 입력한 후 버튼을 클릭하면, 입력된 문자열이 인코딩되어 화면에 표시되는 구조입니다.

3단계: MainActivity.java 코드 추가

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

package com.example.myapplication;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Base64;
import android.view.View;
import android.widget.EditText;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {
    TextView text;
    EditText edit_query;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        edit_query = findViewById(R.id.edit_query);
        text = findViewById(R.id.text);
        findViewById(R.id.buttonPanel).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (!edit_query.getText().toString().isEmpty()) {
                    String encode = Base64.encodeToString(edit_query.getText().toString().getBytes(), Base64.DEFAULT);
                    text.setText(encode);
                }
            }
        });
    }
}

핵심 코드 설명

인코딩을 담당하는 핵심 부분은 다음 한 줄입니다.

Base64.encodeToString(edit_query.getText().toString().getBytes(), Base64.DEFAULT)

입력된 문자열을 먼저 getBytes()로 바이트 배열로 변환한 뒤, Base64.encodeToString() 메서드를 통해 Base64 형식의 문자열로 인코딩하고, 그 결과를 setText()로 TextView에 표시합니다. 또한 빈 값이 입력된 경우 오류가 발생하지 않도록 isEmpty() 조건문으로 입력값 유무를 검사하고 있습니다.

4단계: 앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 모바일 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭합니다. 실행 기기 목록에서 자신의 모바일 기기를 선택하면 앱이 설치되고 실행됩니다.

위 실행 결과에서 확인할 수 있듯이, EditText에 입력한 문자열이 Base64로 인코딩되어 TextView에 정상적으로 출력됩니다. 이처럼 android.util.Base64 클래스를 활용하면 별도의 외부 라이브러리 없이도 간단하게 문자열 인코딩을 처리할 수 있습니다.