Fragment

Вызывается, когда фрагмент прикрепляется к Activity.

override fun onAttach(context: Context) {
    super.onAttach(context)
    println("Fragment attached to Activity")
}

Инициализация фрагмента, настройка данных, которые сохраняются при пересоздании.

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    println("Fragment created")
}

Создание иерархии View.

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?
): View? {
    println("Creating fragment view")
    return inflater.inflate(R.layout.fragment_layout, container, false)
}

Вызывается сразу после onCreateView. Инициализация компонентов View.

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    println("View created")
}

Вызывается, когда Activity завершила onCreate.

override fun onActivityCreated(savedInstanceState: Bundle?) {
    super.onActivityCreated(savedInstanceState)
    println("Activity created for fragment")
}

Восстановление состояния View фрагмента.

override fun onViewStateRestored(savedInstanceState: Bundle?) {
    super.onViewStateRestored(savedInstanceState)
    println("View state restored")
}

Фрагмент становится видимым для пользователя.

override fun onStart() {
    super.onStart()
    println("Fragment started")
}

Фрагмент становится активным и начинает взаимодействовать с пользователем.

override fun onResume() {
    super.onResume()
    println("Fragment resumed")
}

Вызывается перед тем, как фрагмент перестанет быть активным.

override fun onPause() {
    super.onPause()
    println("Fragment paused")
}

Фрагмент больше не видим.

override fun onStop() {
    super.onStop()
    println("Fragment stopped")
}

Освобождение ресурсов, связанных с View.

override fun onDestroyView() {
    super.onDestroyView()
    println("Fragment view destroyed")
}

Фрагмент уничтожается. Очищение ресурсов.

override fun onDestroy() {
    super.onDestroy()
    println("Fragment destroyed")
}

Фрагмент отсоединяется от Activity.

override fun onDetach() {
    super.onDetach()
    println("Fragment detached from Activity")
}

Позволяет сохранить экземпляр фрагмента при пересоздании Activity, например, при повороте экрана. Это удобно для хранения долгоживущих объектов или фоновых задач, которые не должны пересоздаваться.

class MyFragment: Fragment() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        retainInstance = true
    }
}

Поле класса AppCompatActivity, которое предоставляет доступ к экземпляру FragmentManager, совместимому Support Library. Оно используется для управления фрагментами в приложениях, которые используют компоненты из библиотеки поддержки, что позволяет обеспечивать совместимость с более старыми версиями Android.

class MainActivity: AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        supportFragmentManager.beginTransaction()
            .add(R.id.fragment_container, FirstFragment())
            .commit()
        }
    }
}

Поле класса Fragment, которое предоставляет доступ к FragmentManager родительского фрагмента. Оно используется, когда есть вложенные фрагменты (child fragments) и необходимо взаимодействовать с родительским FragmentManager, а не с childFragmentManager.

class ChildFragment: Fragment() {

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        parentFragmentManager
            .beginTransaction()
            .replace(R.id.fragment_container, NewParentFragment())
            .addToBackStack(null)
            .commit()
    }
}

Поле класса Fragment, которое предоставляет доступ к FragmentManager для управления дочерними фрагментами. Оно используется, когда есть фрагмент, который содержит другие фрагменты внутри себя (вложенные фрагменты), и нужно управлять их жизненным циклом и взаимодействием.

class ParentFragment: Fragment() {

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        childFragmentManager
            .beginTransaction()
            .add(R.id.child_fragment_container, ChildFragment())
            .commit()
    }
}

Используется для добавления фрагмента в контейнер. При добавлении нового фрагмента через add, предыдущий фрагмент остается активным, его жизненный цикл не меняется, он продолжает работать в RESUMED состоянии.

supportFragmentManager
    .beginTransaction()
    .add(R.id.fragment_container, MyFragment(), "myFragmentTag")
    .commit()

Удаляет текущий фрагмент в контейнере и добавляет новый. Это замещает один фрагмент другим, вызывая полный жизненный цикл нового фрагмента от onCreate() до onResume() и уничтожение предыдущего фрагмента от onPause() до onDestroy().

supportFragmentManager
    .beginTransaction()
    .replace(R.id.fragment_container, FragmentB())
    .commit()

Удаляет фрагмент из FragmentManager, что означает, что фрагмент больше не отображается на экране. Однако состояние фрагмента сохраняется в FragmentManager, и его можно восстановить, если это необходимо.

supportFragmentManager
    .beginTransaction()
    .remove(fragment)
    .commit()

Добавляет текущую транзакцию фрагментов в стек возврата, что позволяет пользователю вернуться к предыдущему состоянию фрагментов при нажатии кнопки «Назад».

supportFragmentManager
    .beginTransaction()
    .replace(R.id.fragment_container, secondFragment)
    .addToBackStack(null)
    .commit()

Удаляет верхний фрагмент из стека возврата. Это приводит к тому, что фрагмент, который был перед ним, становится видимым, а текущий фрагмент удаляется.

// Удаление последнего фрагмента из стека возврата
supportFragmentManager.popBackStack()

// Удаление всех фрагментов до фрагмента с именем "myFragmentName"
supportFragmentManager.popBackStack("myFragmentName", FragmentManager.POP_BACK_STACK_INCLUSIVE)

Работает аналогично методу popBackStack, но выполняет операцию немедленно, а не асинхронно.

// Немедленное удаление последнего фрагмента из стека возврата
supportFragmentManager.popBackStackImmediate()

// Немедленное удаление всех фрагментов до фрагмента с именем "myFragmentName"
supportFragmentManager.popBackStackImmediate("myFragmentName", FragmentManager.POP_BACK_STACK_INCLUSIVE)

Заставляет FragmentManager немедленно выполнить все ожидающие транзакции. Это отличается от методов commit или commitNow, которые фиксируют транзакции асинхронно или немедленно, но не обязательно выполняют их сразу.

supportFragmentManager.executePendingTransactions()

Фиксирует изменения в FragmentTransaction, сделанные до вызова этого метода. Это включает в себя добавление, удаление, замену или изменение фрагментов. Выполняет транзакцию асинхронно. Это значит, что изменения могут быть применены позже, в следующем цикле обновления UI. Если вызвать executePendingTransactions после метода commit, то транзакция станет синхронной.

supportFragmentManager
    .beginTransaction()
    .replace(R.id.fragment_container, fragment)
    .commit()

Выполняет транзакцию синхронно, немедленно фиксируя изменения. Используйте этот метод, если нужно убедиться, что транзакция завершена до выполнения следующего кода.

supportFragmentManager
    .beginTransaction()
    .replace(R.id.fragment_container, fragment)
    .commitNow()

Фиксирует транзакцию, игнорируя потенциальные потери состояния активити и фрагмента. Это может быть полезно, если состояние не критично и транзакция должна быть выполнена независимо от возможной потери состояния. Использование commitAllowingStateLoss приводит к ситуациям такого вида: Пользователь возвращается на Activity, которая была уничтожена системой. Пользователь ожидает увидеть UI, который отображался перед тем как он покинул активити, но транзакция с добавлением или удалением фрагмента не сохранилась и пользователь видит пустой экран или активити в неверном состоянии. Хорошей практикой считается использование commit, а не commitAllowingStateLoss. Если вы получаете репорты о state loss крэшах, пробуйте решить корень проблемы. Для этого не вызывайте commit в onPause или следующих после него методах.

supportFragmentManager
    .beginTransaction()
    .replace(R.id.fragment_container, fragment)
    .commitAllowingStateLoss()

Используется для закрытия DialogFragment. Закрывает диалог с анимацией и планирует удаление фрагмента в следующей доступной транзакции, что позволяет избежать потенциальных проблем с состоянием фрагмента.

class MyDialogFragment: DialogFragment() {

    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
        return AlertDialog.Builder(requireContext())
            .setTitle("Title")
            .setMessage("Message")
            .setPositiveButton("OK") { _, _ ->
                // Закрываем диалог с анимацией
                dismiss()
            }
            .setNegativeButton("Cancel") { _, _ -> }
            .create()
    }
}

Используется для немедленного удаления фрагмента. В отличие от dismiss, который может быть отложен до завершения текущего цикла событий, dismissNow выполнит действие сразу же.

class MyDialogFragment: DialogFragment() {

    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
        return AlertDialog.Builder(requireContext())
            .setTitle("Title")
            .setMessage("Message")
            .setPositiveButton("OK") { _, _ ->
                // Закрываем диалог немедленно
                dismissNow()
            }
            .setNegativeButton("Cancel") { _, _ -> }
            .create()
    }
}

Используется для удаления фрагмента, игнорируя потенциальные потери состояния. Он похож на метод dismiss, но позволяет удалять фрагмент даже если это может привести к потере состояния активити или фрагмента.

class MyDialogFragment: DialogFragment() {

    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
        return AlertDialog.Builder(requireContext())
            .setTitle("Title")
            .setMessage("Message")
            .setPositiveButton("OK") { _, _ -> }
            .setNegativeButton("Cancel") { _, _ ->
                // Закрываем диалог, позволяя потерю состояния
                dismissAllowingStateLoss()
            }
            .create()
    }
}

Удаляет все фрагменты из стека возврата до указанного фрагмента и включает его в удаление. Используется, когда необходимо удалить фрагмент, соответствующий имени или ID, а также все фрагменты, добавленные после него.

// Добавляем фрагменты в стек возврата
supportFragmentManager.beginTransaction()
    .replace(R.id.container, FirstFragment())
    .addToBackStack("firstFragment")
    .commit()

supportFragmentManager.beginTransaction()
    .replace(R.id.container, SecondFragment())
    .addToBackStack("secondFragment")
    .commit()

// Вернуться к FirstFragment и удалить SecondFragment
supportFragmentManager.popBackStack("firstFragment", FragmentManager.POP_BACK_STACK_INCLUSIVE)

Удаляет все фрагменты из стека возврата до указанного фрагмента, но не включает его в удаление. Используется, когда нужно оставить указанный фрагмент на вершине стека.

// Добавляем фрагменты в стек возврата
supportFragmentManager.beginTransaction()
    .replace(R.id.container, FirstFragment())
    .addToBackStack("firstFragment")
    .commit()

supportFragmentManager.beginTransaction()
    .replace(R.id.container, SecondFragment())
    .addToBackStack("secondFragment")
    .commit()

// Вернуться к FirstFragment, оставляя его на вершине стека
supportFragmentManager.popBackStack("firstFragment", FragmentManager.POP_BACK_STACK_EXCLUSIVE)

Ищет фрагмент по заданному тегу. Используется, если фрагмент добавлен в FragmentTransaction с помощью метода add или replace и ему присвоен тег.

val fragment = supportFragmentManager.findFragmentByTag("MY_FRAGMENT")
if (fragment != null) {
    // Фрагмент найден
}

Ищет фрагмент, привязанный к указанному ресурсу View по его ID. Используется, если фрагмент был добавлен через XML-разметку или динамически с помощью FragmentTransaction и указан ID контейнера.

val fragment = supportFragmentManager.findFragmentById(R.id.fragment_container)
if (fragment != null) {
    // Фрагмент найден
}