androidx.fragment.app.Fragment
Практическое руководство по интерфейсу Android-приложения на фрагментах: один Activity, контейнеры FrameLayout, транзакции, поворот экрана и сохранение состояния. Начните прямо здесь — соберите транзакцию и посмотрите, что напишет Logcat.
res/layout/activity_main.xml
FragmentManagerсостояние
Транзакция
операции копятся до commit()
getSupportFragmentManager() .beginTransaction() // нажмите replace(…) или add(…)
Activity → Fragment
Во многих туториалах каждый экран — новый Activity, а весь интерфейс лежит прямо в его разметке. Для учебного примера это работает. Для живого приложения — начинает мешать.
Каждый новый Activity ложится в стек поверх предыдущих. Система может выгрузить нижние, и пользователь, нажав «Назад», неожиданно окажется за пределами приложения.
Activity пересоздаётся при повороте экрана, при нехватке памяти, при смене конфигурации. Интерфейс, жёстко привязанный к нему, приходится каждый раз собирать заново.
Переход между Activity перерисовывает весь экран. Фрагмент меняет только свою часть — анимировать её проще, и она легче для устройства.
Fragment lifecycle
У фрагмента свой жизненный цикл, вложенный в цикл Activity. Колбэки идут парами: что создано на пути вперёд, разбирается на пути назад.
создание
уничтожение
onAttach
onCreate
onCreateView
onViewCreated
onStart
onResume
onPause
onStop
onDestroyView
onDestroy
onDetach
В onAttach фрагмент получает Activity — сохраните ссылку, если нужна связь. В onDetach обнулите её, иначе Activity утечёт из памяти.
Здесь появляется View. Раздувайте разметку и ищите элементы здесь, а не в onCreate: до этого момента интерфейса ещё нет.
Приложение ушло в фон. Отключитесь от bound service, остановите анимации и тяжёлую работу.
Метод получает LayoutInflater и контейнер, в котором будет жить фрагмент. Раздуйте разметку, найдите нужные элементы и верните готовую View — дальше ею управляет FragmentManager.
AndroidXНастройку элементов удобно вынести в onViewCreated. Колбэк onActivityCreated устарел — не полагайтесь на него.
public class DetailFragment extends Fragment {
@Override
public View onCreateView(@NonNull LayoutInflater inflater,
@Nullable ViewGroup container,
@Nullable Bundle savedInstanceState) {
View view = inflater.inflate(
R.layout.fragment_detail, container, false);
TextView title = view.findViewById(R.id.title);
title.setText(R.string.detail_title);
return view;
}
}FragmentTransaction
FragmentManager уже есть в каждом Activity — его возвращает getSupportFragmentManager(). Изменения описываются транзакцией: beginTransaction(), затем операции, затем один commit(). До вызова commit() экран не меняется.
Очищает контейнер и кладёт в него новый фрагмент. Старые фрагменты проходят путь до onDetach и освобождают ресурсы.
getSupportFragmentManager()
.beginTransaction()
.replace(R.id.frame_container,
new DetailFragment(), "detail")
.commit();Старый фрагмент: onPause → onStop → … → onDetach
Кладёт новый фрагмент поверх старых. Старые не получают onPause и продолжают работать. Это расход ресурсов — зато так можно заранее подгрузить данные для следующего экрана.
getSupportFragmentManager()
.beginTransaction()
.add(R.id.frame_container,
new PlayerFragment(), "player")
.commit();Старый фрагмент: остаётся RESUMED
Номер текущего экрана в поле Activity потеряется при повороте: Activity пересоздаётся. Отключать пересоздание через android:configChanges — костыль, который ломается, как только у ориентаций появляются разные разметки. Передайте тег третьим параметром replace() или add() и находите фрагмент по нему.
Fragment detail = getSupportFragmentManager()
.findFragmentByTag("detail");
if (detail != null && detail.isVisible()) {
// пользователь смотрит детали — экран восстановлен
setTitle(R.string.detail_title);
}Смена фрагмента перерисовывает только часть экрана. Встроенных fade_in и fade_out часто достаточно, а свою анимацию можно описать в XML через alpha. Вызовите setCustomAnimations() до replace() или add().
getSupportFragmentManager()
.beginTransaction()
.setCustomAnimations(android.R.anim.fade_in,
android.R.anim.fade_out)
.replace(R.id.frame_container,
new DetailFragment(), "detail")
.commit();res/layout-land
Альбомную версию разметки положите в res/layout-land/ под тем же именем. При повороте система сама выберет нужный файл.
res/ ├── layout/ │ └── activity_main.xml ← один контейнер └── layout-land/ └── activity_main.xml ← + PreviewFragment
В альбомной разметке объявите ещё один фрагмент прямо в XML и отдайте ему часть ширины через layout_weight. Он появится только в горизонтальной ориентации, а фрагменты в контейнере FragmentManager вернёт на место сам.
AndroidXВместо тега <fragment> используйте FragmentContainerView.
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal">
<FrameLayout
android:id="@+id/frame_container"
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="2" />
<androidx.fragment.app.FragmentContainerView
android:id="@+id/preview"
android:name="com.example.fragment.PreviewFragment"
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="1" />
</LinearLayout>setRetainInstance · Bundle
При повороте Activity и его фрагменты пересоздаются. Что переживёт пересоздание, зависит от выбранного механизма — и у каждого своя граница.
| Механизм | Что переживёт поворот | Ограничение | В AndroidX |
|---|---|---|---|
setRetainInstance(true) |
Сам объект фрагмента и его поля. Фоновая задача вернёт результат в тот же экземпляр. | View всё равно создаются заново, их содержимое теряется. | Метод устарел. Держите данные во ViewModel. |
onSaveInstanceState(Bundle) |
Всё, что вы положили в outState: строки, числа, Parcelable. |
Читайте обратно из savedInstanceState. Bundle не рассчитан на большие объёмы. |
Работает. Для ViewModel есть SavedStateHandle. |
setArguments(Bundle) |
Стартовые параметры фрагмента — система восстановит их сама. | Только то, что нужно для запуска: идентификатор, режим, флаги. | Работает так же. |
android:freezesText="true" |
Текст в TextView и EditText. |
С собственными View не работает, с некоторыми стандартными — тоже. | Работает так же. |
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setRetainInstance(true); // переживёт поворот экрана
}@Override
public void onSaveInstanceState(@NonNull Bundle outState) {
super.onSaveInstanceState(outState);
outState.putString("query", query);
}
@Override
public View onCreateView(@NonNull LayoutInflater inflater,
@Nullable ViewGroup container,
@Nullable Bundle savedInstanceState) {
if (savedInstanceState != null) {
query = savedInstanceState.getString("query");
}
return inflater.inflate(
R.layout.fragment_search, container, false);
}onAttach · onDetach
Activity и фрагмент могут вызывать методы друг друга напрямую. А вот связывать фрагменты между собой не стоит: пусть посредником будет Activity.
Ссылку на Activity фрагмент получает в onAttach и обязан обнулить её в onDetach — иначе после пересоздания старый Activity останется в памяти.
AndroidXДля обмена данными между фрагментами есть Fragment Result API и общий ViewModel.
public class ListFragment extends Fragment {
public interface Listener {
void onArticleSelected(long articleId);
}
private Listener listener;
@Override
public void onAttach(@NonNull Context context) {
super.onAttach(context);
listener = (Listener) context;
}
@Override
public void onDetach() {
super.onDetach();
listener = null; // иначе Activity утечёт из памяти
}
}