Android Studio Java项目API 34中onBackPressed()已废弃的解决方法

在 Android 14（API 级别 34）中，onBackPressed() 方法已被官方标记为废弃，推荐使用 OnBackPressedCallback 配合 OnBackPressedDispatcher 来处理返回键逻辑，以下是具体实现方案：

Activity 中的替代实现 #

直接在 onCreate 方法中注册返回键回调，替代原有的 onBackPressed() 重写：

import androidx.activity.OnBackPressedCallback;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;

public class YourActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.your_activity_layout);

        // 创建并注册返回键回调
        OnBackPressedCallback backCallback = new OnBackPressedCallback(true) {
            @Override
            public void handleOnBackPressed() {
                // 这里编写你原本在onBackPressed()中的逻辑
                // 示例：执行默认返回行为（关闭当前Activity）
                finish();
                
                // 若需要触发系统默认返回逻辑（比如返回上一页），可移除当前回调
                // this.remove();
            }
        };
        getOnBackPressedDispatcher().addCallback(this, backCallback);
    }
}

关键说明 #

• 构造参数 true 表示默认启用该回调，若需动态控制启用/禁用，可调用 backCallback.setEnabled(true/false)
• handleOnBackPressed() 方法就是原 onBackPressed() 的替代逻辑入口
• 如果需要在特定场景（比如弹窗显示时）屏蔽返回键，只需调用 backCallback.setEnabled(false) 即可

Fragment 中的实现 #

如果是在 Fragment 中处理返回键逻辑，可在 onViewCreated 中注册回调：

import androidx.activity.OnBackPressedCallback;
import androidx.fragment.app.Fragment;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

public class YourFragment extends Fragment {
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        return inflater.inflate(R.layout.your_fragment_layout, container, false);
    }

    @Override
    public void onViewCreated(View view, Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        
        OnBackPressedCallback backCallback = new OnBackPressedCallback(true) {
            @Override
            public void handleOnBackPressed() {
                // Fragment 内的返回逻辑处理
            }
        };
        // 使用 getViewLifecycleOwner() 绑定回调生命周期，避免内存泄漏
        requireActivity().getOnBackPressedDispatcher().addCallback(getViewLifecycleOwner(), backCallback);
    }
}

内容的提问来源于stack exchange，提问作者EyaqubAli