ActivityResultLauncher跨类使用全攻略

大家好，我们又见面了啊~本文《ActivityResultLauncher跨类使用方法详解》的内容中将会涉及到等等。如果你正在学习文章相关知识，欢迎关注我，以后会给大家带来更多文章相关文章，希望我们能一起进步！下面就开始本文的正式内容~

本文详细介绍了在Android应用中如何注册`ActivityResultLauncher`，并重点阐述了将其实例安全地传递给其他类进行跨模块调用的两种主要策略：通过构造函数传递和通过方法参数传递。文章通过示例代码演示了这些实现方式，并提供了关于生命周期管理和潜在内存泄漏等关键注意事项，旨在帮助开发者构建更模块化、可维护的Android应用。

在现代Android开发中，ActivityResultLauncher 提供了一种简洁、类型安全的方式来启动活动并处理其结果，取代了传统的 startActivityForResult() 和 onActivityResult() 方法。通常，ActivityResultLauncher 实例在 Activity 或 Fragment 的生命周期方法（如 onCreate()）中注册。然而，在实际项目中，我们可能需要在其他辅助类、业务逻辑类或Presenter中触发活动启动，并接收其结果。本文将详细介绍如何实现 ActivityResultLauncher 的跨类调用。

1. 注册 ActivityResultLauncher

首先，我们需要在 Activity 或 Fragment 中注册 ActivityResultLauncher。这个过程通常在宿主组件的 onCreate() 或 onAttach() 方法中完成，以确保其与组件的生命周期绑定。

import androidx.activity.result.ActivityResult;
import androidx.activity.result.ActivityResultCallback;
import androidx.activity.result.ActivityResultLauncher;
import androidx.activity.result.contract.ActivityResultContracts;
import androidx.appcompat.app.AppCompatActivity;
import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    private ActivityResultLauncher<Intent> activityResultLauncher;
    private String selectedPath; // 用于存储选择的路径

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 注册 ActivityResultLauncher
        activityResultLauncher = registerForActivityResult(
            new ActivityResultContracts.StartActivityForResult(),
            new ActivityResultCallback<ActivityResult>() {
                @Override
                public void onActivityResult(ActivityResult result) {
                    if (result.getResultCode() == Activity.RESULT_OK) {
                        if (result.getData() != null) {
                            // 处理返回的数据，例如获取文件路径
                            Uri uri = result.getData().getData();
                            if (uri != null) {
                                // 示例：处理特定URI类型，如content://com.android.providers.media.documents/document/image%3A12345
                                // 实际路径解析可能需要更复杂的逻辑，取决于URI类型
                                selectedPath = uri.toString(); // 简化处理，实际可能需要更复杂的路径解析
                                Toast.makeText(MainActivity.this, "Selected URI: " + selectedPath, Toast.LENGTH_LONG).show();
                            }
                        }
                    } else {
                        Toast.makeText(MainActivity.this, "Activity cancelled or failed", Toast.LENGTH_SHORT).show();
                    }
                }
            });

        Button openFileButton = findViewById(R.id.open_file_button);
        openFileButton.setOnClickListener(v -> {
            // 在MainActivity中直接启动
            Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
            intent.setType("*/*"); // 选择任意类型文件
            intent.addCategory(Intent.CATEGORY_OPENABLE);
            activityResultLauncher.launch(intent);
        });
    }
}

在上述代码中，activityResultLauncher 被注册用于启动一个活动并获取其结果。接下来，我们将探讨如何在其他类中利用这个已注册的 activityResultLauncher 实例。

2. 跨类使用 ActivityResultLauncher 的策略

要在其他类中执行 activityResultLauncher.launch(...) 操作，核心思想是将已注册的 ActivityResultLauncher 实例传递给这些类。以下是两种常用的策略：

策略一：通过构造函数传递实例

这种方法适用于需要长期持有 ActivityResultLauncher 实例的辅助类或业务逻辑类。在创建这些类的实例时，将 ActivityResultLauncher 作为参数传入。

示例代码：

首先，定义一个辅助类 FilePickerHelper：

import android.content.Intent;
import android.widget.Toast;

import androidx.activity.result.ActivityResultLauncher;

public class FilePickerHelper {

    private final ActivityResultLauncher<Intent> launcher;

    // 构造函数接收 ActivityResultLauncher 实例
    public FilePickerHelper(ActivityResultLauncher<Intent> launcher) {
        this.launcher = launcher;
    }

    // 在辅助类中定义方法来启动文件选择器
    public void openFilePicker() {
        if (launcher != null) {
            Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
            intent.setType("*/*");
            intent.addCategory(Intent.CATEGORY_OPENABLE);
            launcher.launch(intent);
        } else {
            // 可以在此处添加错误处理或日志
            System.err.println("ActivityResultLauncher is not initialized.");
        }
    }

    // 辅助方法，用于在需要时清理引用，防止内存泄漏（可选，取决于生命周期管理）
    public void releaseLauncher() {
        // 如果FilePickerHelper的生命周期比Activity长，可以考虑在此处清理引用
        // 但通常情况下，由于launcher是final，并且Activity/Fragment会自行管理其生命周期，
        // 这种显式清理不是强制的，除非有特定的内存管理需求。
    }
}

然后在 MainActivity 中使用 FilePickerHelper：

// ... 在 MainActivity 的 onCreate 方法中 ...

    private FilePickerHelper filePickerHelper;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // ... 注册 activityResultLauncher ...

        // 实例化 FilePickerHelper，并传入 activityResultLauncher
        filePickerHelper = new FilePickerHelper(activityResultLauncher);

        Button openFileButtonFromHelper = findViewById(R.id.open_file_button_from_helper);
        openFileButtonFromHelper.setOnClickListener(v -> {
            // 通过辅助类启动文件选择器
            filePickerHelper.openFilePicker();
        });
    }

策略二：通过方法参数传递实例

如果辅助类或工具类只需要临时使用 ActivityResultLauncher，或者其方法是静态的，那么可以通过方法参数的方式传递 ActivityResultLauncher 实例。

示例代码：

定义一个工具类 ActivityLauncherUtil：

import android.content.Intent;

import androidx.activity.result.ActivityResultLauncher;

public class ActivityLauncherUtil {

    // 静态方法，接收 ActivityResultLauncher 作为参数
    public static void launchFilePicker(ActivityResultLauncher<Intent> launcher) {
        if (launcher != null) {
            Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
            intent.setType("*/*");
            intent.addCategory(Intent.CATEGORY_OPENABLE);
            launcher.launch(intent);
        } else {
            System.err.println("ActivityResultLauncher is null, cannot launch.");
        }
    }

    // 非静态方法也可以，同样接收 ActivityResultLauncher 作为参数
    public void launchCustomActivity(ActivityResultLauncher<Intent> launcher, Intent customIntent) {
        if (launcher != null && customIntent != null) {
            launcher.launch(customIntent);
        } else {
            System.err.println("ActivityResultLauncher or Intent is null, cannot launch.");
        }
    }
}

然后在 MainActivity 中使用 ActivityLauncherUtil：

// ... 在 MainActivity 的 onCreate 方法中 ...

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // ... 注册 activityResultLauncher ...

        Button openFileButtonFromUtil = findViewById(R.id.open_file_button_from_util);
        openFileButtonFromUtil.setOnClickListener(v -> {
            // 通过工具类的静态方法启动文件选择器
            ActivityLauncherUtil.launchFilePicker(activityResultLauncher);
        });

        Button launchCustomButton = findViewById(R.id.launch_custom_activity_button);
        launchCustomButton.setOnClickListener(v -> {
            // 通过工具类的非静态方法启动自定义活动
            Intent customIntent = new Intent(MainActivity.this, AnotherActivity.class);
            new ActivityLauncherUtil().launchCustomActivity(activityResultLauncher, customIntent);
        });
    }

3. 注意事项

在实现 ActivityResultLauncher 的跨类调用时，需要注意以下几点：

• 生命周期管理： ActivityResultLauncher 实例与其注册的 Activity 或 Fragment 的生命周期紧密绑定。这意味着当宿主组件被销毁时，ActivityResultLauncher 也会变得无效。确保在其他类中使用 ActivityResultLauncher 时，宿主组件仍然存活。
• 内存泄漏： 如果将 ActivityResultLauncher 实例作为成员变量传递给一个生命周期可能比宿主组件更长的对象，可能会导致宿主 Activity 或 Fragment 无法被垃圾回收，从而引发内存泄漏。
  • 解决方案： 确保辅助类不会强引用宿主组件。如果辅助类需要持有 ActivityResultLauncher，并且其生命周期可能超出宿主组件，可以考虑使用 WeakReference 来持有 ActivityResultLauncher，并在宿主组件销毁时（例如在 onDestroy() 中）显式地将辅助类中的引用置空。
• 职责分离： 尽管可以将 ActivityResultLauncher 传递给其他类，但仍需考虑职责分离原则。是否真的需要辅助类来启动活动？有时，让宿主 Activity 或 Fragment 负责所有UI相关的交互（包括启动活动）会使代码更清晰、更易于维护。辅助类可以负责准备 Intent 或处理返回结果的业务逻辑，然后将 Intent 或结果数据回调给宿主组件。
• 上下文依赖： ActivityResultLauncher 本身不直接依赖 Context 来启动活动，但它内部调用的 Intent 可能会需要 Context。确保在构造 Intent 时，如果需要 Context，则使用宿主 Activity 或 Fragment 的 Context。

总结

通过将 ActivityResultLauncher 实例作为构造函数参数或方法参数传递，我们可以在Android应用中的其他类中灵活地触发活动启动和处理结果。这种方法有助于实现更清晰的模块化设计，将UI交互逻辑与业务逻辑分离。在实践中，务必注意生命周期管理和潜在的内存泄漏问题，以确保应用的稳定性和性能。

到这里，我们也就讲完了《ActivityResultLauncher跨类使用全攻略》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！