原生移动开发 / 知识点

Android 项目目录与文件用途速查

项目与 Gradle 配置

定义 Gradle 项目名称、参与构建的模块以及插件和依赖仓库配置;查看项目包含哪些 app、library 或 feature 模块时优先检查这里。

settings.gradle

settings.gradle 决定一次 Gradle 构建包含哪些模块,并可集中定义插件解析仓库和项目依赖仓库。遇到模块没有加入构建、插件找不到或仓库来源异常时,应优先核对这里,而不是先修改模块级 build.gradle。

怎么判读

线索 含义 建议动作
rootProject.name 根项目名称 核对是否与当前工程预期一致
include ':app' 将模块加入当前构建 模块目录存在但 Gradle 看不到时检查此项
pluginManagement 插件解析规则和仓库 插件 ID 或插件版本无法解析时检查
dependencyResolutionManagement 项目依赖仓库策略 Maven 依赖解析失败或仓库来源不一致时检查
repositoriesMode 约束模块是否可自行声明仓库 出现项目仓库被禁止等错误时核对策略

典型配置

下面是 Groovy DSL 的片段示例,假设工程确实存在 app 和 core 两个模块。

groovy
pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

rootProject.name = "SampleApp"
include ':app', ':core'

配置生效后,可直接让 Gradle 列出参与构建的项目:

bash
./gradlew projects

预期输出(关键行):

text
Root project 'SampleApp'
Project ':app'
Project ':core'
BUILD SUCCESSFUL

实际输出还会包含 Gradle 的说明文字,版本不同可能略有差异;关键是目标模块出现在项目列表中且构建配置阶段成功。

常见判读与动作

模块目录已经存在但 projects 中没有它,通常是缺少对应 include,或声明的项目路径与目录结构不一致。插件解析失败时重点查看 pluginManagement.repositories;普通库依赖下载失败时则查看 dependencyResolutionManagement.repositories,不要混淆两类仓库。

使用 FAIL_ON_PROJECT_REPOS 后,模块级脚本再声明仓库可能直接导致构建失败。这通常是集中管理仓库的预期效果,应优先删除重复的模块仓库声明,而不是随意放宽策略。

适用范围

以上写法针对 Groovy DSL 的 settings.gradle。Kotlin DSL 对应文件通常为 settings.gradle.kts,语法不同。较新的 Gradle 与 Android 工程常把插件管理、依赖仓库和版本目录入口集中到 Settings;旧工程则可能仍在根目录构建脚本中保留部分仓库配置,排查时应结合项目实际版本判断。

应用模块与源码

界面与资源文件

目录与阅读设置

记录一个想法

Android 项目目录与文件用途速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通