1. FiraCode

免费开源的等宽字体，最大特色是为常见编程多字符组合（=>、!=、>= 等）提供连字，视觉上更接近数学符号语义。第一次看到 => 变成一个真正的箭头，会有种「原来代码可以这么优雅」的错觉——错觉归错觉，看着是真舒服。

Mac 安装：

1

brew install --cask font-fira-code

2. Menlo

macOS 内建的无衬线等宽字体（Snow Leopard 起），由 Jim Lyles 设计，DejaVu Sans Mono 的衍生品，曾是 Xcode 的默认字体。系统自带，零配置。

3. Source Code Pro

Adobe 出品的开源编程字体，阅读体验出色，支持 Linux/macOS/Windows，商业和个人都免费。

4. Monaco

老 OS X 时代的默认等宽字体，浓浓的苹果风味，至今仍有大批拥趸。

5. Hack

基于 Bitstream Vera 和 DejaVu 的开源字体，专为显示源代码设计，0O、1lI 辨识度极高。

Mac 安装：

1

brew install --cask font-hack

6. Lucida Sans Typewriter

高辨识度的经典等宽字体，字型干净大气，像打字机打出来的效果。

7. Anonymous Pro

复古打字机风格，中规中矩但各类字符辨识度高，对中文兼容性也不错。

我的建议：想要连字选 FiraCode，懒得折腾用系统自带的 Menlo，追求辨识度选 Hack。当然，以我对程序员的了解，你大概率会全都装一遍、来回切换两周，最后用回第一个——这也是折腾的乐趣之一。

一、常用第三方库

UI 整体方案

• XUI：简洁优雅的 Android 原生 UI 框架。注意它给出的是一整套 UI 解决方案，如果只想用其中几个控件，没必要引入这么庞大的库。
• QMUI_Android：腾讯出品，辅助快速搭建具备基本设计还原效果的项目，丰富控件 + 兼容处理，让开发者专注业务。

单点控件

• MaterialEditText：符合 Material Design 规范的 EditText。
• BasePopup：对系统 PopupWindow 封装改进的弹窗库，自由度和 API 丰富度都很高。
• DslTabLayout：号称 Android 界最万能的 TabLayout，高能自绘控件，继承自 ViewGroup 而非组合控件。
• SmartRefreshLayout：强大稳定的下拉刷新框架，支持所有 View 和多层嵌套结构，集成了各种炫酷的 Header/Footer。

选择器

• AndroidPicker：日期时间、单项、二三级联动、城市地址、数字、日历、颜色、文件目录选择器，一库全包。
• PictureSelector：图片/视频/音频选择器，支持拍照、裁剪、压缩、权限适配。
• CityPicker：美团外卖式的城市选择界面，一行代码接入。

WebView 与权限

• AgentWeb：极易使用且功能强大的 WebView 库，解决了 Android WebView 的一系列坑。
• XXPermissions：权限请求框架，长期维护、系统适配及时。

网络框架

• OkHttp / Retrofit：事实标准，不用介绍——没用过的 Android 开发者建议假装用过。
• RxHttp、Net、EasyHttp：国产封装，链式 API 更顺手，按团队口味选。

二、Android Studio 插件

• Translation：强大的 IDE 翻译插件，支持 Google/有道/百度等翻译引擎，IDE 插件市场直接搜 “Translation” 安装。
• CodeGlance：编辑器右侧的代码缩略图，类似 Sublime 的 minimap，长文件快速定位。
• Android Drawable Preview：在项目树里直接预览 drawable 图标。
• JsonToKotlinClass：JSON 字符串一键转 Kotlin data class。
• WakaTime：编码时间统计工具，支持主流 IDE 和 Chrome。注册账号 → 装插件 → 填 Secret API Key，就能在网站上看到自己的编码报告。

三、Maven 镜像源（国内构建提速）

Gradle sync 转圈转到怀疑人生，八成不是你网速的问题，是仓库在地球另一边。阿里云的镜像仓库是目前最省心的方案（阿里云云效 Maven）：

jcenter 已经作古，老项目里还有依赖走 jcenter 的，尽快迁到 mavenCentral 或用阿里云镜像兜底——别等哪天全量构建失败了才想起这条。

这个场景每个 Android 开发者都不陌生——标注图上颜色是 RGB、透明度却是百分比，而代码里要的是 #AARRGGBB。这篇就是那张让你告别心算的百分比 ↔ 十六进制对照表：40% 透明度的白色，就是 #99FFFFFF，抄走。

颜色值格式

Android 中的颜色值遵循 RGB/ARGB 标准，以 # 开头、16 进制表示，常用格式：

ARGB 依次代表透明度（alpha）、红色（red）、绿色（green）、蓝色（blue）。以 #FF99CC00 为例：FF 是透明度，99 是红色值，CC 是绿色值，00 是蓝色值。

透明度与不透明度

透明度分为 256 阶（0-255），16 进制表示为 00-FF。这里有个最容易翻车的点：ARGB 中的 alpha 表示的是「不透明度」——透明度和不透明度是一对冤家，加起来正好 100%。所以标注图说「透明度 40%」，得先换算成不透明度 60%，再查表得到 99。直接拿 40% 去查表，颜色效果就和设计稿反着来，然后就是一轮「你改了吗」「我改了呀」的经典对线。

对照表

几个常用锚点背下来能应付 80% 的场景：不透明 100% = FF，半透明 50% = 80，全透明 0% = 00。

原理其实一行就讲完：十六进制值 = round(不透明度 × 255)。表忘在这篇文章里了？现算也来得及。

这篇是我踩坑多年攒下的混淆配置笔记，覆盖参数设置、keep 规则语法、常用规则模板、规则叠加机制和资源压缩，最后聊聊 ProGuard 与 R8 该选谁。官方文档见 Shrink, obfuscate, and optimize your app。

一、混淆参数设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

-optimizationpasses 5                       # 代码混淆的压缩比例，值介于0-7，默认5
-verbose                                    # 混淆时记录日志
-dontoptimize                               # 不优化输入的类文件
-dontshrink                                 # 关闭压缩
-dontpreverify                              # 关闭预校验(作用于Java平台，Android不需要，去掉可加快混淆)
-dontobfuscate                              # 关闭混淆
-ignorewarnings                             # 忽略警告
-dontwarn com.squareup.okhttp.**            # 指定类不输出警告信息
-dontusemixedcaseclassnames                 # 混淆后类名都为小写
-dontskipnonpubliclibraryclasses            # 不跳过非公共的库的类
-printmapping mapping.txt                   # 生成原类名与混淆后类名的映射文件mapping.txt
-useuniqueclassmembernames                  # 把混淆类中的方法名也混淆
-allowaccessmodification                    # 优化时允许访问并修改有修饰符的类及类的成员
-renamesourcefileattribute SourceFile       # 将源码中有意义的类名转换成SourceFile，用于定位混淆后的崩溃代码
-keepattributes SourceFile,LineNumberTable  # 保留行号
-keepattributes *Annotation*,InnerClasses,Signature,EnclosingMethod # 避免混淆注解、内部类、泛型、匿名类
-optimizations !code/simplification/cast,!field/ ,!class/merging/   # 指定混淆时采用的算法

二、keep 规则语法

保持规则的语法组成：

1
2
3

[保持命令] [类] {
    [成员]
}

保持命令：

1
2
3
4
5
6

-keep                           # 防止类和类成员被移除或被混淆
-keepnames                      # 防止类和类成员被混淆
-keepclassmembers               # 防止类成员被移除或被混淆
-keepclassmembernames           # 防止类成员被混淆
-keepclasseswithmembers         # 防止拥有该成员的类和类成员被移除或被混淆
-keepclasseswithmembernames     # 防止拥有该成员的类和类成员被混淆

类的匹配：

• 访问修饰符：public、private、protected
• 通配符 *：匹配任意长度字符，但不包含包名分隔符 .
• 通配符 **：匹配任意长度字符，且包含包名分隔符 .
• extends：匹配某个父类的子类
• implements：匹配实现了某接口的类
• $：内部类

成员的匹配：

• <init>：匹配所有构造器
• <fields>：匹配所有域
• <methods>：匹配所有方法
• 除了 * 和 **，还支持 *** 通配符，匹配任意参数类型
• ...：匹配任意长度的任意类型参数，如 void test(...) 可以匹配不同参数个数的 test 方法

三、常用混淆规则模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

# 不混淆某个类的类名，及类中的内容
-keep class cn.listenergao.myapp.example.Test { *; }

# 不混淆指定包名下的类名，不包括子包下的类名
-keep class cn.listenergao.myapp*

# 不混淆指定包名下的类名，及类里的内容
-keep class cn.listenergao.myapp* {*;}

# 不混淆指定包名下的类名，包括子包下的类名
-keep class cn.listenergao.myapp**

# 不混淆某个类的子类
-keep public class * extends cn.listenergao.myapp.base.BaseFragment

# 不混淆实现了某个接口的类
-keep class * implements cn.listenergao.myapp.dao.DaoImp

# 不混淆类名中包含了"entity"的类，及类中内容
-keep class **.*entity*.** {*;}

# 不混淆内部类中的所有public内容
-keep class cn.listenergao.myapp.widget.CustomView$OnClickInterface {
    public *;
}

# 保持类中特定内容而不是所有内容
-keep class cn.listenergao.myapp.example.Test{
    <init>;     # 匹配所有构造器
    <fields>;   # 匹配所有域
    <methods>;  # 匹配所有方法
}

# 可以在<fields>或<methods>前面加上 private/public/native 等进一步限定
-keep class cn.listenergao.myapp.example.Test{
    public <methods>;                   # 该类下所有公有方法不被混淆
    private <methods>;                  # 该类下所有私有方法不被混淆
    public <init>(java.lang.String);    # 该类的 String 参数构造方法不被混淆
}

# 保留内部类需要用 $ 符号：保持 Test 类中的 MyClass 不被混淆
-keep class cn.listenergao.myapp.example.Test$MyClass{*;}

# 不混淆 native 方法（JNI 依赖完整的包名类名方法名）
-keepclasseswithmembernames class * {
    native <methods>;
}

# 不混淆枚举类（values/valueOf 会被反射调用）
-keepclassmembers enum * {
  public static **[] values();
  public static ** valueOf(java.lang.String);
}

# 不混淆资源类
-keepclassmembers class **.R$* {
    public static <fields>;
}

# 不混淆实现了 Serializable 接口的类成员
-keepclassmembers class * implements java.io.Serializable {
    static final long serialVersionUID;
    private static final java.io.ObjectStreamField[] serialPersistentFields;
    private void writeObject(java.io.ObjectOutputStream);
    private void readObject(java.io.ObjectInputStream);
    java.lang.Object writeReplace();
    java.lang.Object readResolve();
}

# 不混淆实现了 Parcelable 接口的类成员
-keep class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}

注意事项（每一条背后都是一次线上事故，建议裱起来）：

1. JNI 方法不可混淆，方法名需与 native 方法保持一致
2. 反射用到的类不混淆，否则反射可能出问题
3. 四大组件、Application 子类、Framework 层下的类、自定义 View 默认不会被混淆，无需另外配置
4. WebView 的 JS 调用接口方法不可混淆
5. 注解相关的类不混淆
6. GSON、Fastjson 等解析的 Bean 数据类不可混淆
7. 枚举类中的 values 和 valueOf 这两个方法不可混淆（反射调用）
8. 继承 Parcelable 和 Serializable 等可序列化的类不可混淆
9. 第三方库或 SDK 参考第三方提供的混淆规则，没提供的话建议第三方包全部不混淆

四、混淆规则的叠加

你有没有想过一个灵异现象：主模块的 proguard-rules.pro 明明空空如也，代码却被混淆了？这不是闹鬼，是因为混淆规则是叠加的，来源远不止你写的那一份：

1. 各模块的 proguard-rules.pro —— 子模块也可以有，某个模块的配置可能影响其它模块
2. proguard-android-optimize.txt —— AGP 编译时生成，包含对大多数 Android 项目有用的规则，并启用 @Keep* 注解；AGP 还提供 proguard-defaults.txt 和 proguard-android.txt，可通过 getDefaultProguardFile 设置，建议用 optimize 这份（多了优化配置）
3. build/intermediates/proguard-rules/debug/aapt_rules.txt —— AAPT2 根据清单文件、布局及其他资源的引用自动生成保留规则，比如不混淆每个 Activity
4. AAR 库的 /proguard.txt
5. Jar 库的 /META-INF/proguard/

想查看所有规则叠加后的最终混淆规则，在主模块 proguard-rules.pro 添加：

1

-printconfiguration ./build/outputs/mapping/full-config.txt

五、资源压缩

资源压缩分两步：资源合并与资源移除。

资源合并：无论是否配置 shrinkResources true，AGP 构建 APK 时都会执行。存在两个或更多同名资源时，AGP 从重复项中选择优先级更高的文件传递给 AAPT2。级联优先顺序：

1

依赖项 → 主资源 → 渠道 → 构建类型

比如重复资源存在于主资源及渠道中，Gradle 会选渠道中的资源；但如果重复资源在同一层次（如 src/main/res/ 和 src/main/res2/），Gradle 会报资源合并错误。

资源移除：开启资源压缩后，所有未被使用的资源默认会被移除。想自定义保留/移除，可在 res/raw/ 下创建 keep.xml（此文件不会打包进 APK，支持通配符 *）：

1
2
3
4
5

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@layout/l_used*_c,@layout/l_used_a,@layout/l_used_b*"
    tools:discard="@layout/unused2"
    tools:shrinkMode="strict"/>

shrinkMode 可选 strict / safe：前者严格按 keep 和 discard 指定的资源保留；后者保守删除未引用资源（如代码中用 Resources.getIdentifier() 引用的资源会保留）。

另外还可以用 resConfigs 移除不需要的备用资源，比如只保留中文：

1
2
3
4
5

android {
    defaultConfig {
        resConfigs "zh-rCN" // 不需要国际化时只打包中文资源
    }
}

六、ProGuard 与 R8

• ProGuard：压缩、优化和混淆 Java 字节码的免费工具，开源仓库
• R8：ProGuard 的替代工具，兼容现有 ProGuard 规则，更快更强。AGP 3.4.0 及以上默认使用 R8

结论：直接用 R8，别纠结。兼容绝大部分 ProGuard 规则、编译更快、对 Kotlin 更友好——想换回 ProGuard 属于「可以但没必要」系列。

构建后会在 build/outputs/mapping/release/ 输出以下文件：

• mapping.txt：原始与混淆后的类、方法、字段名称映射。崩溃堆栈还原全靠它，发版后务必留存——弄丢 mapping 文件再看线上崩溃，就像拿着一张全是马赛克的藏宝图
• seeds.txt：未进行混淆的类与成员
• usage.txt：APK 中被移除的代码
• resources.txt：资源优化记录

这些文件不一定都有，可以在 proguard-rules.pro 显式指定输出：

1
2
3

-printmapping ./build/outputs/mapping/mapping.txt
-printseeds ./build/outputs/mapping/seeds.txt
-printusage ./build/outputs/mapping/usage.txt