缩减代码和资源（Shrink Your Code and Resources）

   <h2><strong>一、代码缩减和资源缩减概述</strong></h2>    <p>为尽可能缩减apk包的大小，我们应该在release版本中移除未使用的代码和资源。这篇文档描述如何在构建过程中指定保留和移除的代码与资源。</p>    <p>代码缩减（Code shrinking）利用 <em>ProGuard</em> ，它可以检测和移除app中没有使用的类、字段、方法和属性，包括来自代码库的那些。ProGuard还可以优化class文件，删除未使用的代码指令，并使用短名称来混淆类字段和方法。</p>    <p>资源缩减（Resource shrinking）可利用Gradle配置，它可以移除app中未使用的资源，包括代码库中未使用的资源。它与代码缩减一起工作，使得一旦未使用的代码被移除，任何不再被引用的资源也可以被安全地移除。</p>    <h2><strong>二、代码缩减（Shrink Your Code）</strong></h2>    <h3><strong>1.启用代码缩减</strong></h3>    <p>要使用ProGuard启用代码缩减，请将 <em>minifyEnabled true</em> 添加到build.gradle文件中的相应build type。</p>    <p>注意，代码缩减会减慢构建时间，因此，尽量避免在dbeug版本上使用它。不过重要的是，必须在在启用代码缩减的apk上进行测试，因为如果没有足够自定义要保留的代码，它可能会引入错误。</p>    <p>代码缩减gradle配置示例：</p>    <pre>  <code class="language-java">android {      buildTypes {        release {          minifyEnabled true          proguardFiles getDefaultProguardFile(‘proguard-android.txt'),  'proguard-rules.pro'        }      }  }</code></pre>    <p>除了指定minifyEnabled属性，proguardFiles属性还定义了ProGuard规则：</p>    <ul>     <li><em>getDefaultProguardFile（'proguard-android.txt'）</em> 从SDK tools /proguard /下的proguard-android.txt设置默认的ProGuard设置。<br> （备注：为更好地代码缩减，可以利用位于相同位置的 <em>proguard-android-optimize.txt</em> 文件。 它包括相同的ProGuard规则，但在执行分析字节码级别等方面进一步优化，可以更好地减少apk大小，并帮助它运行更快。）</li>     <li><em>proguard-rules.pro</em> 中可以添加自定义ProGuard规则。默认情况下，此文件位于module的根目录（在build.gradle文件旁边）。</li>    </ul>    <p>我们也可以为不同的Variant指定不同的ProGuard规则：</p>    <pre>  <code class="language-java">android {  ...    buildTypes {      release {        minifyEnabled true      proguardFiles getDefaultProguardFile('proguard-android.txt'),  'proguard-rules.pro'      }    }    productFlavors {      flavor1 {      }      flavor2 {        proguardFile 'flavor2-rules.pro'      }    }  }</code></pre>    <p>项目构建后，在/build/outputs/mapping/release/下会生成几个文件：</p>    <ul>     <li>dump.txt：apk文件中所有类文件间的内部结构</li>     <li>mapping.txt：混淆前后代码间的映射</li>     <li>seeds.txt：未被混淆的类和成员</li>     <li>usage.txt：未使用的、被apk删除的代码</li>    </ul>    <h3><strong>2.定义保留哪些代码</strong></h3>    <p>大多数情况下，默认的ProGuard配置文件（proguard-android.txt）就足够了，ProGuard删除所有未使用的代码。然而，有些情况下，ProGuard很难正确分析，它可能会删除您的应用程序实际需要的代码。比如：</p>    <ul>     <li>当仅在AndroidManifest.xml文件中引用的类</li>     <li>当从JNI调用方法时</li>     <li>当在字节码中操作代码时（如使用反射）<br> 为修复错误并强制ProGuard保留某些代码，需要在ProGuard配置文件中添加一个 <em>-keep</em> 标记，比如： <p>-keep public class MyClass</p> </li>    </ul>    <p>或者，您可以将 @Keep 注释添加到要保留的代码。请注意，此注释仅在使用注释支持库时可用。</p>    <p>使用-keep选项时，您应该考虑许多因素;</p>    <h3><strong>3.解析混淆后的堆栈跟踪（Stack trace）</strong></h3>    <p>ProGuard缩减代码后，读取堆栈跟踪是很困难的，因为方法名都被混淆处理了。幸运的是，ProGuard在构建过程中创建了mapping.txt作为混淆前后代码的映射。</p>    <p>由于mapping.txt在每次构建过程中会被重写，所以需要在每个版本对应的mapping.txt保存到对应的目录下。如果用户从旧版本app提交混淆的堆栈跟踪，我们就可以通过每个版本对应的mapping.txt，来调试问题。</p>    <p>当我们在应用商店发布app时，也可以将对应的mapping.txt提交上去，这样应用商店就可以将用户报告的问题中直接进行解析。</p>    <p>要将混淆的堆栈跟踪转换为可读的堆栈跟踪，请使用回溯脚本（Windows上为 <em>retrace.bat</em> ;Mac上为retrace.sh）。 它位于 / tools / proguard /目录中。该脚本采用mapping.txt文件和堆栈跟踪，产生一个新的、可读的堆栈跟踪。</p>    <p>使用retrace.bat的语法：</p>    <p>retrace.bat|retrace.sh [-verbose] mapping.txt []</p>    <p>例如：</p>    <p>retrace.bat -verbose mapping.txt obfuscated_trace.txt</p>    <h2><strong>三、资源缩减（Shrink Your Resources）</strong></h2>    <h3><strong>1.启用资源缩减</strong></h3>    <p>资源缩减必须与代码缩减相结合。代码缩减移除所有未使用的代码后，资源缩减器可以识别应用程序仍在使用哪些资源。 未被使用的资源，将会被资源缩减器移除。</p>    <p>为使用资源缩减，需要在gradle文件中设置 shrinkResources 属性，例如：</p>    <pre>  <code class="language-java">android {  ...    buildTypes {      release {        shrinkResources true        minifyEnabled true        proguardFiles getDefaultProguardFile('proguard-android.txt'),  'proguard-rules.pro'      }    }  }</code></pre>    <p>注意，资源缩减不会移除value文件下的资源（比如strings, dimensions, styles, and colors），aapt不允许gradle这样做。</p>    <h3><strong>2.指定保留哪些资源</strong></h3>    <p>对于一些你希望保留或移除的资源，可以创建一个xml文件，以resource为标签，通过 <em>tools:keep</em> 和 <em>tools:discard</em> 指定要保留和要移除的资源，多个资源之间以逗号分隔。例如：</p>    <pre>  <code class="language-java">tools:keep="@layout/l_used*_c,@layout/l_used_a,@layout/l_used_b*"  tools:discard="@layout/unused2" /></code></pre>    <p>将此文件保存在项目资源中，比如res/raw/keep.xml，构建时不会将该文件打包到apk中。</p>    <p>指定要移除的资源，比起来直接删除掉，似乎有些傻。但是，对于构建多个Variant，却是很有用的。我们可以为不同的变体指定不同的keep.xml。</p>    <h3><strong>3.启用严格引用检查</strong></h3>    <p>通常，资源缩减器能够判断出指定资源是否被使用。但是，如果你的代码调用了Resources.getIdentifier()（或者你的库中的任何一个，比如AppCompat库），这意味着你的代码是基于动态生成的字符串查找资源名称。这样操作时，资源缩小器默认情况下会防御性地运行，并将匹配名称格式的所有资源标记为可能已使用而不会去移除。</p>    <p>例如，以下代码会将所有带有img_前缀的资源标记为已使用。</p>    <pre>  <code class="language-java">String name = String.format("img_%1d", angle + 1);  res = getResources().getIdentifier(name, "drawable", getPackageName());</code></pre>    <p>资源缩小器还查看代码中的所有字符串常量以及各种res / raw /资源，以类似于file：///android_res/drawable//ic_plus_anim_016.png的格式查找资源url。如果它发现类似这样的字符串或其他，也不会移除它们。</p>    <p>这些是默认情况下启用的安全缩减模式的示例。但是，当不关注#“better safe than sorry”#时，可以指定资源缩减器仅保留其确定使用的资源。为此，请在keep.xml文件中将shrinkMode设置为strict，如下所示：</p>    <p>tools:shrinkMode="strict" /></p>    <p>如果您启用了严格缩减模式，并且您的代码还引用了具有动态生成的字符串的资源，那么您必须使通过tools:keep手动保留这些资源。</p>    <h3><strong>4.移除带有选择性的资源</strong></h3>    <p>资源缩减器只会移除没有在代码中被引用的资源，这也意味着，它不会移除那些为不同设备配置的带有选择性质的资源。必要的情况下，可以利用 <em>resConfigs</em> 属性移除这些资源。</p>    <p>例如，如果您使用的库包含语言资源，则apk会包含这些库中的所有翻译语言字符串。如果您只想保留指定的语言，可以使用resConfig属性进行指定，并将删除未指定语言的任何资源。</p>    <p>以下代码段显示了如何将语言资源仅限英语和法语：</p>    <pre>  <code class="language-java">android {    defaultConfig {    ... ...      resConfigs“en”，“fr”    }  }</code></pre>    <p>同样，您可以自定义要在apk中包含哪些屏幕密度或ABI资源，并为不同设备构建不同的apk。</p>    <h3><strong>5.合并重复的资源</strong></h3>    <p>这里的合并英文为 <em>merge</em> ，带有解决冲突的意思。</p>    <p>默认情况下，gradle会合并相同名称的资源，例如可能在不同资源文件夹中具有相同名称的drawable。 此行为不受shrinkResources属性控制，不能禁用，因为必须避免在多个资源与代码查找的名称匹配时出现错误。</p>    <p>仅当两个或多个文件共享相同的资源名称时，才会进行资源合并。gradle选择哪个文件被认为是重复项中的最佳选择（基于下面描述的优先级顺序），并且仅将那个资源传递给aapt以在apk中分发。</p>    <p>gradle在以下位置查找重复的资源：</p>    <ul>     <li>main resources，与主源集相关，一般位于src / main / res /。</li>     <li>变体覆盖，从the build type和build flavors。</li>     <li>库项目依赖项。<br> gradle在以下优先级顺序中合并重复资源： <p>Dependencies→Main→Build flavor→Build type</p> </li>    </ul>    <p>例如，如果重复资源出现在main resources和build flavor,gradle会选择build flavor中的。</p>    <h3><strong>6.资源合并描述文件</strong></h3>    <p>当缩减资源时，Gradle Console会显示从应用程序包中删除的资源的摘要。例如：</p>    <pre>  <code class="language-java">:android:shrinkDebugResources  Removed unused resources: Binary resource data reduced from 2570KB to 1711KB: Removed 33%  :android:validateDebugSigning</code></pre>    <p>gradle还会在/build/outputs/mapping/release/创建一个文件 <em>resources.txt</em> ，来描述哪些资源被引用和被移除。</p>    <p> </p>    <p>来自：http://www.jianshu.com/p/46560895b42c</p>    <p> </p>