混淆技术研究笔记（二）yGuard入门

yGuard部分通过定义要处理的jar包，in是输入，out是输出，这两个名字可以一样，相当于会覆盖。可以配置多个，但是maven执行的机制导致这里能被有效混淆的只能有1个，后续实现的多模块混淆是利用了Maven生命周期的一些特点实现的。

部分是外部 jar 依赖，运行时用到的可以配置到这里，可以一个个指定，也可以像上面文档直接指定 maven 的运行时类路径。

是本系列的重点，上面示例中使用的 配置具体的混淆规则，混淆规则中主要使用 配置，一般情况下不需要细致的具体的方法进行配置，通过 的属性配置一般的通用规则即可。

针对 元素的 classes，methods，fields 三个属性，遵循以下表格的规则（-代表被混淆，*代表保留）。

例如当配置 classes="public" 时，所有 public class XXX 会保持原样，其他类型的会被混淆，当 classes="private 时，所有类名都会保留，方法和字段也是类似的，上面示例中 ，相当于类名、方法、字段全部被混淆，都不被保留。

上面配置 时，包名最后的 . 必须包含，你还可以使用 ant 中的 * 和 ** 匹配单级或多级，通过 ? 匹配单个字符。

可以配置很多个：

<class classes="none" methods="none" fields="none">
    <patternset>
        <include name="org.example."/>
        <include name="org.example.c.util.FileUtil"/>
    patternset>
class>
<class classes="private" methods="private" fields="private">
    <patternset>
        <include name="org.example.c."/>
    patternset>
class>
1
2
3
4
5
6
7
8
9
10
11

上面相当于两部分规则，第一部分是完全混淆的代码，第二部分是完全保留的代码，当配置多块时， 部分配置的类不能重叠。上面部分配置中存在重叠的部分，首先 org.example. 包含了 org.example.c. 和 org.example.c.util.FileUtil，上面配置想法是把 org.example. 下面的代码都混淆，把 org.example.c 下面的 FileUtil 混淆。但是不混淆 org.example.c.，真正执行的结果是 org.example.c. 都没有被混淆（如下图），但是a和b被混淆了。

如果把上面两部分 顺序调整一下，结果还是一样，虽然看了yGuard源码，但是没找到明确的规则，目前猜测是混淆低的优先级更高。如果把上面两个 的 调换，所有代码都不会被混淆。

因此当你有多组配置时，指定的范围要尽可能的小，而且所有配置要互斥，不能互相包含，想要实现想要的效果，需要按下面的方式进行配置：

<class classes="none" methods="none" fields="none">
    <patternset>
        <include name="org.example."/>
        <include name="org.example.c.util.FileUtil"/>
    patternset>
class>
<class classes="private" methods="private" fields="private">
    <patternset>
        <include name="org.example.c."/>
        <exclude name="org.example.c.util.FileUtil"/>
    patternset>
class>
1
2
3
4
5
6
7
8
9
10
11
12

这里在优先级更高的规则中通过 进行了排除，如果你的混淆配置更复杂，优先级无法确定时，上面的配置粒度仍然不够小，应该把 变得更具体，如下：

<class classes="none" methods="none" fields="none">
    <patternset>
        <include name="org.example.a."/>
        <include name="org.example.b."/>
        <include name="org.example.c.util.FileUtil"/>
    patternset>
class>
<class classes="private" methods="private" fields="private">
    <patternset>
        <include name="org.example.c."/>
        <exclude name="org.example.c.util.FileUtil"/>
    patternset>
class>
1
2
3
4
5
6
7
8
9
10
11
12
13

当你遇到更难解决的情况时，有可能是指定所有具体类的规则。

了解的 yGuard 这部分配置后，接下来就可以进行多模块配置了，多模块配置中也会提供一个示例项目，方便跟着操作研究。