缩减代码和资源(Shrink Your Code and Resources)

原文链接:https://developer.android.com/studio/build/shrink-code.html

一、代码缩减和资源缩减概述

为尽可能缩减apk包的大小,我们应该在release版本中移除未使用的代码和资源。这篇文档描述如何在构建过程中指定保留和移除的代码与资源。
代码缩减(Code shrinking)利用ProGuard ,它可以检测和移除app中没有使用的类、字段、方法和属性,包括来自代码库的那些。ProGuard还可以优化class文件,删除未使用的代码指令,并使用短名称来混淆类字段和方法。
资源缩减(Resource shrinking)可利用Gradle配置,它可以移除app中未使用的资源,包括代码库中未使用的资源。它与代码缩减一起工作,使得一旦未使用的代码被移除,任何不再被引用的资源也可以被安全地移除。
本文档中的功能依赖于:

二、代码缩减(Shrink Your Code)

1.启用代码缩减

要使用ProGuard启用代码缩减,请将minifyEnabled true添加到build.gradle文件中的相应build type。
注意,代码缩减会减慢构建时间,因此,尽量避免在dbeug版本上使用它。不过重要的是,必须在在启用代码缩减的apk上进行测试,因为如果没有足够自定义要保留的代码,它可能会引入错误。
代码缩减gradle配置示例:

android {
   buildTypes {
     release {
       minifyEnabled true
       proguardFiles getDefaultProguardFile(‘proguard-android.txt'),
'proguard-rules.pro'
     }
   }
}

除了指定minifyEnabled属性,proguardFiles属性还定义了ProGuard规则:

  • getDefaultProguardFile('proguard-android.txt')从SDK tools /proguard /下的proguard-android.txt设置默认的ProGuard设置。
    (备注:为更好地代码缩减,可以利用位于相同位置的proguard-android-optimize.txt文件。 它包括相同的ProGuard规则,但在执行分析字节码级别等方面进一步优化,可以更好地减少apk大小,并帮助它运行更快。)
  • proguard-rules.pro中可以添加自定义ProGuard规则。默认情况下,此文件位于module的根目录(在build.gradle文件旁边)。

我们也可以为不同的Variant指定不同的ProGuard规则:

android {
...
  buildTypes {
    release {
      minifyEnabled true
    proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
    }
  }
  productFlavors {
    flavor1 {
    }
    flavor2 {
      proguardFile 'flavor2-rules.pro'
    }
  }
}

项目构建后,在/build/outputs/mapping/release/下会生成几个文件:

  • dump.txt:apk文件中所有类文件间的内部结构
  • mapping.txt:混淆前后代码间的映射
  • seeds.txt:未被混淆的类和成员
  • usage.txt:未使用的、被apk删除的代码

2.定义保留哪些代码

大多数情况下,默认的ProGuard配置文件(proguard-android.txt)就足够了,ProGuard删除所有未使用的代码。然而,有些情况下,ProGuard很难正确分析,它可能会删除您的应用程序实际需要的代码。比如:

  • 当仅在AndroidManifest.xml文件中引用的类
  • 当从JNI调用方法时
  • 当在字节码中操作代码时(如使用反射)
    为修复错误并强制ProGuard保留某些代码,需要在ProGuard配置文件中添加一个-keep标记,比如:

-keep public class MyClass

或者,您可以将@Keep注释添加到要保留的代码。请注意,此注释仅在使用注释支持库时可用。
使用-keep选项时,您应该考虑许多因素;有关自定义配置文件的更多信息,请阅读 ProGuard手册

3.解析混淆后的堆栈跟踪(Stack trace)

ProGuard缩减代码后,读取堆栈跟踪是很困难的,因为方法名都被混淆处理了。幸运的是,ProGuard在构建过程中创建了mapping.txt作为混淆前后代码的映射。
由于mapping.txt在每次构建过程中会被重写,所以需要在每个版本对应的mapping.txt保存到对应的目录下。如果用户从旧版本app提交混淆的堆栈跟踪,我们就可以通过每个版本对应的mapping.txt,来调试问题。
当我们在应用商店发布app时,也可以将对应的mapping.txt提交上去,这样应用商店就可以将用户报告的问题中直接进行解析。
要将混淆的堆栈跟踪转换为可读的堆栈跟踪,请使用回溯脚本(Windows上为retrace.bat;Mac上为retrace.sh)。 它位于 / tools / proguard /目录中。该脚本采用mapping.txt文件和堆栈跟踪,产生一个新的、可读的堆栈跟踪。
使用retrace.bat的语法:

retrace.bat|retrace.sh [-verbose] mapping.txt []

例如:

retrace.bat -verbose mapping.txt obfuscated_trace.txt

三、资源缩减(Shrink Your Resources)

1.启用资源缩减

资源缩减必须与代码缩减相结合。代码缩减移除所有未使用的代码后,资源缩减器可以识别应用程序仍在使用哪些资源。 未被使用的资源,将会被资源缩减器移除。
为使用资源缩减,需要在gradle文件中设置shrinkResources属性,例如:

android {
...
  buildTypes {
    release {
      shrinkResources true
      minifyEnabled true
      proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
    }
  }
}

注意,资源缩减不会移除value文件下的资源(比如strings, dimensions, styles, and colors),aapt不允许gradle这样做。

2.指定保留哪些资源

对于一些你希望保留或移除的资源,可以创建一个xml文件,以resource为标签,通过tools:keeptools:discard指定要保留和要移除的资源,多个资源之间以逗号分隔。例如:

tools:keep="@layout/l_used*_c,@layout/l_used_a,@layout/l_used_b*"
tools:discard="@layout/unused2" />

将此文件保存在项目资源中,比如res/raw/keep.xml,构建时不会将该文件打包到apk中。
指定要移除的资源,比起来直接删除掉,似乎有些傻。但是,对于构建多个Variant,却是很有用的。我们可以为不同的变体指定不同的keep.xml。

3.启用严格引用检查

通常,资源缩减器能够判断出指定资源是否被使用。但是,如果你的代码调用了Resources.getIdentifier()(或者你的库中的任何一个,比如AppCompat库),这意味着你的代码是基于动态生成的字符串查找资源名称。这样操作时,资源缩小器默认情况下会防御性地运行,并将匹配名称格式的所有资源标记为可能已使用而不会去移除。
例如,以下代码会将所有带有img_前缀的资源标记为已使用。

String name = String.format("img_%1d", angle + 1);
res = getResources().getIdentifier(name, "drawable", getPackageName());

资源缩小器还查看代码中的所有字符串常量以及各种res / raw /资源,以类似于file:///android_res/drawable//ic_plus_anim_016.png的格式查找资源url。如果它发现类似这样的字符串或其他,也不会移除它们。
这些是默认情况下启用的安全缩减模式的示例。但是,当不关注#“better safe than sorry”#时,可以指定资源缩减器仅保留其确定使用的资源。为此,请在keep.xml文件中将shrinkMode设置为strict,如下所示:

tools:shrinkMode="strict" />

如果您启用了严格缩减模式,并且您的代码还引用了具有动态生成的字符串的资源,那么您必须使通过tools:keep手动保留这些资源。

4.移除带有选择性的资源

资源缩减器只会移除没有在代码中被引用的资源,这也意味着,它不会移除那些为不同设备配置的带有选择性质的资源。必要的情况下,可以利用resConfigs属性移除这些资源。
例如,如果您使用的库包含语言资源,则apk会包含这些库中的所有翻译语言字符串。如果您只想保留指定的语言,可以使用resConfig属性进行指定,并将删除未指定语言的任何资源。
以下代码段显示了如何将语言资源仅限英语和法语:

android {
  defaultConfig {
  ... ...
    resConfigs“en”,“fr”
  }
}

同样,您可以自定义要在apk中包含哪些屏幕密度或ABI资源,并为不同设备构建不同的apk。

5.合并重复的资源

这里的合并英文为merge,带有解决冲突的意思。
默认情况下,gradle会合并相同名称的资源,例如可能在不同资源文件夹中具有相同名称的drawable。 此行为不受shrinkResources属性控制,不能禁用,因为必须避免在多个资源与代码查找的名称匹配时出现错误。
仅当两个或多个文件共享相同的资源名称时,才会进行资源合并。gradle选择哪个文件被认为是重复项中的最佳选择(基于下面描述的优先级顺序),并且仅将那个资源传递给aapt以在apk中分发。
gradle在以下位置查找重复的资源:

  • main resources,与主源集相关,一般位于src / main / res /。
  • 变体覆盖,从the build type和build flavors。
  • 库项目依赖项。
    gradle在以下优先级顺序中合并重复资源:

Dependencies→Main→Build flavor→Build type

例如,如果重复资源出现在main resources和build flavor,gradle会选择build flavor中的。

6.资源合并描述文件

当缩减资源时,Gradle Console会显示从应用程序包中删除的资源的摘要。例如:

:android:shrinkDebugResources
Removed unused resources: Binary resource data reduced from 2570KB to 1711KB: Removed 33%
:android:validateDebugSigning

gradle还会在/build/outputs/mapping/release/创建一个文件resources.txt,来描述哪些资源被引用和被移除。

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

推荐阅读更多精彩内容