Kotlin으로 Android 앱에서 텍스트 복사·붙여넣기 기능 구현하기

이 글에서는 Kotlin을 사용해 Android 앱에서 클립보드 서비스를 통해 텍스트를 프로그래밍 방식으로 복사(PC의 Ctrl+C와 동일한 동작)하고, 다시 화면에 붙여넣는 방법을 단계별로 살펴봅니다.

핵심 개념: ClipboardManager와 ClipData

Android에서 클립보드 기능은 ClipboardManager 시스템 서비스를 통해 제공됩니다. 복사할 데이터는 ClipData 객체로 감싸서 setPrimaryClip() 메서드로 클립보드에 저장하고, 붙여넣을 때는 primaryClip에서 항목을 꺼내 사용합니다.

1단계 — 새 프로젝트 만들기

Android Studio에서 File → New Project를 선택한 뒤, 빈 Activity 템플릿으로 새 프로젝트를 생성합니다. 이때 언어는 반드시 Kotlin을 선택하세요.

2단계 — 레이아웃 작성 (res/layout/activity_main.xml)

텍스트 입력창(EditText), 복사 버튼, 붙여넣기 버튼, 결과를 표시할 TextView로 구성된 세로 방향 LinearLayout입니다.

<?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:gravity="center_horizontal"
    android:orientation="vertical"
    tools:context=".MainActivity">
<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="70dp"
    android:text="Tutorials Point"
    android:textAlignment="center"
    android:textColor="@android:color/holo_green_dark"
    android:textSize="32sp"
    android:textStyle="bold" />
<EditText
    android:id="@+id/editText"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_marginTop="100dp"
    android:hint="Enter your text" />
<Button
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="5dp"
    android:onClick="copyText"
    android:text="Copy text" />
<Button
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="5dp"
    android:onClick="pasteText"
    android:text="Paste text" />
<TextView
    android:textColor="@android:color/holo_red_dark"
    android:id="@+id/textView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="30dp"
    android:textSize="24sp"
    android:textStyle="bold" />
</LinearLayout>

3단계 — 메인 액티비티 코드 (src/MainActivity.kt)

copyText() 함수에서는 EditText의 내용이 비어 있는지 먼저 확인한 뒤, ClipData.newPlainText()로 클립 객체를 만들어 클립보드에 설정합니다. pasteText() 함수에서는 클립보드의 첫 번째 항목을 읽어 TextView에 표시합니다.

import android.content.ClipData
import android.content.ClipboardManager
import android.content.Context
import android.os.Bundle
import android.view.View
import android.widget.EditText
import android.widget.TextView
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    lateinit var editText: EditText
    lateinit var textView: TextView
    lateinit var clipboardManager: ClipboardManager
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        editText = findViewById(R.id.editText)
        textView = findViewById(R.id.textView)
    }
    fun copyText(view: View) {
        val text = editText.text.toString()
        if (text.isNotEmpty()) {
            clipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager
            val clipData = ClipData.newPlainText("key", text)
            clipboardManager.setPrimaryClip(clipData)
            Toast.makeText(applicationContext, "Copied", Toast.LENGTH_SHORT).show()
        } else {
            Toast.makeText(applicationContext, "No text to be copied", Toast.LENGTH_SHORT).show()
        }
    }
    fun pasteText(view: View) {
        val clipData: ClipData = clipboardManager.primaryClip!!
        val item: ClipData.Item = clipData.getItemAt(0)
        textView.text = item.text.toString()
        Toast.makeText(applicationContext, "Text is being Pasted", Toast.LENGTH_SHORT).show()
    }
}

4단계 — 매니페스트 파일 (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 기기를 컴퓨터에 연결한 상태에서 Android Studio 툴바의 Run 아이콘을 클릭해 앱을 실행합니다. 대상 기기를 선택하면 앱이 설치·실행되고, 텍스트를 입력한 뒤 Copy text 버튼을 누르면 해당 내용이 클립보드에 복사됩니다. 이후 Paste text 버튼을 누르면 복사된 내용이 화면 하단의 TextView에 표시되는 것을 확인할 수 있습니다.

추가 팁 및 주의 사항

• Android 10(API 29) 이상에서는 보안상의 이유로 백그라운드 상태의 앱이 클립보드에 접근하는 것이 제한됩니다.
• Android 13(API 33) 이상에서는 클립보드에 복사하면 시스템이 자동으로 미리보기 팝업을 표시하므로, 직접 Toast를 띄우지 않아도 됩니다.
• primaryClip은 클립보드가 비어 있으면 null을 반환할 수 있으므로, 실제 앱에서는 안전한 null 처리를 추가하는 것이 좋습니다.