Freeline是蚂蚁金服旗下开发的一个基于动态替换的编译方案,运用到项目后可以极大的提高项目编译速度。相比较现在的instant-run,buck,layoutcast等方案快数倍。
开源地址:
https://github.com/alibaba/freeline
相关原理介绍:
https://yq.aliyun.com/articles/59122?spm=5176.8091938.0.0.1Bw3mU
接下来我们就开始集成Freeline到项目中去,主要讲一下我在配置的过程中遇到的问题。
首先,Freeline是采用Python编写的,所以我们需要安装python环境,根据网上的说法,最好使用python2.7版本(有人使用python3.5无法成功集成)。
在python环境安装成功后,我们就可以着手在项目中集成Freeline了。根据在github中给出的配置的过程,我们先做一下几件事。
Freeline 初始化环境:
根目录下的 build.gradle(工程级别的build.gradle文件)
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
项目下面的 build.gradle(Module级别的build.gradle文件)
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
自定义的 Application
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 1
- 2
- 3
- 4
- 5
- 6
- 7
执行完这些步骤以后,接下在命令行(或者AS的终端)中执行以下命令:
Windows: gradlew.bat initFreeline
Linux/Mac: ./gradlew initFreeline
在执行的过程中,gradle可能会下载一些东西,有时候因为网络的样子会下载很慢,比如这样子的:
这个时候可以从gradle的官网上直接下载,然后将下载好的zip文件放入这个目录下。
然后在首次执行initFreeline时,还会下载相应的依赖包,如果网络好的话3分钟左右就会下载好。
当出现这步时,耐心等待一会儿。这个时候已经开始了对Freeline的初始化。如果提示失败,可以尝试这个命令下载。
Windows: gradlew.bat initFreeline -Pmirror
Linux/Mac: ./gradlew initFreeline -Pmirror
初始化成功后:
就可以连接我们的收紧编译我们的工程了。
执行一条python命令就行:
python freeline.py
第一次编译是全量编译,所以时间上有点慢,但当我们更改文件进行第二次编译时几乎是秒级的。
这时第一次编译的时间是50秒。然后我修改了一个布局文件进行第二次编译。
1.4秒,是不是很快!就是一瞬间的事情。
在这里我们可以看到,Freeline只重新编译了我所修改的布局文件,所以才会这么快。
至此,Freeline已经成功的集成到了我们的项目中,如果觉得每次执行命令行比较繁琐,可以在AS中安装Freeline的插件。
File->Settings->plugins->搜索Freeline即可
安装后就可以在项目中直接点击相应的图标使用,其实也是执行python freeline.py这条命令。
在Android Studio中,通过以下路径File → Settings → Plugins → Browse repositories,搜索“freeline”,并安装。
安装完之后需要重启Android Studio。
这时候会有以下图标
4、点击这个按钮,第一次点击会自动进行gradle的配置,但是不会自动build。需要自己手动进行,如果不是的话也会有相应提示,仔细找会找到的,操作很简单。
5、看Android Studio的底部,你会看到以下图标
打开Freeline的窗口,跟Terminal的窗口差不多,然后执行 gradlew -initFreeline , 如果Freeline的命令窗口执行不了,可以在Terminal的窗口执行也可以,当然也可以在cmd里面执行,只不过要切换到项目目录里面去执行... 这个操作会下载相应的文件,如果比较慢或者无法下载那么就要使用vpn了
6、然后再次点击Freeline的插件按钮,默认执行 python freeline.py 也可以手动输入命令进行编译,编译完后会自动安装到手机上或者模拟器上。
上面就是安装流程了,下面说下遇见的错误,首先:
shrinkResources true
minifyEnabled true
两个命令,所以这两个命令要去除掉
2、如果项目的gradle中使用了 productFlavors 命令,则要配置
android{
freelin{
hack true
productFlavor "your Flavor's name"
}
}
3、如果使用Freeline过程中出现了使用过时的api或者其他警告,可以使用一下配置
android { lintOptions { abortOnError false } }
4、
还有其他一些Freeline相关命令:
python freeline.py -f 全部编译,增量编译
python
freeline.py改变编译
python
freeline.py -v 查看版本号gradlew -initFreeline
给该项目下载相关Freeline文件
gradlew initFreeline -Pmirror
使用镜像给该项目下载相关Freeline文件
1.Python版本问题
目前支持python2.0版本,不支持3.0版本。python2.7.2下载地
址:https://www.python.org/downloads/。
2.productFlavors问题
在主Module的build.gradle中配置productFlavors,例如:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
3.could not find class……问题
在Application类中的onCreate()方法中添加FreelineCore.init(this)方法。
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 1
- 2
- 3
- 4
- 5
- 6
- 7
4.能够正常编译,但是打开应用程序崩
在主Module的build.gradle中配置freeline :
- 1
- 2
- 3
- 1
- 2
- 3
在Application类中加入:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 1
- 2
- 3
- 4
- 5
- 6
- 7
5.install apk to device failed
排查方法:
- 换成系统5.0以上的设备
- 删除手机上的应用程序,进行一次全量编译(python freeline.py -f)
- clean项目(gradlew clean),进行全量编译(python freeline.py -f)
6.连接不到设备
官方github上的解答:
[问题排查] Freeline “try to connect device/ connect_device_task failed.” #152
排查方法如下(建议配合使用Python freeline.py -d):
1.确定FreelineCore.init(this);加入到Application类中,且在onCreate()下的第一行,不要根据是否在主进程做特殊处理,否则可能导致FreelineService无法正常启动;[Freeline 0.7.0+开始,默认开启了Application替换,这条可以不用检查]
2.确定FreelineService以及freeline相关组件是否正常merge到最终的minifest中,最终的manifest路径在${module}/build/intermediates/manifests中;
3.确定python freeline.py -v与定义在build.gradle中的freeline的版本是否一致;
4.确定是否刚刚执行了清空app数据的操作,freeline缓存数据在/data/data路径,清空app数据也会导致连接不上的问题(执行freeline命令时,通常会有句明显的日志反复出现:server result is -1);
5.确定是否开启了网络代理导致127.0.0.1被重定向?
* 6.一定要先使用freeline来打全量包,再来进行增量,否则也会出现这个问题。即,freeline的全量编译与Android-studio自带的RUN会存在冲突。*
当上述问题都无法解决时,有个终极的解决方案就是重启试试…不少人通过重启顺利解决连接不上的问题。。。
后续会通过自动化的方式,尽量避免手工排查上述问题。有遇见相关的问题可以具体描述一下,在issue中进行回复,可以帮忙排查。
连接不到设备,重点排查第5,6步骤。另外还需在AndroidManifest文件中添加:
- 1
- 2
- 3
- 1
- 2
- 3
注意事项
- 第一次编译与没有使用freeline之前的编译时间是一样的,耐心等待就是了。第一次使用全量编译(python freeline.py -f),但在全量编译前最好clean一下(gradlew clean),以后的编译使用python freeline.py就行了。
- 如果设备上安装的不是使用freeline编译打包的程序,请先卸载,否则会无法安装。ps:后续使用freeline编译打包安装完,可能不会自动打开应用程序。
- 不支持删除res/values资源,否则可能导致 aapt 编译出错。
- 不支持Kotlin/Groovy/Scala语言
-
顶
- 1
-
踩