Android Studio Giraffe中Navigation Argument名标红但运行正常问题求助

问题描述 #

使用Android Studio Giraffe版本开发时，在导航图XML的<argument>标签中设置android:name属性时，属性值会被标红，错误提示为“'firstName' 不是argument标签的有效目标”。尝试更换其他名称仍会出现相同错误，但XML文件顶部显示无语法问题，且编译后模拟器运行完全正常。此前为解决Navigation仓库问题升级至该版本，推测此问题为Android Studio的UI检测bug。

提供的项目配置 #

项目级build.gradle.kts

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.6.0"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

plugins {
    id("com.android.application") version "8.1.0" apply false
    id("org.jetbrains.kotlin.android") version "1.8.0" apply false
}

App级build.gradle.kts

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    //id("androidx.navigation.safeargs")
    id("androidx.navigation.safeargs.kotlin")
}

android {
    namespace = "com.example.e12s02_navigationcomponent"
    compileSdk = 33

    defaultConfig {
        applicationId = "com.example.e12s02_navigationcomponent"
        minSdk = 24
        targetSdk = 33
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {

    implementation("androidx.core:core-ktx:1.10.1")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.9.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")

    //Navigation Component
    implementation("androidx.navigation:navigation-fragment-ktx:2.6.0")
    implementation("androidx.navigation:navigation-ui-ktx:2.6.0")
}

导航图main_nav.xml

<?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/main_nav_graph"
    app:startDestination="@id/firstFragment">

    <fragment
        android:id="@+id/firstFragment"
        android:name="com.example.e12s02_navigationcomponent.FirstFragment"
        android:label="fragment_first"
        tools:layout="@layout/fragment_first" >
        <action
            android:id="@+id/action_firstFragment_to_secondFragment"
            app:destination="@id/secondFragment" />
    </fragment>
    <fragment
        android:id="@+id/secondFragment"
        android:name="com.example.e12s02_navigationcomponent.SecondFragment"
        android:label="fragment_second"
        tools:layout="@layout/fragment_second" >
        <action
            android:id="@+id/action_secondFragment_to_firstFragment"
            app:destination="@id/firstFragment" />
        <argument
            android:name="firstName"
            app:argType="string" />
    </fragment>
</navigation>

解决建议 #

• 清理缓存并重启AS：点击File → Invalidate Caches...，勾选Invalidate and Restart，等待AS重启并重新索引项目。这是解决AS UI层面误报最直接的方法。
• 升级Navigation组件版本：当前使用的Navigation 2.6.0与Android Studio Giraffe（AGP 8.1.0）兼容性可能存在问题，建议将nav_version升级至2.7.5或更高版本，同步项目后验证问题是否消失。
• 检查XML命名空间：确认导航图根标签的android和app命名空间是否完整，缺失命名空间可能导致语法检测异常。
• 临时禁用对应Lint规则：若以上方法无效，可在app级build.gradle.kts的android块中添加以下代码关闭误报的Lint检查：

  lint {
      disable "InvalidNavigation"
  }
  

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