Android导航组件学习（五）：在目的地之间传递数据

使用 Android 导航组件在目的地之间传递数据

在 Android 应用程序中，在活动或片段之间传递数据至关重要，导航组件提供了两种机制来简化这一任务：Argument 和 Safe Args。本文将深入探讨这些机制，指导您在应用程序中有效传递数据。

理解数据传递

数据传递是 Android 应用程序中一项常见的需求，例如在不同的屏幕之间传递用户输入或模型对象。导航组件提供了轻量级的 Argument 机制，适用于传递小量数据，如字符串、整数或布尔值。对于更复杂或大量的数据，Safe Args 提供了类型安全的方式，降低了错误可能性。

使用 Argument 传递数据

Argument 是传递小量数据的简单方法。要使用 Argument，请按照以下步骤操作：

1. 在来源目的地定义 Argument： 在来源目的地中，使用 <argument> 标签定义要传递的数据类型。
2. 在导航图中指定 Argument： 在导航图中，将 Argument 指定为导航操作的一部分。
3. 在目标目的地接收 Argument： 在目标目的地中，使用 getArguments() 方法检索 Argument。

示例：

// 源目的地
<fragment
    android:id="@+id/sourceFragment"
    ... >
    <argument
        android:name="text"
        android:defaultValue="Hello World" />
</fragment>

// 导航图
<navigation>
    <fragment
        android:id="@+id/sourceFragment"
        ... >
        <action
            android:id="@+id/action_source_to_destination"
            app:destination="@+id/destinationFragment"
            app:popUpTo="@+id/sourceFragment"
            app:popUpToInclusive="true"
            app:enterAnim="@anim/slide_in"
            app:exitAnim="@anim/slide_out">
            <argument
                android:name="text"
                app:argType="string"
                app:nullable="false" />
        </action>
    </fragment>
    <fragment
        android:id="@+id/destinationFragment"
        ... >
        <argument
            android:name="text"
            android:defaultValue="Default Text" />
    </fragment>
</navigation>

// 目标目的地
public class DestinationFragment extends Fragment {
    private String text;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        text = getArguments().getString("text");
    }
}

使用 Safe Args 传递数据

对于复杂或大量的数据，Safe Args 提供了更高级的机制。使用 Safe Args：

1. 创建 Safe Args 类： 使用导航组件插件创建 Safe Args 类，其中包含用于传递数据的代码。
2. 在来源目的地中使用 Safe Args： 获取 Argument 并创建要传递的数据对象。
3. 在导航图中指定 Safe Args： 将 Safe Args 类指定为导航操作的一部分。
4. 在目标目的地中接收数据： 使用 Safe Args 类接收传递的数据。

示例：

// 源目的地
public class SourceFragment extends Fragment {
    private User user;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        user = new User(...);
        Navigation.findNavController(getView()).navigate(DestinationFragmentDirections.actionSourceToDestination(user));
    }
}

// Safe Args 类
public class DestinationFragmentDirections {
    public static ActionSourceToDestination actionSourceToDestination(User user) {
        return new ActionSourceToDestination(user);
    }
}

// 目标目的地
public class DestinationFragment extends Fragment {
    private User user;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        user = DestinationFragmentDirections.fromDestination(getArguments()).getUser();
    }
}

结论

在 Android 应用程序中有效传递数据对于创建用户友好的体验至关重要。导航组件的 Argument 和 Safe Args 机制提供了强大的工具，可轻松简化数据传递任务。通过应用适当的最佳实践和理解这些机制，开发人员可以创建高效且用户友好的应用程序。

常见问题解答

1. Argument 和 Safe Args 之间的区别是什么？
   Argument 用于传递小量数据，而 Safe Args 用于传递复杂或大量数据。Safe Args 提供类型安全，从而降低错误的可能性。

2. 如何使用导航图指定 Argument？
   在导航操作的 <action> 元素中使用 app:argument 属性。

3. 如何从目标目的地中获取 Argument？
   使用 getArguments() 方法检索 Argument。

4. 如何使用 Safe Args 创建传递数据对象？
   使用 Safe Args 类中提供的生成方法创建对象。

5. Safe Args 是否会自动更新传递的数据？
   是的，Safe Args 会在 Argument 值更改时自动更新传递的数据。