You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

新版Kotlin项目级Gradle中添加Navigation Safe Args的位置问题及官方文档适配疑问

解决新版Gradle项目中Navigation Safe Args插件的配置位置问题

嘿,我完全懂你的烦恼——新版Gradle的项目级配置文件格式变了,加上Android官网的文档有时候没及时跟上,确实容易懵。别急,我来给你捋清楚怎么弄:

首先,你完全可以把buildscript代码块直接和现有的plugins块放在同一个项目级Gradle文件里,顺序其实不影响,但通常大家会把buildscript放在最前面,这样逻辑更清晰。

给你一个完整的项目级配置示例:

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.4.2"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

plugins {
    id 'com.android.application' version '7.1.3' apply false
    id 'com.android.library' version '7.1.3' apply false
    id 'org.jetbrains.kotlin.android' version '1.6.21' apply false
}

配置完项目级文件后,别忘了在模块级的Gradle文件(就是app目录下的那个)里添加Safe Args的插件引用:

  • 如果你的项目是Kotlin语言,添加这个插件:
plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'androidx.navigation.safeargs.kotlin' // 新增这一行
}
  • 如果是Java语言,就换成:
id 'androidx.navigation.safeargs'

至于为什么官网没针对新版Gradle更新路径?其实新版Gradle支持两种插件引入方式,旧的buildscript和新的plugins块都能用。只是Navigation的Safe Args插件目前用buildscript的方式兼容性更稳定,所以很多教程还是沿用这种写法。

内容的提问来源于stack exchange,提问作者ckot

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.28 20:28:08