Android通知深层链接：如何优雅地实现基于用户登录状态的条件导航

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/homeFragment">

    <!-- 中间过渡Fragment，处理所有深层链接的入口 -->
    <fragment
        android:id="@+id/deepLinkHandlerFragment"
        android:name="com.example.yourapp.DeepLinkHandlerFragment"
        android:label="DeepLinkHandlerFragment"
        tools:layout="@layout/fragment_deep_link_handler">
        <!-- 如果需要，可以定义参数来接收原始深层链接的目标信息 -->
        <argument
            android:name="targetDestinationId"
            app:argType="integer"
            android:defaultValue="0" />
    </fragment>

    <!-- 登录Fragment -->
    <fragment
        android:id="@+id/loginFragment"
        android:name="com.example.yourapp.LoginFragment"
        android:label="LoginFragment"
        tools:layout="@layout/fragment_login" />

    <!-- 主页Fragment -->
    <fragment
        android:id="@+id/homeFragment"
        android:name="com.example.yourapp.HomeFragment"
        android:label="HomeFragment"
        tools:layout="@layout/fragment_home" />

    <!-- 示例内容Fragment，可能是通知最终想跳转到的地方 -->
    <fragment
        android:id="@+id/contentFragment"
        android:name="com.example.yourapp.ContentFragment"
        android:label="ContentFragment"
        tools:layout="@layout/fragment_content" />

    <!-- 其他Fragment... -->

</navigation>

import android.app.NotificationChannel
import android.app.NotificationManager
import android.app.PendingIntent
import android.content.Context
import android.os.Build
import android.os.Bundle
import androidx.core.app.NotificationCompat
import androidx.navigation.NavDeepLinkBuilder
import com.example.yourapp.R // 确保R文件路径正确

const val CHANNEL_ID = "my_app_channel"
const val NOTIFICATION_ID = 1

fun showNotification(context: Context) {
    // 创建通知渠道 (Android 8.0+)
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val name = "通用通知"
        val descriptionText = "应用通用通知渠道"
        val importance = NotificationManager.IMPORTANCE_DEFAULT
        val channel = NotificationChannel(CHANNEL_ID, name, importance).apply {
            description = descriptionText
        }
        val notificationManager: NotificationManager =
            context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }

    // 假设我们希望通知最终导航到 contentFragment
    // 我们将这个目标ID作为参数传递给 DeepLinkHandlerFragment
    val args = Bundle().apply {
        putInt("targetDestinationId", R.id.contentFragment)
    }

    // 创建 PendingIntent，指向中间过渡页面 deepLinkHandlerFragment
    val pendingIntent = NavDeepLinkBuilder(context)
        .setGraph(R.navigation.nav_graph)
        .setDestination(R.id.deepLinkHandlerFragment) // 指向中间过渡页面
        .setArguments(args) // 传递原始目标参数
        .createPendingIntent()

    // 构建并显示通知
    val notificationManager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
    val notification = NotificationCompat.Builder(context, CHANNEL_ID)
        .setContentTitle("新消息通知")
        .setContentText("您有一条新消息，点击查看详情。")
        .setSmallIcon(R.drawable.ic_notification) // 替换为你的通知图标
        .setContentIntent(pendingIntent) // 设置 PendingIntent
        .setAutoCancel(true) // 用户点击后自动清除通知
        .build()

    notificationManager.notify(NOTIFICATION_ID, notification)
}

import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import androidx.fragment.app.Fragment
import androidx.navigation.fragment.findNavController
import com.example.yourapp.R

class DeepLinkHandlerFragment : Fragment() {

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        // 这个Fragment通常不需要布局，因为它只负责逻辑处理
        return null
    }

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

        val navController = findNavController()

        // 模拟登录状态检查（实际应用中会从 ViewModel、Repository 或 SharedPreferences 获取）
        val isLoggedIn = checkIfUserIsLoggedIn()

        // 获取原始深层链接的目标ID
        val targetDestinationId = arguments?.getInt("targetDestinationId", R.id.homeFragment) ?: R.id.homeFragment

        if (isLoggedIn) {
            // 用户已登录，导航到原始目标页面
            navController.navigate(targetDestinationId)
        } else {
            // 用户未登录，导航到登录页面
            navController.navigate(R.id.loginFragment)
        }

        // 重要：在完成导航后，确保这个中间Fragment从返回栈中移除
        // 这样用户在目标页面点击返回时，不会回到这个中间处理Fragment
        // 这里使用 popUpTo 和 inclusive=true 来清除当前Fragment及其上的所有内容
        // 假设 nav_graph 的 startDestination 是 HomeFragment，我们 pop 到 HomeFragment
        navController.popBackStack(R.id.homeFragment, false) // 导航到 HomeFragment，并清除其上的所有内容

        // 或者，如果只是想移除当前的 DeepLinkHandlerFragment，可以使用：
        // navController.popBackStack()
        // 但如果目标Fragment在另一个分支，可能需要更复杂的 popUpTo 逻辑
    }

    /**
     * 模拟用户登录状态检查。
     * 在实际应用中，这会是一个异步操作，可能涉及网络请求或本地存储查询。
     */
    private fun checkIfUserIsLoggedIn(): Boolean {
        // TODO: 实现真实的登录状态检查逻辑
        // 例如：return UserRepository.getInstance(requireContext()).isLoggedIn()
        return true // 示例：假设用户已登录
    }
}