Android에서 문자열을 Base64로 인코딩하고 디코딩하는 방법

Android에서 문자열 디코딩하기

이 튜토리얼에서는 Android 앱에서 Base64를 사용해 문자열을 인코딩하고 다시 디코딩하는 방법을 단계별로 알아봅니다. EditText에 입력한 값을 버튼 클릭 한 번으로 인코딩된 결과와 원본 문자열을 동시에 확인할 수 있는 간단한 예제입니다.

1단계: 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고 새 프로젝트를 생성합니다. 필요한 모든 세부 정보를 입력하여 빈 액티비티(Empty Activity) 템플릿으로 프로젝트를 만들어 주세요.

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

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"
    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" />

    <TextView
        android:id="@+id/text1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

</LinearLayout>

위 레이아웃은 하나의 EditText, 하나의 Button, 그리고 두 개의 TextView로 구성되어 있습니다. 사용자가 EditText에 값을 입력한 후 버튼을 클릭하면 해당 값이 인코딩되고, 이어서 디코딩되어 화면에 표시됩니다.

3단계: MainActivity 작성

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

package com.example.myapplication;

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

import java.nio.charset.StandardCharsets;

public class MainActivity extends AppCompatActivity {
    TextView text, text1;
    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);
        text1 = findViewById(R.id.text1);

        findViewById(R.id.buttonPanel).setOnClickListener(new View.OnClickListener() {
            @RequiresApi(api = Build.VERSION_CODES.KITKAT)
            @Override
            public void onClick(View v) {
                if (!edit_query.getText().toString().isEmpty()) {
                    // 1. 입력값을 Base64로 인코딩
                    String encode = Base64.encodeToString(
                            edit_query.getText().toString().getBytes(),
                            Base64.DEFAULT);
                    text.setText(encode);

                    // 2. 인코딩된 문자열을 다시 디코딩
                    byte[] data = Base64.decode(encode, Base64.DEFAULT);
                    String decoded = new String(data, StandardCharsets.UTF_8);
                    text1.setText(decoded);
                }
            }
        });
    }
}

코드의 핵심 로직은 다음과 같습니다.

인코딩: Base64.encodeToString() 메서드를 사용해 EditText에 입력된 문자열을 Base64 형식으로 변환합니다.
디코딩: Base64.decode() 메서드로 인코딩된 데이터를 바이트 배열로 되돌린 뒤, StandardCharsets.UTF_8을 지정해 원래의 문자열로 복원합니다.
첫 번째 TextView에는 인코딩 결과가, 두 번째 TextView에는 디코딩된 원본 문자열이 표시됩니다.

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

실제 Android 기기를 컴퓨터에 연결한 상태에서 앱을 실행해 보겠습니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하고, 목록에서 본인의 모바일 기기를 선택하세요. 기기에서 앱이 실행되면 기본 화면이 나타납니다.

Android에서 문자열을 Base64로 인코딩하고 디코딩하는 방법

EditText에 임의의 문자열을 입력하고 Check 버튼을 누르면, 위 결과 화면처럼 첫 번째 줄에는 Base64로 인코딩된 문자열이, 두 번째 줄에는 디코딩을 통해 복원된 원본 문자열이 출력되는 것을 확인할 수 있습니다.

마무리

이처럼 Android에서는 android.util.Base64 클래스를 활용하면 별도의 외부 라이브러리 없이 간단하게 문자열 인코딩과 디코딩을 처리할 수 있습니다. 서버와 통신할 때 데이터를 안전하게 전달하거나, 간단한 문자열 변환이 필요한 경우 유용하게 사용할 수 있습니다.