本指南涵盖了用于调试 片段 的工具。
FragmentManager 日志记录
FragmentManager 可以将各种消息发送到 Logcat。默认情况下，这是禁用的，但有时这些日志消息可以帮助您排查片段的问题。FragmentManager 在 DEBUG 和 VERBOSE 日志级别 上发出最具意义的输出。
您可以使用以下 adb shell 命令启用日志记录
adb shell setprop log.tag.FragmentManager DEBUG
或者，您可以按以下方式启用详细日志记录
adb shell setprop log.tag.FragmentManager VERBOSE
如果启用详细日志记录，则可以在 Logcat 窗口中应用 日志级别过滤器。但是，这会过滤所有日志，而不仅仅是 FragmentManager 日志。通常最好只在您需要的日志级别启用 FragmentManager 日志记录。
DEBUG 日志记录
在 DEBUG 级别，FragmentManager 通常会发出与生命周期状态更改相关的日志消息。每个日志条目都包含来自 toString() 的 Fragment 的转储。日志条目包含以下信息
Fragment实例的简单类名。Fragment实例的 身份哈希码。- 片段管理器的
Fragment实例的唯一 ID。这在配置更改和进程死亡和重新创建中保持稳定。 - 添加
Fragment的容器的 ID，但前提是已设置。 Fragment标签，但前提是已设置。
以下是一个示例 DEBUG 日志条目
D/FragmentManager: moveto ATTACHED: NavHostFragment{92d8f1d} (fd92599e-c349-4660-b2d6-0ece9ec72f7b id=0x7f080116)
Fragment类是NavHostFragment。- 身份哈希码是
92d8f1d。 - 唯一 ID 是
fd92599e-c349-4660-b2d6-0ece9ec72f7b。 - 容器 ID 是
0x7f080116。 - 省略标签，因为没有设置标签。如果存在，它将以
tag=tag_value格式跟随 ID。
为了简洁和可读性，以下示例中的 UUID 已缩短。
这是一个正在初始化的 NavHostFragment，然后是类型为 FirstFragment 的 startDestination Fragment，正在创建并过渡到 RESUMED 状态
D/FragmentManager: moveto ATTACHED: NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: mName=null mIndex=-1 mCommitted=false
D/FragmentManager: Operations:
D/FragmentManager: Op #0: SET_PRIMARY_NAV NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: moveto CREATED: NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: mName=null mIndex=-1 mCommitted=false
D/FragmentManager: Operations:
D/FragmentManager: Op #0: REPLACE FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: Op #1: SET_PRIMARY_NAV FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto ATTACHED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto CREATED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto CREATE_VIEW: NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: moveto CREATE_VIEW: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto ACTIVITY_CREATED: NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: moveto RESTORE_VIEW_STATE: NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: moveto ACTIVITY_CREATED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto RESTORE_VIEW_STATE: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto STARTED: NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: moveto STARTED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto RESUMED: NavHostFragment{92d8f1d} (<UUID> id=0x7f080116)
D/FragmentManager: moveto RESUMED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
在用户交互之后，FirstFragment 从各种生命周期状态过渡出去。然后 SecondFragment 被实例化并过渡到 RESUMED 状态
D/FragmentManager: mName=07c8a5e8-54a3-4e21-b2cc-c8efc37c4cf5 mIndex=-1 mCommitted=false
D/FragmentManager: Operations:
D/FragmentManager: Op #0: REPLACE SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: Op #1: SET_PRIMARY_NAV SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: movefrom RESUMED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: movefrom STARTED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: movefrom ACTIVITY_CREATED: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto ATTACHED: SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: moveto CREATED: SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: moveto CREATE_VIEW: SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: moveto ACTIVITY_CREATED: SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: moveto RESTORE_VIEW_STATE: SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: moveto STARTED: SecondFragment{84132db} (<UUID> id=0x7f080116)
D/FragmentManager: movefrom CREATE_VIEW: FirstFragment{ccd2189} (<UUID> id=0x7f080116)
D/FragmentManager: moveto RESUMED: SecondFragment{84132db} (<UUID> id=0x7f080116)
所有 Fragment 实例都以标识符为后缀，以便您可以跟踪同一 Fragment 类的不同实例。
VERBOSE 日志记录
在 VERBOSE 级别，FragmentManager 通常会发出关于其内部状态的日志消息
V/FragmentManager: Run: BackStackEntry{f9d3ff3}
V/FragmentManager: add: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: Added fragment to active set NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
D/FragmentManager: moveto ATTACHED: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: Commit: BackStackEntry{5cfd2ae}
D/FragmentManager: mName=null mIndex=-1 mCommitted=false
D/FragmentManager: Operations:
D/FragmentManager: Op #0: SET_PRIMARY_NAV NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
D/FragmentManager: moveto CREATED: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: Commit: BackStackEntry{e93833f}
D/FragmentManager: mName=null mIndex=-1 mCommitted=false
D/FragmentManager: Operations:
D/FragmentManager: Op #0: REPLACE FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: Op #1: SET_PRIMARY_NAV FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: Run: BackStackEntry{e93833f}
V/FragmentManager: add: FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: Added fragment to active set FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: moveto ATTACHED: FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: moveto CREATED: FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 1 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
D/FragmentManager: moveto CREATE_VIEW: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 2 for FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: moveto CREATE_VIEW: FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 2 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 2 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
D/FragmentManager: moveto ACTIVITY_CREATED: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
D/FragmentManager: moveto RESTORE_VIEW_STATE: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: moveto ACTIVITY_CREATED: FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: moveto RESTORE_VIEW_STATE: FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: SpecialEffectsController: Enqueuing add operation for fragment FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: SpecialEffectsController: For fragment FirstFragment{886440c} (<UUID> id=0x7f080130) mFinalState = VISIBLE -> VISIBLE.
V/FragmentManager: SpecialEffectsController: Container androidx.fragment.app.FragmentContainerView{7578ffa V.E...... ......I. 0,0-0,0 #7f080130 app:id/nav_host_fragment_content_fragment} is not attached to window. Cancelling pending operation Operation {382a9ab} {mFinalState = VISIBLE} {mLifecycleImpact = ADDING} {mFragment = FirstFragment{886440c} (<UUID> id=0x7f080130)}
V/FragmentManager: SpecialEffectsController: Operation {382a9ab} {mFinalState = VISIBLE} {mLifecycleImpact = ADDING} {mFragment = FirstFragment{886440c} (<UUID> id=0x7f080130)} has called complete.
V/FragmentManager: SpecialEffectsController: Setting view androidx.constraintlayout.widget.ConstraintLayout{3968808 I.E...... ......I. 0,0-0,0} to VISIBLE
V/FragmentManager: computeExpectedState() of 4 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: SpecialEffectsController: Enqueuing add operation for fragment NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: SpecialEffectsController: For fragment NavHostFragment{86274b0} (<UUID> id=0x7f080130) mFinalState = VISIBLE -> VISIBLE.
V/FragmentManager: SpecialEffectsController: Container androidx.fragment.app.FragmentContainerView{2ba8ba1 V.E...... ......I. 0,0-0,0 #7f080130 app:id/nav_host_fragment_content_fragment} is not attached to window. Cancelling pending operation Operation {f7eb1c6} {mFinalState = VISIBLE} {mLifecycleImpact = ADDING} {mFragment = NavHostFragment{86274b0} (<UUID> id=0x7f080130)}
V/FragmentManager: SpecialEffectsController: Operation {f7eb1c6} {mFinalState = VISIBLE} {mLifecycleImpact = ADDING} {mFragment = NavHostFragment{86274b0} (<UUID> id=0x7f080130)} has called complete.
V/FragmentManager: SpecialEffectsController: Setting view androidx.fragment.app.FragmentContainerView{7578ffa I.E...... ......I. 0,0-0,0 #7f080130 app:id/nav_host_fragment_content_fragment} to VISIBLE
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: Run: BackStackEntry{5cfd2ae}
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 4 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 5 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
D/FragmentManager: moveto STARTED: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 5 for FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: moveto STARTED: FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 5 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 5 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 5 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 5 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
D/FragmentManager: moveto RESUMED: NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for FirstFragment{886440c} (<UUID> id=0x7f080130)
D/FragmentManager: moveto RESUMED: FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for FirstFragment{886440c} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
V/FragmentManager: computeExpectedState() of 7 for NavHostFragment{86274b0} (<UUID> id=0x7f080130)
此示例仅涵盖 FirstFragment 上的加载。包括过渡到 SecondFragment 会大大增加日志条目。许多 VERBOSE 级别的日志消息对应用程序开发人员没有太大用处。但是，查看何时发生回退堆栈更改有助于调试某些问题。
用于片段的 StrictMode
Jetpack Fragment 库的 1.4.0 及更高版本包含用于片段的 StrictMode。它可以捕获一些常见问题，这些问题可能会导致您的应用程序以意外的方式运行。有关使用 StrictMode 的更多信息，请参阅 StrictMode。
自定义 Policy 定义了哪些违规行为将被检测到，并指定了检测到违规行为时将采取的处罚措施。
要应用自定义 StrictMode 策略，请将其分配给 FragmentManager。尽早执行此操作。在本例中，您可以在 init 块或 Java 构造函数中执行此操作。
Kotlin
class ExampleActivity : AppCompatActivity() {
init {
supportFragmentManager.strictModePolicy =
FragmentStrictMode.Policy.Builder()
.penaltyDeath()
.detectFragmentReuse()
.allowViolation(FirstFragment::class.java,
FragmentReuseViolation::class.java)
.build()
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val binding = ActivityExampleBinding.inflate(layoutInflater)
setContentView(binding.root)
...
}
}
Java
class ExampleActivity extends AppCompatActivity() {
ExampleActivity() {
getSupportFragmentManager().setStrictModePolicy(
new FragmentStrictMode.Policy.Builder()
.penaltyDeath()
.detectFragmentReuse()
.allowViolation(FirstFragment.class,
FragmentReuseViolation.class)
.build()
);
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState)
ActivityExampleBinding binding =
ActivityExampleBinding.inflate(getLayoutInflater());
setContentView(binding.getRoot());
...
}
}
对于需要知道 Context 以确定是否启用 StrictMode 的情况（例如，从布尔资源的值），您可以使用 OnContextAvailableListener 推迟将 StrictMode 策略分配给 FragmentManager。
Kotlin
class ExampleActivity : AppCompatActivity() {
init {
addOnContextAvailableListener { context ->
if(context.resources.getBoolean(R.bool.enable_strict_mode)) {
supportFragmentManager.strictModePolicy = FragmentStrictMode.Policy.Builder()
.penaltyDeath()
.detectFragmentReuse()
.allowViolation(FirstFragment::class.java, FragmentReuseViolation::class.java)
.build()
}
}
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val binding = ActivityExampleBinding.inflate(layoutInflater)
setContentView(binding.root)
...
}
}
Java
class ExampleActivity extends AppCompatActivity() {
ExampleActivity() {
addOnContextAvailableListener((context) -> {
if(context.getResources().getBoolean(R.bool.enable_strict_mode)) {
getSupportFragmentManager().setStrictModePolicy(
new FragmentStrictMode.Policy.Builder()
.penaltyDeath()
.detectFragmentReuse()
.allowViolation(FirstFragment.class, FragmentReuseViolation.class)
.build()
);
}
}
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState)
ActivityExampleBinding binding = ActivityExampleBinding.inflate(getLayoutInflater());
setContentView(binding.getRoot());
...
}
}
配置 StrictMode 以捕获所有可能的违规行为的最新时间点是在 onCreate() 中，在调用 super.onCreate() 之前。
Kotlin
class ExampleActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
supportFragmentManager.strictModePolicy = FragmentStrictMode.Policy.Builder()
.penaltyDeath()
.detectFragmentReuse()
.allowViolation(FirstFragment::class.java, FragmentReuseViolation::class.java)
.build()
super.onCreate(savedInstanceState)
val binding = ActivityExampleBinding.inflate(layoutInflater)
setContentView(binding.root)
...
}
}
Java
class ExampleActivity extends AppCompatActivity() {
@Override
protected void onCreate(Bundle savedInstanceState) {
getSupportFragmentManager().setStrictModePolicy(
new FragmentStrictMode.Policy.Builder()
.penaltyDeath()
.detectFragmentReuse()
.allowViolation(FirstFragment.class, FragmentReuseViolation.class)
.build()
);
super.onCreate(savedInstanceState)
ActivityExampleBinding binding = ActivityExampleBinding.inflate(getLayoutInflater());
setContentView(binding.getRoot());
...
}
}
这些示例中使用的策略仅检测片段重用违规行为，并且应用程序在每次发生违规行为时都会终止。 penaltyDeath() 在调试版本中非常有用，因为它失败得足够快，以至于您无法忽略违规行为。
还可以选择性地允许某些违规行为。但是，在前面的示例中使用的策略对所有其他片段类型强制执行此违规行为。这对于第三方库组件可能包含 StrictMode 违规行为的情况很有用。
在这种情况下，您可以暂时将这些违规行为添加到您自己的 StrictMode 的允许列表中，这些违规行为针对您不拥有的组件，直到库修复其违规行为为止。
有关如何配置其他违规行为的详细信息，请参阅 FragmentStrictMode.Policy.Builder 的文档。
有三种处罚类型。
penaltyLog()将违规行为的详细信息转储到 Logcat。penaltyDeath()在检测到违规行为时会终止应用程序。penaltyListener()允许您添加一个自定义侦听器，该侦听器将在检测到违规行为时被调用。
您可以在 Policy 中应用任何处罚组合。如果您的策略没有明确指定处罚，则会应用 penaltyLog() 的默认值。如果在自定义 Policy 中应用了除 penaltyLog() 以外的处罚，则除非您明确设置，否则 penaltyLog() 将被禁用。
penaltyListener() 在您拥有要向其记录违规行为的第三方日志记录库时非常有用。或者，您可能希望在发布版本中启用非致命违规行为捕获，并将它们记录到崩溃报告库。此策略可以检测到其他情况下错过的违规行为。
要设置全局 StrictMode 策略，请使用 FragmentStrictMode.setDefaultPolicy() 方法设置一个应用于所有 FragmentManager 实例的默认策略。
Kotlin
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
FragmentStrictMode.defaultPolicy =
FragmentStrictMode.Policy.Builder()
.detectFragmentReuse()
.detectFragmentTagUsage()
.detectRetainInstanceUsage()
.detectSetUserVisibleHint()
.detectTargetFragmentUsage()
.detectWrongFragmentContainer()
.apply {
if (BuildConfig.DEBUG) {
// Fail early on DEBUG builds
penaltyDeath()
} else {
// Log to Crashlytics on RELEASE builds
penaltyListener {
FirebaseCrashlytics.getInstance().recordException(it)
}
}
}
.build()
}
}
Java
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
FragmentStrictMode.Policy.Builder builder = new FragmentStrictMode.Policy.Builder();
builder.detectFragmentReuse()
.detectFragmentTagUsage()
.detectRetainInstanceUsage()
.detectSetUserVisibleHint()
.detectTargetFragmentUsage()
.detectWrongFragmentContainer();
if (BuildConfig.DEBUG) {
// Fail early on DEBUG builds
builder.penaltyDeath();
} else {
// Log to Crashlytics on RELEASE builds
builder.penaltyListener((exception) ->
FirebaseCrashlytics.getInstance().recordException(exception)
);
}
FragmentStrictMode.setDefaultPolicy(builder.build());
}
}
以下部分描述了违规行为类型和可能的解决方法。
片段重用
片段重用违规行为是使用 detectFragmentReuse() 启用的，并抛出 FragmentReuseViolation。
此违规行为表示在 Fragment 从 FragmentManager 中删除后重用 Fragment 实例。这种重用可能会导致问题，因为 Fragment 可能保留其先前使用的状态，并且行为不一致。如果您每次都创建一个新实例，它在添加到 FragmentManager 时始终处于初始状态。
片段标签用法
片段标签用法违规行为是使用 detectFragmentTagUsage() 启用的，并抛出 FragmentTagUsageViolation。
此违规行为表明 Fragment 是使用 XML 布局中的 <fragment> 标签膨胀的。要解决此问题，请在 <androidx.fragment.app.FragmentContainerView> 内膨胀 Fragment，而不是在 <fragment> 标签内膨胀。使用 FragmentContainerView 膨胀的片段可以可靠地处理 Fragment 事务和配置更改。如果您使用 <fragment> 标签，这些操作可能无法按预期工作。
保留实例用法
保留实例用法违规行为是使用 detectRetainInstanceUsage() 启用的，并抛出 RetainInstanceUsageViolation。
此违规行为表明使用了保留的 Fragment，具体来说，如果存在对 setRetainInstance() 或 getRetainInstance() 的调用，这两个方法都已弃用。
不要使用这些方法来自己管理保留的 Fragment 实例，而是在 ViewModel 中存储状态，由它为您处理。
设置用户可见提示
设置用户可见提示违规行为是使用 detectSetUserVisibleHint() 启用的，并抛出 SetUserVisibleHintViolation。
此违规行为表明对 setUserVisibleHint() 的调用，该方法已弃用。
如果您手动调用此方法，则改为调用 setMaxLifecycle()。如果您覆盖此方法，请将行为移动到 onResume()（传入 true 时）和 onPause()（传入 false 时）。
目标片段用法
目标片段用法违规行为是使用 detectTargetFragmentUsage() 启用的，并抛出 TargetFragmentUsageViolation。
此违规行为表明对 setTargetFragment()、getTargetFragment() 或 getTargetRequestCode() 的调用，这些方法都已弃用。不要使用这些方法，而是注册一个 FragmentResultListener。有关传递结果的更多信息，请参阅 在片段之间传递结果。
错误的片段容器
错误的片段容器违规行为是使用 detectWrongFragmentContainer() 启用的，并抛出 WrongFragmentContainerViolation。
此违规行为表明将 Fragment 添加到 FragmentContainerView 以外的容器。与 Fragment 标签用法 一样，除非托管在 FragmentContainerView 内，否则片段事务可能无法按预期工作。使用容器视图还有助于解决 View API 中导致使用退出动画的片段绘制在所有其他片段之上的问题。