안드로이드 프래그먼트에서 액티비티 메서드 호출하는 방법 완벽 가이드

프래그먼트에서 액티비티 메서드 호출하기

이 튜토리얼에서는 안드로이드 앱에서 프래그먼트(Fragment) 내부에서 액티비티(Activity)의 메서드를 호출하는 방법을 단계별로 알아봅니다. 프래그먼트는 단독으로 존재할 수 없고 항상 액티비티 위에서 동작하기 때문에, 두 컴포넌트 간의 통신은 안드로이드 개발에서 매우 자주 사용되는 패턴입니다.

핵심 원리는 간단합니다. getActivity() 메서드로 현재 프래그먼트가 속한 액티비티 인스턴스를 가져온 뒤, 이를 해당 액티비티 클래스로 캐스팅하여 public 메서드를 직접 호출하는 것입니다.

1단계: 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고, 새 프로젝트 생성에 필요한 모든 정보를 입력해 새 프로젝트를 만듭니다.

2단계: activity_main.xml 레이아웃 작성

다음 코드를 res/layout/activity_main.xml에 추가합니다. 프래그먼트를 담을 FrameLayout 컨테이너를 배치합니다.

<?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"
    android:padding="8dp"
    tools:context=".MainActivity">
    <FrameLayout
        android:id="@+id/frameLayout"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</RelativeLayout>

3단계: MainActivity.java 작성

다음 코드를 src/MainActivity.java에 추가합니다. 여기서 주목할 부분은 프래그먼트에서 호출될 FragmentMethod()가 public 접근 제어자로 선언되어 있다는 점입니다.

import androidx.appcompat.app.AppCompatActivity;
import androidx.fragment.app.FragmentManager;
import androidx.fragment.app.FragmentTransaction;
import android.os.Bundle;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        FragmentManager fragmentManager = getSupportFragmentManager();
        FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
        fragmentTransaction.replace(R.id.frameLayout, new SampleFragment()).commit();
    }
    public void FragmentMethod() {
        Toast.makeText(MainActivity.this, "Method called From Fragment", Toast.LENGTH_LONG).show();
    }
}

4단계: 프래그먼트 생성

새 프래그먼트 클래스와 레이아웃 파일을 만들고 다음 코드를 추가합니다.

SampleFragment.java

onCreateView() 안에서 ((MainActivity) getActivity()).FragmentMethod(); 구문으로 액티비티의 메서드를 호출합니다.

import android.os.Bundle;
import androidx.fragment.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
public class SampleFragment extends Fragment {
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_sample, container, false);
        ((MainActivity) getActivity()).FragmentMethod();
        return view;
    }
}

fragment_sample.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=".SampleFragment">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Calling a simple method from Fragment"
        android:textAlignment="center"
        android:textSize="24sp"
        android:textStyle="bold" />
</RelativeLayout>

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(실행) 아이콘을 클릭하세요. 옵션 목록에서 모바일 기기를 선택하면, 연결된 기본 화면에 아래와 같은 결과가 표시됩니다.

안드로이드 프래그먼트에서 액티비티 메서드 호출하는 방법 완벽 가이드

앱이 실행되면 프래그먼트가 생성되는 시점에 액티비티의 FragmentMethod()가 호출되어 "Method called From Fragment"라는 토스트 메시지가 화면에 나타나는 것을 확인할 수 있습니다.

추가 팁: 더 안전한 호출 방식

위 예제처럼 액티비티를 직접 캐스팅하는 방식은 간단하지만, 프래그먼트가 반드시 해당 액티비티에 종속된다는 한계가 있습니다. 더 유연하고 안전한 통신이 필요하다면 다음과 같은 방법도 고려해 보세요.

인터페이스 콜백: 프래그먼트에서 인터페이스를 정의하고 액티비티가 이를 구현하도록 하여 결합도를 낮출 수 있습니다.
ViewModel 공유: 액티비티 범위(scope)의 ViewModel을 통해 데이터와 이벤트를 공유하면 생명주기 문제도 함께 해결됩니다.
null 체크: getActivity()는 프래그먼트가 액티비티에서 분리(detach)된 경우 null을 반환할 수 있으므로, 호출 전 항상 null 여부를 확인하는 것이 좋습니다.