예제를 시작하기에 앞서, 안드로이드에서 ViewPager가 무엇인지 먼저 알아보겠습니다. ViewPager는 안드로이드 서포트 라이브러리(Support Library)에서 제공하는 위젯으로, 이를 활용하면 여러 프래그먼트(Fragment) 사이를 좌우로 스와이프하며 자연스럽게 전환할 수 있습니다. 대표적으로 앱 첫 실행 시 나타나는 온보딩 화면이나 이미지 갤러리 등이 ViewPager로 구현됩니다.
이번 예제는 TabLayout과 연동된 안드로이드 ViewPager를 구현하는 방법을 단계별로 보여줍니다.
1단계: 새 프로젝트 생성
안드로이드 스튜디오(Android Studio)를 열고 File → New Project로 이동한 뒤, 새 프로젝트 생성에 필요한 모든 항목을 입력하여 프로젝트를 만듭니다.
2단계: build.gradle 설정 추가
아래 코드를 build.gradle 파일에 추가합니다.
apply plugin: 'com.android.application'
android {
compileSdkVersion 28
defaultConfig {
applicationId "com.example.andy.myapplication"
minSdkVersion 19
targetSdkVersion 28
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support:design:28.0.0'
implementation 'com.android.support.constraint:constraint-layout:1.1.3'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'com.android.support.test:runner:1.0.2'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}
참고: ViewPager와 TabLayout을 함께 사용하기 위해 서포트 라이브러리의 design 모듈 의존성이 반드시 포함되어 있어야 합니다.
3단계: activity_main.xml 레이아웃 작성
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 이 레이아웃은 상단에 툴바(Toolbar)와 탭(TabLayout)을 배치하고, 그 아래에 ViewPager를 위치시키는 구조입니다.
<?xml version = "1.0" encoding = "utf-8"?>
<android.support.design.widget.CoordinatorLayout
xmlns:android = "https://schemas.android.com/apk/res/android"
xmlns:app = "https://schemas.android.com/apk/res-auto"
android:layout_width = "match_parent"
android:layout_height = "match_parent">
<android.support.design.widget.AppBarLayout
android:layout_width = "match_parent"
android:layout_height = "wrap_content"
android:theme = "@style/ThemeOverlay.AppCompat.Dark.ActionBar">
<android.support.v7.widget.Toolbar
android:id = "@+id/toolbar"
android:layout_width = "match_parent"
android:layout_height = "?attr/actionBarSize"
android:background = "?attr/colorPrimary"
app:layout_scrollFlags = "scroll|enterAlways"
app:popupTheme = "@style/ThemeOverlay.AppCompat.Light" />
<android.support.design.widget.TabLayout
android:id = "@+id/tabs"
android:layout_width = "match_parent"
android:layout_height = "wrap_content"
app:tabMode = "fixed"
app:tabGravity = "fill"/>
</android.support.design.widget.AppBarLayout>
<android.support.v4.view.ViewPager
android:id = "@+id/viewpager"
android:layout_width = "match_parent"
android:layout_height = "match_parent"
app:layout_behavior = "@string/appbar_scrolling_view_behavior" />
</android.support.design.widget.CoordinatorLayout>
4단계: MainActivity.java 구현
src/MainActivity.java 파일에 다음 코드를 추가합니다. 여기서는 프래그먼트 목록과 제목 목록을 관리하는 커스텀 어댑터(ViewPagerAdapter)를 정의하고, 두 개의 프래그먼트를 ViewPager에 연결합니다.
package com.example.andy.myapplication;
import android.annotation.TargetApi;
import android.os.Build;
import android.os.Bundle;
import android.support.design.widget.TabLayout;
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentManager;
import android.support.v4.app.FragmentPagerAdapter;
import android.support.v4.view.ViewPager;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import java.util.ArrayList;
import java.util.List;
public class MainActivity extends AppCompatActivity {
private ViewPager viewPager;
private Toolbar toolbar;
private TabLayout tabLayout;
@TargetApi(Build.VERSION_CODES.O)
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
toolbar = (Toolbar) findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
getSupportActionBar().setDisplayHomeAsUpEnabled(true);
tabLayout = findViewById(R.id.tabs);
viewPager = findViewById(R.id.viewpager);
ViewPagerAdapter adapter = new ViewPagerAdapter(getSupportFragmentManager());
adapter.addFragment(new OneFragment(), "ONE");
adapter.addFragment(new TwoFragment(), "TWO");
viewPager.setAdapter(adapter);
tabLayout.setupWithViewPager(viewPager);
}
class ViewPagerAdapter extends FragmentPagerAdapter {
private final List<Fragment> mList = new ArrayList<>();
private final List<String> mTitleList = new ArrayList<>();
public ViewPagerAdapter(FragmentManager supportFragmentManager) {
super(supportFragmentManager);
}
@Override
public Fragment getItem(int i) {
return mList.get(i);
}
@Override
public int getCount() {
return mList.size();
}
public void addFragment(Fragment fragment, String title) {
mList.add(fragment);
mTitleList.add(title);
}
@Override
public CharSequence getPageTitle(int position) {
return mTitleList.get(position);
}
}
}
핵심 포인트는 tabLayout.setupWithViewPager(viewPager) 호출입니다. 이 한 줄의 코드 덕분에 탭을 선택하면 해당 페이지로 전환되고, 반대로 페이지를 스와이프하면 탭도 함께 움직이는 양방향 동기화가 자동으로 처리됩니다.
5단계: OneFragment.java 작성
첫 번째 탭에 표시될 프래그먼트입니다. src/OneFragment.java에 아래 코드를 추가합니다.
package com.example.andy.myapplication;
import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
public class OneFragment extends Fragment {
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState){
View v= inflater.inflate(R.layout.fragment_one, container, false);
TextView textView=v.findViewById(R.id.text);
textView.setText("First Fragment");
return v;
}
}
6단계: TwoFragment.java 작성
두 번째 탭에 표시될 프래그먼트입니다. src/TwoFragment.java에 아래 코드를 추가합니다.
package com.example.andy.myapplication;
import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
public class TwoFragment extends Fragment {
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState){
View v= inflater.inflate(R.layout.fragment_one, container, false);
TextView textView=v.findViewById(R.id.text);
textView.setText("Second Fragment");
return v;
}
}
7단계: fragment_one.xml 레이아웃 작성
프래그먼트에서 사용할 공통 레이아웃입니다. res/layout/fragment_one.xml 파일에 아래 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="https://schemas.android.com/apk/res/android" android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/text"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:gravity="center"
android:textSize="20sp"
/>
</LinearLayout>
8단계: styles.xml 테마 설정
액션바를 직접 제어하기 위해 테마에서 기본 액션바를 비활성화합니다. styles.xml 파일에 아래 코드를 추가합니다.
<resources>
<!-- Base application theme. -->
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<!-- Customize your theme here. -->
<item name = "windowNoTitle">true</item>
<item name = "windowActionBar">false</item>
<item name="colorPrimary">@color/colorPrimary</item>
<item name="colorPrimaryDark">@color/colorPrimaryDark</item>
<item name="colorAccent">@color/colorAccent</item>
</style>
</resources>
실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. 안드로이드 스튜디오에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 상단 툴바의 Run 버튼을 클릭하세요. 실행할 기기를 선택하면 모바일 기기에 아래와 같은 기본 화면이 나타납니다.
실행 결과, 상단의 ONE, TWO 두 개의 탭이 표시되고, 각 탭을 누르거나 화면을 좌우로 스와이프하면 해당 프래그먼트로 부드럽게 전환되는 것을 확인할 수 있습니다.
추가 팁: 최신 환경에서의 ViewPager
위 예제는 구버전 서포트 라이브러리(support library)를 기준으로 작성되었습니다. 최신 프로젝트라면 AndroidX 마이그레이션 후 ViewPager2와 TabLayoutMediator 사용을 권장합니다. ViewPager2는 RecyclerView 기반으로 재작성되어 세로 방향 스크롤, RTL(오른쪽에서 왼쪽) 레이아웃 지원, 더 나은 성능과 같은 장점을 제공합니다.