Android项目快速编译之Freeline-Android的配置与集成

蚂蚁金服旗下开发的Freeline，在使用中遇到的一些问题 。做如下整理，希望对大家有帮助

开源地址： 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文件）

项目下面的 build.gradle（Module级别的build.gradle文件）

自定义的 application

执行完这些步骤以后，接下在命令行（或者AS的终端）中执行以下命令： 

Windows: gradlew.bat initFreeline -Pmirrorlinux/Mac: ./gradlew initFreeline -Pmirror

初始化成功后，执行第一条python命令

python freeline.py

第一次编译时全量编译比较慢，第二次就是毫秒级别的了

File->Settings->plugins->搜索Freeline即可 

 安装后就可以在项目中直接点击相应的图标使用，其实也是执行python freeline.py这条命令。

  

   

1、使用Freeline编译不能使用

     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，例如：
    productFlavors {        appstore {            applicationId 'your package name'        }    }    freeline {        hack true        productFlavor 'appstore'        applicationProxy false    }1234567891012345678910
3.could not find class……问题
在Application类中的onCreate()方法中添加FreelineCore.init(this)方法。
public class YourApplication extends Application {    public onCreate() {         super.onCreate();         FreelineCore.init(this);    }}12345671234567
4.能够正常编译，但是打开应用程序崩
在主Module的build.gradle中配置freeline ：
freeline {    applicationProxy false}123123
在Application类中加入：
public class YourApplication extends Application {    public onCreate() {         super.onCreate();         FreelineCore.init(this);    }}12345671234567
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文件中添加：
<application        android:debuggable="true"                                >123123
注意事项
第一次编译与没有使用freeline之前的编译时间是一样的，耐心等待就是了。第一次使用全量编译（python freeline.py -f），但在全量编译前最好clean一下（gradlew clean），以后的编译使用python freeline.py就行了。如果设备上安装的不是使用freeline编译打包的程序，请先卸载，否则会无法安装。ps：后续使用freeline编译打包安装完，可能不会自动打开应用程序。不支持删除res/values资源，否则可能导致 aapt 编译出错。不支持Kotlin/Groovy/Scala语言
其他参考链接： http://www.qingpingshan.com/rjbc/az/182819.html