devbox
笔触狂放9
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

Gradle版本目录(Version Catalog)

作者：笔触狂放9 | 2024-05-22 13:19:30

赞

踩

gradle版本

Gradle版本目录(Version Catalog)

“版本目录是一份依赖项列表，以依赖坐标表示，用户在构建脚本中声明依赖项时可以从中选择。”

我们可以使用版本目录将所有依赖项声明及其版本号保存在单个位置。这样，我们可以轻松地在模块和项目之间共享依赖项和版本配置列表。

有了IDE插件支持，将依赖项导入到我们的项目中会更容易，因为它提供了基于我们在版本目录中定义的内容的自动完成功能。

最好的方式是创建一个TOML（Tom's Obvious Minimal Language）文件作为其可移植性。请注意，此TOML文件不是唯一的真相来源，因为我们始终可以在脚本的不同位置硬编码其他依赖项和版本，而IDE不会强制将所有内容保存在版本目录中。

创建版本目录只需要几个步骤。大部分的工作将花在准备TOML文件上，这取决于我们在项目中所拥有的依赖项。

启用版本目录(Version catalog)

gradle 7.4 版本中的版本编目是稳定的，当使用 7.4+ 版本时，此步骤不是必需的。

升级 Gradle 运行./gradlew wrapper --gradle-version=7.6以将项目更新到 7.6 版本。

在旧版 Gradle 上使用 enableFeaturePreview 请注意，在 Gradle 8.0+ 上不再需要 enableFeaturePreview。

在settings.gradle或 settings.gradle.kts 中进行更改：

Kotlin DSL

  1. enableFeaturePreview("VERSION_CATALOGS")
  2. include(":app")

Groovy

  1. enableFeaturePreview("VERSION_CATALOGS")
  2. include ':app'

获取版本目录(Version catalog)

同样的语法，再次将其添加到相同的settings.gradle或settings.gradle.kts中。

  1. dependencyResolutionManagement {
  2.     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  3.     repositories {
  4.         google()
  5.         mavenCentral()
  6.     }
  7. }

在 libs.versions.toml 文件中声明依赖项

  • • 创建gradle/libs.versions.toml文件

  • • 值得注意的是，要检查您的 .gitignore 文件是否忽略了 /gradle/ 目录，以便您的版本库会保留lib.versions.toml文件。

  • • Android Studio 应该已经捆绑了 Toml 插件；对于 IntelliJ IDEA，您可以双重检查以确保您已经为扩展 IDE 支持安装了该插件。

我的样例libs.versions.toml文件 是一个早期版本，需要继续完善。请注意，文件中包含以下四个部分：

  • • versions

  • • libraries

  • • plugins

  • • bundles

同时需要注意的是，如果名称中有“-”，在Gradle构建脚本中引用时必须将其改成“.”。例如，如果我们定义了hilt-android，那么在调用时它将变成libs.hilt.android。

  1. [versions]
  2. # Define the dependency versions
  3. minSdk = "26"
  4. targetSdk = "33"
  5. compileSdk = "33"
  6.  
  7. accompanist = "0.27.0"
  8. androidx-activity-compose = "1.6.1"
  9. androidx-compose-bom = "2022.11.00"
  10. androidx-core-ktx = "1.9.0"
  11. androidx-lifecycle-runtime-compose = "2.6.0-alpha03"
  12. androidx-navigation-compose = "2.5.3"
  13. coil = "2.2.2"
  14. compose-compiler = "1.3.2"
  15. coroutines = "1.6.4"
  16. espresso = "3.5.0"
  17. gradle-plugin = "7.2.2"
  18. androidBuildTools = "7.2.2"
  19. hilt = "2.44.1"
  20. hilt-navigation-compose = "1.0.0"
  21. junit = "4.13.2"
  22. kotest = "5.5.4"
  23. kotlin = "1.7.20"
  24. kotlinx-serialization-json = "1.4.1"
  25. kover = "0.5.0"
  26. ktlint = "11.0.0"
  27. ktlint-plugin = "7.1.0"
  28. ktor = "2.1.3"
  29. leakcanary = "2.10"
  30. mockk = "1.13.2"
  31. room = "2.4.3"
  32. test-rules = "1.5.0"
  33. text-ext = "1.1.4"
  34. timber = "5.0.1"
  35.  
  36. [libraries]
  37. kotlin-gradlePlugin = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", version.ref = "kotlin" }
  38. android-gradlePlugin = { module = "com.android.tools.build:gradle", version.ref = "androidBuildTools"}
  39.  
  40. androidx-core-ktx = { module = "androidx.core:core-ktx", version.ref = "androidx-core-ktx" }
  41. androidx-lifecycle-runtime-compose = { module = "androidx.lifecycle:lifecycle-runtime-compose", version.ref = "androidx-lifecycle-runtime-compose" }
  42. androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "androidx-activity-compose" }
  43. androidx-navigation-compose = { module = "androidx.navigation:navigation-compose", version.ref = "androidx-navigation-compose" }
  44.  
  45. androidx-room-compiler = { module = "androidx.room:room-compiler", version.ref = "room" } # kapt
  46. androidx-room-runtime = { module = "androidx.room:room-runtime", version.ref = "room" }
  47. androidx-room-ktx = { module = "androidx.room:room-ktx", version.ref = "room" }
  48. androidx-room-testing = { module = "androidx.room:room-testing", version.ref = "room" }
  49.  
  50. junit = { module = "junit:junit", version.ref = "junit" }
  51. androidx-test-junit4 = { module = "androidx.test.ext:junit", version.ref = "text-ext" }
  52. androidx-test-rules = { module = "androidx.test:rules", version.ref = "test-rules" }
  53. androidx-test-espresso-core = { module = "androidx.test.espresso:espresso-core", version.ref = "espresso" }
  54. androidx-test-espresso-idling-resource = { module = "androidx.test.espresso:espresso-idling-resource", version.ref = "espresso" }
  55.  
  56. androidx-compose-bom = { module = "androidx.compose:compose-bom", version.ref = "androidx-compose-bom" }
  57. androidx-compose-material = { module = "androidx.compose.material:material" }
  58. androidx-compose-ui-tooling-preview = { module = "androidx.compose.ui:ui-tooling-preview" }
  59. androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
  60. androidx-compose-ui-test-junit4 = { module = "androidx.compose.ui:ui-test-junit4" }
  61. androidx-compose-ui-test-manifest = { module = "androidx.compose.ui:ui-test-manifest" }
  62.  
  63. timber = { module = "com.jakewharton.timber:timber", version.ref = "timber" }
  64.  
  65. coil-kt = { module = "io.coil-kt:coil", version.ref = "coil" }
  66. coil-kt-compose = { module = "io.coil-kt:coil-compose", version.ref = "coil" }
  67.  
  68. kotlin-reflect = { module = "org.jetbrains.kotlin:kotlin-reflect", version.ref = "kotlin" }
  69.  
  70. kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" }
  71. kotlinx-coroutines-android = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-android", version.ref = "coroutines" }
  72. kotlinx-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinx-serialization-json" }
  73.  
  74. kotest-runner-junit5 = { module = "io.kotest:kotest-runner-junit5", version.ref = "kotest" }
  75. kotest-assertions-core = { module = "io.kotest:kotest-assertions-core", version.ref = "kotest" }
  76. kotest-property = { module = "io.kotest:kotest-property", version.ref = "kotest" }
  77.  
  78. ktor-client-android = { module = "io.ktor:ktor-client-android", version.ref = "ktor" }
  79. ktor-client-serialization = { module = "io.ktor:ktor-client-serialization", version.ref = "ktor" }
  80. ktor-client-cio = { module = "io.ktor:ktor-client-cio", version.ref = "ktor" }
  81. ktor-client-content-negotiation = { module = "io.ktor:ktor-client-content-negotiation", version.ref = "ktor" }
  82. ktor-client-logging-jvm = { module = "io.ktor:ktor-client-logging-jvm", version.ref = "ktor" }
  83. ktor-serialization-kotlinx-json = { module = "io.ktor:ktor-serialization-kotlinx-json", version.ref = "ktor" }
  84. ktor-client-mock = { module = "io.ktor:ktor-client-mock", version.ref = "ktor" }
  85.  
  86. hilt-android = { module = "com.google.dagger:hilt-android", version.ref = "hilt" }
  87. hilt-compiler = { module = "com.google.dagger:hilt-compiler", version.ref = "hilt" }
  88. hilt-navigation-compose = { module = "androidx.hilt:hilt-navigation-compose", version.ref = "hilt-navigation-compose" }
  89. hilt-android-compiler = { module = "com.google.dagger:hilt-android-compiler", version.ref = "hilt" }
  90. hilt-android-testing = { module = "com.google.dagger:hilt-android-testing", version.ref = "hilt" }
  91.  
  92. mockk = { module = "io.mockk:mockk", version.ref = "mockk" }
  93. mockk-agent-jvm = { module = "io.mockk:mockk-agent-jvm", version.ref = "mockk" }
  94. mockk-android = { module = "io.mockk:mockk-android", version.ref = "mockk" }
  95. accompanist-webview = { module = "com.google.accompanist:accompanist-webview", version.ref = "accompanist" }
  96. accompanist-swiperefresh = { module = "com.google.accompanist:accompanist-swiperefresh", version.ref = "accompanist" }
  97. leakcanary-android = { module = "com.squareup.leakcanary:leakcanary-android", version.ref = "leakcanary" }
  98. ktlint-gradle = { module = "org.jlleitschuh.gradle:ktlint-gradle", version.ref = "ktlint" }
  99.  
  100. [bundles]
  101. # Define bundles/groups of libraries
  102. coil = ["coil-kt", "coil-kt-compose"]
  103. room = ["androidx-room-ktx", "androidx-room-runtime"]
  104. kotest = ["kotest-runner-junit5", "kotest-assertions-core", "kotest-property"]
  105. ktor = ["ktor-client-android", "ktor-client-serialization", "ktor-client-cio", "ktor-client-content-negotiation", "ktor-client-logging-jvm", "ktor-serialization-kotlinx-json"]
  106. coroutines = ["kotlinx-coroutines-core", "kotlinx-coroutines-android"]
  107.  
  108. [plugins]
  109. # android-application = { id = "com.android.application", version.ref = "gradle-plugin" }
  110. kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
  111. hilt-android-plugin = { id = "com.google.dagger.hilt.android", version.ref = "hilt" }
  112. kover-plugin = { id = "org.jetbrains.kotlinx.kover", version.ref = "kover" }
  113. kotlin-kapt = { id = "org.jetbrains.kotlin.kapt", version.ref = "kotlin" }
  114. kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
  115. android-library = { id = "com.android.library", version.ref = "gradle-plugin" }
  116. ktlint = { id = "org.jlleitschuh.gradle.ktlint", version.ref = "ktlint-plugin" }

更新依赖

  1. // change from
  2.     implementation 'com.google.dagger:hilt-android:2.43.2'
  3.     kapt 'com.google.dagger:hilt-compiler:2.43.2'
  4.  
  5. // change to
  6.     implementation libs.hilt.android
  7.     kapt libs.hilt.complier

扩展用法

我们还可以将minSdk和targetSdk移动到版本目录中。

Groovy

https://docs.gradle.org/7.0/userguide/platforms.html#sub:central-declaration-of-dependencies https://proandroiddev.com/gradle-version-catalogs-for-an-awesome-dependency-management-f2ba700ff894 https://umang91.medium.com/integrating-a-version-catalog-c5c7d45516db

转自：Gradle版本目录(Version Catalog)

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/笔触狂放9/article/detail/608473
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号