Android项目结构(翻译)

原文链接

项目概述

一个Android Studio的项目包含了一个应用的所有资源,包括源码、依赖资源、测试代码、build的配置等。创建一个新的项目,Android Studio创建了所有必要的文件并显示在左边的"Project"窗口里(点击View>Tool Windows>Project)。下面介绍了项目的核心组件。

Modules###

一个module是一个源文件和build的配置的集合,可以让你将项目分割成不同的功能模块。一个项目可以有一个或多个module,一个module可以依赖另一个module。每个module可以独立的build,测试,调试。

另外,module经常被用作项目的代码库,或者是不同设备如手机、手表等对应的不同的代码集合。需要注意的是要保证所有的的module在同一个项目下,且除了主module,其它module要被依赖且用到依赖里的代码或资源。

你可以点击File>New>New Module,在项目中添加一个新的module。

Android Studio提供了一些不同的module类型:

Android app module#####

为应用的源码、资源文件和app的设置层级例如:module-level的build文件、Android Manifest文件等提供一个容器。创建一个新的项目,默认的module名字是"app"。

在"Create New Module"窗口,Android Studio提供了下面的app module类型:

  • Phone & Table Module 手机、pad module
  • Android Wear Module 手表module
  • Android TV Module 电视module
  • Glass Module 眼镜module
    上面的每一种都提供一些适合对应的应用或设备类型的基本的文件和代码模板。

添加module的更多信息,阅读 Add a Module for a New Device

Library module#####

提供了一个可以复用的代码容器,可以作为其它项目的依赖或者从其它的项目中导入。"library module"和一个"app module"结构上相同,但当在build时,它创建的是代码归档文件而不是一个apk,所以不能被安装在设备上。

在"Create New Module"窗口,Android Studio提供了下面的library module:

  • Android Library:该类型包含一个Android项目支持的所有文件类型,包括源码、资源文件、清单文件等。Build的结果是一个归档文件(Android Archive file AAR),可以作为app module的依赖。
  • Java Library:该类型只包含java源文件。Build的结果是一个java归档文件(Java Archive file JAR),可以作为Android app module或java项目的依赖。
Google Cloud module#####

这种module提供一个谷歌云端后台代码库。它为简单使用HTTP的Java应用引擎、云端点和云信息提供了必要的代码和依赖来连接你的应用。你可以在后台开发来提供你的应用需要的云服务。

用Android Studio来创建开发Google Cloud module可以让你管理同一个项目的后台和应用的代码。你也可以在本地运行和测试后台代码。

查看添加Google Cloud module的更多信息 Adding an App Engine Java Servlet Module。查看更多的运行开发Google Cloud module查看Running, Testing, and Deploying the Backend

一些人把module作为子项目是可以的,因为Gradle也可以把module引用为工程。例如,当创建一个library module并把它作为app module的依赖时,你必须的build文件里声明:

dependencies {
  compile project(':my-library-module')
}

Android显示类型###

默认Android Studio显示项目文件以"Android"类型显示方式展示。它不会影响硬盘上实际的文件层级,但以module和文件类型的形式来简洁明了展示项目的核心文件,隐藏不常用的文件和文件夹。和物理实际的文件结构相比有下面一些变化:


ProjectStructure
  • 显示所有的工程的build-related的配置文件在一个顶层的Gradle Script组。
  • 将每个module的manifest文件展示在模块分组(不同的产品build类型有不同的清单文件)。
  • 将所有可选择性的资源文件放在一个单独的分组,替换掉分类文件夹的修饰符。例如,所有不同像素的应用icon可以并排显示。

每个Android的app module,文件按下面的分组显示:

manifests######

包含AndroidManifest文件。

java######

包含java的源码文件,按不同的包名划分,包好JUnit测试代码。

res######

包含所有的非代码资源,如xml layout,界面的strings,bitmap图片,按对应的子文件夹划分。更多的资源类型信息,查看Providing Resources

Android的Project类型视图###

查看项目的真实文件结构的所有文件,包括Android视图下隐藏的文件,选择在顶层的Project下拉框中选择Project类型。

ProjectView2

当你选择了Project视图,就可以看到更多的文件和文件夹。其中最终要的如下:

module-name/
    build/ 包含build的输出文件
    libs/ 包含私有的库
    src/ 包含所有的代码和相应模块下子文件下的所有资源文件
        androidTest/包含运行在Android设备上的测试代码。
        main/ 包含主要的代码集合:有Android代码和各种build变形共享的资源(其它build的变体文件在统计的目录下,比如src/debug/是调试build类型)
            AndroidManifest.xml 描述应用的特性和它的组件。
            java/ 包含Java代码。
            jni/ 包含用Java Native Interface(JNI)生成的原生代码。
            gen/ 包含Android Studio生成的Java文件,例如R.java文件和根据AIDL文件创建的接口等。
            res/ 包含应用的资源,比如drawable文件,layout文件,界面的string。
            assets/ 包含要被编译在.apk文件的资源文件。你可以用URI和通过AssetManager读取字节流文件的形式来使用这个文件夹下的资源。比如像游戏的数据、texture可以放在改目录下。
        test/ 包含运行在JVM上的本地测试代码。
    build.gradle(module) 定义了特定的module的build配置。
build.gradle(project) 定义了所有module的build的配置。这个文件是项目不可缺少的,所以应该保持该配置与所有源码的一致。

Project Structure Settings###

改变Android Studio项目的各种设置,可以点击File>Project Structure。它包含了下面的部分:

  • SDK Location: 设置项目的JDK, Android SDK, Android NDK的位置。
  • Project: 设置Gradle、Android plugin for Gradle的版本,库的名字。
  • Developer Services:包含从谷歌和其他第三方添加Android Studio add-in组件的设置。
  • Modules: 允许你编辑特定module的配置,包括目标、最小版本的SDK,应用的签名,依赖库等。
Developer Services#####

这部分包含应用使用的一些服务的配置页。包含下面一些部分:

  • AdMob:允许你打开谷歌的AdMob组件,帮助你了解用户并展示定性的广告。
  • Analytics:允许你打开谷歌的Analytics,帮助你观测应用在不同的设备环境上的用户交互情况。
  • Authentication:允许你使用谷歌账号登录应用。
  • Cloud:允许你为应用打开Firebase云基础服务。
  • Notifications:允许你使用谷歌云信息来实现应用与服务的交互。

应用中打开上面任一项服务会是Android Studio添加必要的依赖和权限。如果你想启动哪项服务,每个配置页面列出了这些和其它的Android Studio的行为配置。

Modules#####

可以在该部分改变项目中每个module的配置。每个module的设置页面包含下面的分类:

  • Properties:指定编译该module的SDK和build tools的版本。
  • Signing:指定应用的签名证书
  • Flavors: 创建多个build的偏好,每个偏好指定了一些列的配置设置,比如module的最小和目标SDK的版本、版本的名字、版本号。比如:可以设置偏好为minimun SDK=15,target SDK=21;另一个偏好设置为minimum SDK=19, target SDK=23。
  • Build Type:可以创建和修改build的配置。默认的每个module有debug和release的build类型,但你可以定义更多需要的。
  • Dependencies:列出该模块依赖的类库,文件和模块。你可以在改部分添加,修改、删除依赖。

查看更多资源信息###

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,569评论 25 707
  • afinalAfinal是一个android的ioc,orm框架 https://github.com/yangf...
    passiontim阅读 15,087评论 2 44
  • 这是一个阴阳鱼的图片,就像大家看到的一样,大体分为两部分,一条黑色一条白色,然后再黑色里边有一小部分白色在白色里边...
    小崽子阅读 257评论 0 2
  • 今天已经是我俩分别两个月的时间了,你也去到了另一个地方,开始了新的生活。夜也已经到了深夜,却通过窗前看着那一轮明月...
    一已陌生阅读 195评论 0 1
  • ❤14.对身体的姿势保持正念 这个方法可以在任何时间、任何地点练习。 先专注在呼吸上,比平常安静且深长地呼吸。 不...
    雅璇阅读 124评论 0 0