Freeline是什么

Freeline 是蚂蚁金服旗下一站式理财平台蚂蚁聚宝团队15年10月在Android平台上的量身定做的一个基于动态替换的编译方案，5月阿里集团内部开源。

稳定性方面：完善的基线对齐，进程级别异常隔离机制。

性能方面：内部采用了类似Facebook的开源工具 buck 的多工程多任务并发思想：端口扫描，代码扫描，并发编译，并发dx，并发merge dex等策略，在多核机器上有明显加速效果，另外在class及dex，resources层面作了相应缓存策略，做到真正增量开发，另外引入并优化 buck 的部分加速组件dx，DexMerger，资源编译方面，深入改造了aapt 资源编译流程，当资源发生改变时候，秒级完成增量包编译，其中增量包仅含最小的变更集合（10Kb～数百Kb内），后期也被运用到线上进行资源/代码动态替换。相比目前 instant-run，buck，layoutcast 等方案快数倍速度。

简单的说：Freeline 是一个能让你快速调试Android程序的插件，速度有多快呢？官方的说法是可以让你的APP编译加速十倍，很吸引人吧，听说比 jrebel 还快，不过我没用过 jrebel 这个付费的产品。

官方介绍

Freeline源码

https://github.com/alibaba/freeline

Freeline原理

https://yq.aliyun.com/articles/59122

如何使用Freeline

配置build.gradle文件

配置 project-level 的 build.gradle，加入 freeline-gradle 的依赖：（注意以最新版本为准）

然后，在你的 主module 的 build.gradle 中，应用 freeline插件 的依赖：

apply plugin: 'com.antfortune.freeline'android {    ...}

执行运行代码

Windows[CMD]: gradlew initFreeline -Pmirror

Linux/Mac: ./gradlew initFreeline

对于国内的用户来说，如果你的下载的时候速度很慢，你也可以加上参数，执行 gradlew initFreeline -Pmirror，这样就会从国内镜像地址来下载。

安装插件

Freeline 最快捷的使用方法就是直接安装Android Studio插件。

在Android Studio中，通过以下路径 Preferences → Plugins → Browse repositories，搜索“freeline”，并安装。

实例

git clone git@github.com:alibaba/freeline.git cd freeline/sample./gradlew initFreeline //macgradlew initFreeline -Pmirror //windowspython freeline.py

爬坑之旅

以上官方给出的介绍和使用，当你真正开始使用的时候，坑就来了，不要紧，勇敢的踏过去。

找不到gradlew命令

如果你是 windows平台，你打开cmd你会发现，当你输入 gradlew initFreeline 的时候，你会发现根本没有 gradlew命令，那么官方是说毛线。

'gradlew' 不是内部或外部命令，也不是可运行的程序或批处理文件。

解决：看看代码的意思，官方的意思是要你初始化 Freeline，那么 gradlew 这个命令在哪呢？打开你的项目的根目录，你就会发现 gradlew文件，所以其实打开 cmd 以后，你还必须找到根目录再去运行 gradlew initFreeline，其实你会发现在 studio 的 Terminal 里面，已经默认找到根目录，因此只需要在里面键入 gradlew initFreeline 命令行即可

gradlew initFreeline命令执行的太慢

当你运行 gradlew initFreeline 的时候，有时候会卡住，要求你下载完整的gradle的包

C:\Users\yourname\.gradle\wrapper\dists

问题的关键就是在于，你在下载gradle包的时候被防火墙墙了。

注意一下你的studio里面用到的gradle，使用本地的：

解决：去单独下载一个完整的gradle-2.14.1-all包：

gradle-all 包下载地址

https://services.gradle.org/distributions

自备梯子，或者是其他途径，总之你需要一个完整的包。扔进 2.14.1-all 的根目录里面：

再次运行 gradlew initFreeline -Pmirror 命令，它自己首先会解压缩完整的gradle包，然后稍等一下，它会自己下载需要的所有插件，我在我的项目里面的 OkHttp_Proj 示范，结果如下：

Python下载与配置

当我们的 gradlew initFreeline 命令运行完毕以后，我们还需要下载 python环境，因为脚本语言是用 python 写的。

Python下载

https://www.python.org/downloads

同样是自备梯子，或者其他地方下载。在这我建议直接装进C盘，然后添加环境变量。打开你的 cmd 输入以下代码：

//根据你下载的版本判断PATH=PATH;c:\python27

成功以后，cmd 键入 Python，会出现相关的版本信息。如果你原来电脑上没有 Python环境 的话，Python 安装配置以后，一定要重启 studio，不然无法识别 python 关键字。

运行freeline.py文件

记住了：

安装了 Python 以后一定要重启studio。

同样是在项目的根目录以下运行 python freeline.py 代码。

建议

我建议最后再安装 freeline插件，至少你先搞清楚，每一步的实现的机制，再使用 freeline，会清晰很多。

最后这些环境都配置好了以后，下一次项目就不用那么麻烦了，直接点击 freeline 的那颗小按钮，它会自动给你添加各种配置并且自动运行的。

补充

下载freeline.zip太慢

当我们配置好studio以后，打开 cmd 找到对应项目的根目录以后，执行：

gradlew initFreeline -Pmirror

会发现 一直卡在build构建的那里，看一眼提示，显示的 正在下载freeline.zip，到根目录下，分析原因就是因为网络的问题，无法下载 freeline.zip。我们通过dos下面，想做的无非就是下载这个 freeline.zip 的压缩包，然后解压进根目录完成快速编译。

解决之路：

打开浏览器，推荐使用chrome，打开

http://static.freelinebuild.com/freeline/0.8.4/all/freeline.zip

最新版本号为准，下载该文件，再到对应根目录下解压。

1. 如果再次执行 gradlew initFreeline 命令，还是会重新下载一个新的 freeline.zip包，但是我们已经得到的是已经下载完毕并且解压完毕的了，因此我们一看根目录，已经有了我们想要执行的 freeline.py 的 python文件，所以直接执行第二步： python freeline.py。

2. 却以外发现失败了，看一眼错误提示：

没有发现一个叫作 freeline_project_description.json 的文件，freeline 很温馨的给出了解决的办法。

解决：执行下面的命令

Windows[CMD]: gradlew checkBeforeCleanBuild

Linux/Mac: ./gradlew checkBeforeCleanBuild

执行完毕以后，你们发现最后出现一个，

之前缺失的那个json文件保存进了根目录，而且已经构建成功了，也就是说，我们自己下载解压进根目录的 freeline.zip 包生效了

BUILD SUCCESSFUL 这行命令就是initFreeling最后成功的命令。

接下来再次执行 python freeline.py 构建就成功了。