어제, 오늘 그리고 내일

이번 포스팅은 Fragment를 좀 더 유연하게 구축하는 방법에 대하여 알아보도록 하겠습니다.

다양한 화면 크기를 지원하도록 애플리케이션을 설계할 때 다양한 레이아웃 구성에서 Fragment를 다시 사용하여 사용 가능한 화면 공간을 기준으로 사용자 환경을 최적화할 수 있습니다.

예를 들어 핸드셋 기기인 경우 단일 창 사용자 인터페이스에 Fragment를 한 번에 하나씩만 표시하는 것이 적합할 수 있습니다. 반대로, 화면 너비가 큰 태블릿에서는 Fragment를 나란히 설정하여 사용자에게 더 많은 정보를 표시할 수 있습니다.

이 FragmentManager 클래스는 동적 경험(dynamic experience)을 만들기 위해 런타임시 Activity에 Fragment를 추가, 제거 및 대체 할 수있는 메소드를 제공합니다.

Fragment 구현에 관한 자세한 정보는 다음 리소스를 참조하세요.

• Fragment
• 태블릿 및 핸드셋 지원
• 샘플 앱

Runtime 시 Activity에 Fragment 추가

<fragment> 요소를 사용하는 이전 과정의 내용대로 레이아웃 파일의 Activity에 대한 Fragment를  정의하는 대신 Activity Runtime 중 Activity에 Fragment를 추가할 수 있습니다. Activity 사용 기간 중 Fragment를 변경하려는 경우에는 이 과정이 필요합니다.

프래그먼트 추가 또는 삭제와 같은 트랜잭션을 수행하려면 FragmentManager를 사용하여 기타 Fragment 트랜잭션을 추가, 삭제, 교체, 수행하기 위한 API를 제공하는 FragmentTransaction를 만들어야 합니다.

Activity에서 Fragment를 삭제하거나 교체할 수 있는 경우 Activity의 onCreate() 메서드 중에 Activity의 초기 Fragment를 추가해야 합니다.

Fragment 작업 시, 특히 런타임에 Fragment를 추가할 때 유념해야 할 중요한 규칙은 Fragment를 삽입할 수 있는 컨테이너 View를 Activity 레이아웃에 포함해야 하는 것입니다.

이전 과정에 나와 있는 대로 Fragment를 한 번에 하나씩만 표시하는 레이아웃 대신 다음 레이아웃을 사용할 수 있습니다. 한 Fragment 를 다른 Fragment 로 교체할 수 있도록 Activity 레이아웃에는 Fragment  컨테이너 역할을 하는 빈 FrameLayout이 포함되어 있습니다.

파일 이름은 이전 과정의 레이아웃 파일과 동일하지만, 레이아웃 디렉터리에 large 한정자가 없기 때문에, 이 레이아웃은 기기 화면이 대형보다 작아 두 Fragment 를 동시에 표시할 수 없는 경우에 사용됩니다.

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/fragment_container"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

Reference

1. https://developer.android.com/training/basics/fragments/fragment-ui

이번 포스팅은 App Fragment Test 에 대하여 알아보도록 하겠습니다.

Fragment는 앱 내에서 재사용 가능한 컨테이너 역할을 하며, 다양한 Activity와 레이아웃 구성에서 동일한 사용자 인터페이스 레이아웃을 표시할 수 있습니다. Fragment는 다양한 용도로 사용되기 때문에 일관적이고 효율적으로 리소스를 사용하는 환경을 제공하는지 검증하는 것이 중요합니다.

▶ Fragment의 외형은 대형 스크린 화면이나 기기에서 가로 모드를 지원하는 Fragment를 포함하여 모든 레이아웃 구성에서 일관적이어야 합니다.

▶ Fragment가 사용자에게 보일 경우에만 Fragment의 뷰 계층 구조를 생성하세요.

Fragment의 상태 변경

이 테스트를 쉽게 설정할 수 있도록 AndroidX는 Fragment를 생성하고 상태를 변경하기 위한 FragmentScenario 라이브러리를 제공합니다.

Test artifact 위치 구성

FragmentScenario를 의도한 대로 사용하려면 다음 소스 코드와 같이 앱의 테스트 APK에서 Fragment test artifact를 app/build.gradle 안에 정의합니다.

dependencies {
    // ...
    debugImplementation 'androidx.fragment:fragment-testing:{{ fragment_version }}'
}

Fragment 만들기

FragmentScenario에는 다음 유형의 Fragment를 실행하기 위한 메서드가 포함됩니다.

▶사용자 인터페이스 포함하는 그래픽 Fragment 입니다. 이 유형의 Fragment를 실행하려면 launchFragmentInContainer()를 호출합니다. FragmentScenario는 Fragment를 Activity의 루트 뷰 컨트롤러에 연결합니다. 그 외의 경우에는 Activity가 포함된 이 작업은 비어 있습니다.

▶ 여러 Activity에 포함된 정보를 단기적으로 실행하거나 저장하는 비 그래픽 Fragment 입니다. 이 유형의 Fragment를 실행하려면 launchFragment()를 호출합니다. FragmentScenario는 이 유형의 조각을 루트 보기가 없는 완전히 빈 활동에 연결합니다.

이런 Fragment 유형 중 하나를 실행한 이후 FragmentScenario는 테스트 중인 Fragment를 RESUMED 상태로 변경합니다. 이 상태는 Fragment가 실행 중이라는 것을 나타냅니다. 그래픽 Fragment를 테스트할 때 사용자에게도 테스트가 보이므로 Espresso UI 테스트를 사용하여 UI 요소에 대한 정보를 평가할 수 있습니다.

다음 소스 코드는 각 유형의 Fragment를 실행하는 방법을 보여줍니다.

<그래픽 Fragment 예시>

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        // The "state" and "factory" arguments are optional.
        val fragmentArgs = Bundle().apply {
            putInt("selectedListItem", 0)
        }
        val factory = MyFragmentFactory()
        val scenario = launchFragmentInContainer<MyFragment>(
                fragmentArgs, factory)
        onView(withId(R.id.text)).check(matches(withText("Hello World!")))
    }
}

<비 그래픽 Fragment의 예시>

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        // The "state" and "factory" arguments are optional.
        val fragmentArgs = Bundle().apply {
            putInt("numElements", 0)
        }
        val factory = MyFragmentFactory()
        val scenario = launchFragment<MyFragment>(fragmentArgs, factory)
    }
}

Fragment 다시 생성

기기에 리소스가 부족할 경우 시스템이 Fragment가 포함된 Activity를 소멸할 수 있으며, 이때 사용자가 앱에 돌아왔을 때 앱이 해당 Fragment를 다시 생성해야 합니다. 이 상황을 시뮬레이션하려면 recreate()를 호출하세요.

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<MyFragment>()
        scenario.recreate()
    }
}

FragmentScenario 클래스가 테스트 중인 Fragment를 다시 생성하면 Fragment는 다시 생성하기 이전의 수명 주기 상태로 돌아옵니다.

Fragment를 새로운 상태로 변경

앱 UI 테스트에서는 대개 테스트 중인 Fragment를 실행하고 다시 생성하는 것만으로 충분합니다. 그러나 세밀한 유닛 테스트에서는 Fragment가 하나의 수명 주기에서 다른 수명 주기로 넘어갈 때 Fragment의 동작을 평가할 수 있습니다.

Fragment를 다른 수명 주기 상태로 변경하려면 moveToState()를 호출하세요. 이 메서드는 CREATED, STARTED, RESUMED, DESTROYED의 상태를 인수로 지원합니다. 이 작업은 Fragment가 포함된 Activity가 다른 앱이나 시스템 작업에 중단되어 상태를 변경하는 상황을 시뮬레이션합니다.

★ 참고: Fragment를 DESTROYED 상태로 전환할 경우 해당 Fragment를 다른 상태로 변경할 수 없고 Fragment를 다른 Activity에 연결할 수도 없습니다.

moveToState()의 사용 예시가 다음 소스 코드에서 나타납니다.

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<MyFragment>()
        scenario.moveToState(State.CREATED)
    }
}

★ 주의: 테스트 중인 Fragment를 현재의 상태로 전환하려고 할 경우 FragmentScenario는 이 요청을 예외가 아니라 ‑작업 불능으로 취급합니다. 특히, 이 API를 사용하면 Fragment를 DESTROYED 상태로 연속해서 여러 번 전환할 수 있습니다.

Fragment에서 작업 자르기

테스트 중인 Fragment에서 작업을 트리거하려면 Espresso 뷰 매처를 사용하여 뷰에서 요소와 상호작용하세요.

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<MyFragment>()
        onView(withId(R.id.refresh))
                .perform(click())
    }
}

Fragment 자체에서 메서드를 호출해야 할 경우 (예: 옵션 메뉴에서의 선택에 응답) FragmentAction을 구현하면 안전하게 호출할 수 있습니다.

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<MyFragment>()
        scenario.onFragment(fragment ->
            fragment.onOptionsItemSelected(clickedItem) {
                // Update fragment's state based on selected item.
            }
        }
    }
}

★ 참고: 테스트 클래스에서는 onFragment()로 전달한 객체에 대한 참조를 그대로 두지 마세요. 이 참조는 시스템 리소스를 사용하고, 프레임워크가 콜백 메서드로 전달된 Fragment를 다시 생성했기 때문에 참조 자체가 최신이 아닐 수 있습니다.

Reference

1. https://developer.android.com/training/basics/fragments/testing

이번 포스팅은 Fragment 생성하는 방법에 대하여 알아보도록 하겠습니다.

Fragment의 생성

Fragment를 생성하려면 Fragment 클래스를 extend 한 후 Activity 클래스에서와 마찬가지로 주요 수명 주기 메서드를 재정의하여 자체 앱 로직을 적용합니다.

Fragment 생성 시 한 가지 차이점은 레이아웃 정의에 onCreateView() 콜백을 사용해야 한다는 점입니다. 사실 Fragment 실행에 필요한 콜백은 이것뿐입니다. 다음은 자체 레이아웃을 지정하는 간단한 Fragment의 예입니다.

import android.os.Bundle
import android.support.v4.app.Fragment
import android.view.LayoutInflater
import android.view.ViewGroup

class ArticleFragment : Fragment() {
    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup,
                     savedInstanceState: Bundle?): View {
        // Inflate the layout for this fragment
        return inflater.inflate(R.layout.article_view, container, false)
    }
}

Activity와 마찬가지로, Fragment는 Activity에 추가되거나 Activity에서 삭제될 때, 그리고 Activity가 수명 주기 상태 간에 전환될 때 Fragment의 상태를 관리할 수 있는 다른 수명 주기 콜백을 구현해야 합니다. 예를 들어 Activity의 onPause() 메서드가 호출되면 Activity 내 모든 Fragment도 onPause() 호출을 받게 됩니다.

Fragment 수명 주기 및 콜백 메서드에 대한 자세한 내용은 Fragments 개발자 가이드를 참조하세요.

XML을 이용하여 Activity에 Fragment 추가

Fragment는 재사용이 가능한 모듈식 UI 구성 요소인 반면, Fragment 클래스의 각 인스턴스는 상위 FragmentActivity와 연결되어야 합니다. Activity 레이아웃 XML 파일 안에 각각의 Fragment를 정의하여 이 연결을 설정할 수 있습니다.

다음은 기기 화면을 "large"로 간주할 때, 두 개의 Fragment를 Activity에 추가하는 레이아웃 파일의 예입니다. (디렉토리 이름에 large 한정자가 지정되어 있음).

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">

    <fragment android:name="com.example.android.fragments.HeadlinesFragment"
              android:id="@+id/headlines_fragment"
              android:layout_weight="1"
              android:layout_width="0dp"
              android:layout_height="match_parent" />

    <fragment android:name="com.example.android.fragments.ArticleFragment"
              android:id="@+id/article_fragment"
              android:layout_weight="2"
              android:layout_width="0dp"
              android:layout_height="match_parent" />

</LinearLayout>

그런 다음 레이아웃을 Activity에 적용합니다.

import android.os.Bundle
import android.support.v4.app.FragmentActivity

class MainActivity : FragmentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.news_articles)
    }
}

위 소스에서 v7 appcompat library를 사용하는 경우, Activity는 FragmentActivity의 하위 클래스인 AppCompatActivity를 대신 확장해야 합니다. 자세한 내용은 App bar 추가를 참조하세요.

Reference

1. https://developer.android.com/training/basics/fragments/creating