안드로이드에서 프로그래밍 방식으로 RelativeLayout 뷰 배치하기: 단계별 완벽 가이드

이 튜토리얼에서는 안드로이드에서 RelativeLayout의 뷰(View)를 프로그래밍 방식, 즉 자바 코드로 직접 배치하는 방법을 단계별로 살펴봅니다. XML 레이아웃을 수정하지 않고도 런타임에 버튼을 동적으로 생성하고 부모 레이아웃의 정중앙에 배치하는 예제입니다.

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project 메뉴로 이동한 후, 새 프로젝트 생성에 필요한 모든 정보(프로젝트 이름, 패키지 이름, 저장 위치 등)를 입력하여 새 프로젝트를 만듭니다.

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

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 핵심은 최상위 레이아웃을 RelativeLayout으로 지정하고, 자바 코드에서 참조할 수 있도록 android:id="@+id/relativelayoutID"처럼 ID를 부여하는 것입니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/relativelayoutID"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!" />

</RelativeLayout>

3단계 — MainActivity.java 코드 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다. 이 부분이 예제의 핵심으로, 코드만으로 버튼을 생성하고 RelativeLayout의 중앙에 배치합니다.

package com.app.sample;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.RelativeLayout;
import android.widget.RelativeLayout.LayoutParams;
import android.widget.Toast;

public class MainActivity extends Activity {

    RelativeLayout relativelayout;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 버튼을 코드로 동적 생성
        Button DynamicButton = new Button(MainActivity.this);
        relativelayout = (RelativeLayout) findViewById(R.id.relativelayoutID);

        // 레이아웃 파라미터 생성 후 중앙 정렬 규칙 추가
        LayoutParams layoutparams = new RelativeLayout.LayoutParams(
                LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
        layoutparams.addRule(RelativeLayout.CENTER_IN_PARENT);

        DynamicButton.setLayoutParams(layoutparams);
        DynamicButton.setText("Dynamic Button");
        relativelayout.addView(DynamicButton);

        // 클릭 이벤트 처리
        DynamicButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Toast.makeText(MainActivity.this,
                        "Clicked on Dynamic button", Toast.LENGTH_LONG).show();
            }
        });
    }
}

핵심 코드 설명

• new Button(MainActivity.this) — XML에 선언하지 않고 자바 코드만으로 버튼 객체를 생성합니다.
• RelativeLayout.LayoutParams — RelativeLayout 전용 레이아웃 파라미터 클래스로, 뷰의 크기와 위치 규칙을 함께 지정합니다.
• addRule(RelativeLayout.CENTER_IN_PARENT) — 뷰를 부모 레이아웃의 수직·수평 중앙에 배치하는 규칙을 추가합니다. 이 외에도 ALIGN_PARENT_RIGHT, BELOW, RIGHT_OF 등 다양한 규칙을 활용할 수 있습니다.
• addView() — 생성된 버튼을 RelativeLayout에 추가하여 실제 화면에 표시합니다.

4단계 — AndroidManifest.xml 작성

Manifests/AndroidManifest.xml 파일에 아래 코드를 추가합니다. MainActivity가 앱의 진입 액티비티로 올바르게 등록되어 있는지 확인하세요.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.app.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" />
            </intent-filter>
        </activity>

    </application>
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run(실행) 아이콘을 클릭하세요. 옵션 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 아래와 같이 버튼이 화면 한가운데 배치된 기본 화면이 나타납니다.

버튼을 탭하면 'Clicked on Dynamic button'이라는 토스트 메시지가 표시되며, 코드로 생성한 뷰의 클릭 이벤트까지 정상적으로 동작하는 것을 확인할 수 있습니다.