Android Studio应用指南

Android Studio应用指南

0、引言

本文转载自关于Android Studio,你需要知道的9件事

1、如何构建你的项目

点击Build然后选择Make Project,最后点击右下方的Gradle Console查看打印信息。

2、Gradle Tasks的使用

点击右侧的Gradle,依次展开项目名–>:app,可以查看所有的Gradle任务,比如双击assembleRelease,就可以执行此task。双击assemble,表示同时执行assembleDebugassembleRelease,会在目录app/build/apk/生成对应的debug和release的APK。

生成的APK命名规则:app-<flavor>-<buildtype>.apk; 比如: app-full-release.apkapp-demo-debug.apk.

也可以在左下角点击控制台进行相应的任务命令:比如输入gradle tasks命令可以查看所有的task、输入gradle build命令表示同时执行assemblecheck;同时命令还支持驼峰匹配:比如gradle aR等同于gradle assembleRelease

3、运行配置

点击Run选择Edit Configuration,展开Android Application,可以新建一个配置或者编辑一个现有的配置:可以配置是否自动启动默认Activity,启动特定Activity,部署目标是否手动选择,比如可以自动部署到USB(真机);模拟器网速控制:

网速规则如下所示:

1
None: no latency
2
GPRS: GPRS (min 150, max 550 milliseconds)
3
EDGE: EDGE/EGPRS (min 80, max 400 milliseconds)
4
UMTS: UMTS/3G (min 35, max 200 milliseconds)

同时可以配置模拟器启动时的额外命令行:

比如启动适配屏幕:-scale 96dpi;还有logcat配置:比如是否每次启动时自动清空。

4、运行

点击Run然后选择Run (或者 Run > debug)

此操作将经历三个主要步骤:编译项目—>创建一个默认运行配置(有则使用—>使用配置安装并运行。

如果是部署到真机需要注意:

  • build.gradle文件中配置 标签下:android:debuggable为true。(经过测试不配也行)
  • 在真机上启用USB debugging:
  • 如Android 3.2或更早:Settings > Applications > Development
  • 4.0或更新:Settings > Developer options
  • 4.2或更新的版本默认是隐藏的,需要前往 Settings > About phone点击Build number7下,返回上一个页面可见。

5、使用命令行

  • 构建一个debug版本
1
$ chmod +x gradlew(第一次执行需授权命令)
2
$ ./gradlew assembleDebug

构建完成后apk的位置:app/build/outputs/apk/。如果为库文件则lib/build/outputs/libs/

  • 构建一个release版本
1
$ ./gradlew assembleRelease

注意:此操作完成后还未进行签名,不能安装。接下来可用手动签名和zipalign,也可以利用build script配置自动签名和zipalign。

这里只介绍下自动签名:在build.gradle中添加storeFile, storePassword, keyAlias and keyPassword相关信息:

也可以在Project Structure—> Signing中进行配置,配置成功后会自动在build.gradle文件中生成相关信息。

再次assembleRelease,成功之后就会生成一个<your_module_name>-release.apk,此apk是签名并且zipalign处理过的。

最后使用命令:adb install <path_to_your_bin>.apk 就能安装到你的模拟器或者真机啦。

6、Gradle Build配置

gradle build配置是使用DSL(特定领域语言)Groovy来配置构建逻辑的。

我们主要是进行配置以下几个方面:

  • Build variants(暂且叫构建变体吧):使用此功能不必创建多个项目仅仅使用相同的module就能生成多个不同版本的APK,比如试用版和注册版。
  • Dependencies(依赖关系):可以使用本地库或者远程仓库来配置依赖关系。
  • Manifest entries(清单):可以生成多个比如不同版本号、项目名称等的APK。
  • Signing(签名):允许在构建APK的时候进行签名。
  • ProGuard(混淆):配置混淆。
  • Testing(测试):不用另外新建测试项目就能进行测试,非常的方便。

7、项目project与模块module

两者关系:一个项目有1个或多个模块组成,单个模块由源代码和资源组成,可以独立进行build、Test、debug。

关于模块,主要有以下几种:

  • Android应用程序模块Android application modules:主要的模块,可能是mobile, TV, Wear, Glass。
  • Android库模块Android library modules:包含一些可重用的源码和资源,构建程序会将之生成AAR (Android Archive)。
  • 应用引擎模块App Engine modules:包含APP集成引擎的代码和资源。
  • jar包Java library modules:包含一些可重用代码,构建程序将之生成jar包。
  • 一个项目有一个项目级别的build.gradle文件,此文件配置所有模块通用的配置,而每个模块都有自己的build.gradle文件来配置特有的设置。

关于这个项目级别的build.gradle:
默认项目会定义Gradle的仓库与依赖关系,支持的仓库包括 JCenter, Maven Central, 或者 Ivy.下面的例子说明了使用JCenter仓库、0.14.4版本的Gradle:

1
buildscript {
2
3
    repositories {
4
        jcenter()
5
    }
6
    dependencies {
7
        classpath ‘com.android.tools.build:gradle:0.14.4
8
9
        // NOTE: Do not place your application dependencies here: they belong
10
        // in the individual module build.gradle files
11
    }
12
}
13
14
allprojects {
15
    repositories {
16
        jcenter()
17
    }
18
}

注意:Android的SDK配置在 local.properties的sdk.dir属性中。

关于各个模块的build.gradle

主要会配置以下几个方面:

  • android settings:比如编译版本和构建工具版本。
  • defaultConfig and productFlavors:清单属性比如applicationId, minSdkVersion, targetSdkVersion等等。
  • buildTypes:构建属性比如是否可以debug、是否混淆等。
  • dependencies

下面是一个例子:

1
apply plugin:’com.android.application’
2
3
android {
4
    compileSdkVersion 20
5
    buildToolsVersion “20.0.0″
6
7
    defaultConfig {
8
        applicationId “com.mycompany.myapplication”
9
        minSdkVersion 13
10
        targetSdkVersion 20
11
        versionCode 1
12
        versionName “1.0″
13
    }
14
15
    buildTypes {
16
        release {
17
            minifyEnabled false
18
            proguardFiles getDefaultProguardFile(‘proguard-         android.txt’),’proguard-rules.pro’
19
        }
20
        debug {
21
            debuggable true
22
        }
23
    }
24
}
25
26
dependencies {
27
    compile fileTree(dir:’libs’, include:['*.jar'])
28
    compile ‘com.android.support:appcompat-v7:20.0.0′
29
    compile project(path:’:app2, configuration: ‘android-endpoints’)
30
}

8、关于dependencies

依赖关系支持三种:分别是模块依赖、本地二进制依赖、远程二进制依赖

远程依赖格式:group:name:version,比如:com.google.guava:guava:16.0.1

因此也可以写成compile group:’com.google.android’,name:’support-v4′,version:’r7′
模块依赖格式,比如:

1
MyProject/
2
+ app/
3
+ libraries/
4
+ lib1/
5
+ lib2/

则对应:

1
:app
2
:libraries:lib1
3
:libraries:lib2

然后在settings.gradle文件中则变成了:include ‘:app’, ‘:libraries:lib1′, ‘:libraries:lib2′

9、构建变体(build variant)

总的来说:Build Type + Product Flavor = Build Variant

每个生成的APK都是由一种构建变体决定的。一个构建变体由product flavors 和 build types决定;

Product flavors代表一个项目版本,这是你随便定义的,比如区分付费的版本还是免费的版本、是那个CPU类型的版本等等。

下面是一个例子:

1
2
...
3
4
android {
5
6
...
7
8
    defaultConfig { … }
9
    signingConfigs { … }
10
    buildTypes { … }
11
    productFlavors {
12
        demo {
13
            applicationId “com.buildsystemexample.app.demo”
14
            versionName “1.0-demo”
15
        }
16
        full {
17
            applicationId “com.buildsystemexample.app.full”
18
            versionName “1.0-full”
19
        }
20
    }
21
}
22
23

这里的applicationId代表不同的包名,因为要生成不同的APP。

Build types就是之前讲的,比如是debug还是release,一个build variant就是两者任意一种的组合。

默认的Android Studio定义了两种build types,没有product flavors。所以只有两种build variants:debug和release。然后构建系统根据每种变体生成对应的APK。

现在比如我们新增两种product flavors:demo和full,就应该有四种build variant:

demoDebug、demoRelease、fullDebug、fullRelease。

如果现在我们再加上一种product flavors:CPU/ABI类型,分别为x86、arm、mips,同理,那么我们就应该有12种build variant。

Android Studio为了共用代码,变体使用文件夹规则来合并成一种变体

关于变体合并优先级从低到高的顺序为:libraries/dependencies -> main src -> productFlavor -> buildType。

接下来说说源码文件夹的定义规则:

  • src/main/ – the main source directory (默认配置,所有变体通用)
  • src// – the source directory
  • src// – the source directory

比如:

1
src/main/ (default configuration)
2
src/release/ (build type)
3
src/demo/ (flavor – app type dimension)
4
src/arm/ (flavor – ABI dimension)

在每个源码文件夹里面我们可以使用相同的文件名,但是有个前提,就是这两个文件夹不会组合成一种变体。

构建程序还会将所有的manifests合并成一个manifests,所以最后的manifest定义了不同的components or permissions,manifest合并也有优先级,优先级从低到高的顺序为:libraries/dependencies -> main src -> productFlavor -> buildType。

这儿有个命令规则:

1
assemble<Variant Name>
2
assemble<Build Type Name>
3
assemble<Product Flavor Name>

执行上述命令可生成对应的变体APK。

  • 比如有两个product flavors:flavor1和flavor2,执行:assemble Flavor1 Debug生成对应的APK;
  • 给定Build Type执行assemble Debug:将生成Flavor1Debug和Flavor2Debug两个变体;
  • 给定flavor执行assemble Flavor1:生成Flavor1Debug和Flavor1Release两个变体。
Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×