- 前言
- 正文
- 一、新版Android Studio编译运行
- ① 升级项目gradle版本
- ② 切换JDK版本
- ③ BuildConfig报错
- 二、百度的SDK使用
- ① 开发版SHA1的作用是什么?
- ② 什么时候需要更换开发版SHA1?
- ③ 怎么获取开发版SHA1?
- ④ 发布版SHA1的作用是什么?
- 三、依赖库更新
- ① AndroidManifest.xml更新
- ② baseRecyclerViewAdapterHelper更新
- 四、替换ButterKnife
- ① 开启ViewBinding
- ② 创建UiVBCallback
- ③ 创建baseVBActivity
- ④ 使用baseVBActivity
- ⑤ 创建MvpVBActivity
- ⑥ 使用MvpVBActivity
- ⑦ 去掉ButterKnife依赖
- 五、保存图片的适配
- 六、源码
最近发现这个项目好似迎来了第二春,GitHub上的Start和Fork增加的很快,我的猜测是学生在通过这个项目来学习和完成自己的作业。随着Android版本的更新,Android Studio的更新,项目中一些内容不能在新版本中很好的使用,甚至出现编译不了的情况,这对我来说没啥,但是对于拿到项目满心欢喜的学生来说,运行不了,无疑是致命的,而我写在项目Readme下面我将演示一下怎么在本地运行这个项目的代码。
在之前写代码的时候还是有一些细节没有做到位,例如代码版本的管理就没有做,导致你看过前几篇文章,跟着写遇到问题,想要看源码,发现源码没有区分章节,而是整体一起的,这无疑给学习的同学造成了麻烦,那么我这篇文章在写之前将之前的代码添加到一个分支中,你学习的话先下载分支的代码,然后跟着写,写完之后就是当前最新的版本代码,这里的版本是2.8。项目地址:GoogWeather
你切换到Release_2.8再去下载就是之前的所有代码,下载代码你肯定会吧。
下载代码之后,我们就需要在Android Studio中运行,这里我们可以使用Google官网中最新的AS版本,这里我使用的版本如下图所示:
这里的版本是海豚,也属于比较新的版本了。你现在下载的可能比这个还要新一点,不过也没关系,操作方式是一样的,因为我开始写这个项目的时候是20年4月份,那时候用的是Android Studio3.5.2,和现在的新版本差别还是蛮大的,下面我们通过AS打开这个项目。
打开之后AS会检查你这个项目采用的是什么版本的gradle,如果检查到当前电脑环境没有此项目中的gradle,就会下载,这里要注意网络环境问题,如果一个网络环境不行就切换其他的网络环境,例如换个WIFI,使用手机热点等方式。
下载好之后AS就会根据这个gradle来编译你的项目,注意一点,高版本AS可以编译低版本的项目,而如果低版本AS项目编译gradle版本高于AS本身gradle版本的项目,则需要降低项目版本,或者提高AS版本,这两种方式就不展开讲了。还有一点就是编译的时候和项目的JDK也有关系,例如我之前的项目采用的JDK是1.8,AS中自带了两个1.8和11两个版本,新项目都是采用11的版本。JDK没有问题之后就会下载你的项目所依赖的远程仓库代码,下载之后再进行编译。这个过程可能会比较长,和项目所使用的库多少及当前网速快慢有关。最后一点,项目使用的Android SDK是28,因此会在编译过程中,提示你下载28的SDK,下载之后再编译就好了,目前我编译了20分钟,终于编译完成了。
在编译完成之后,你可能会看到这样一个提示窗口。
在Android Studio的右下角出现,什么情况下会出现呢?当你的项目gradle版本与当前AS的gradle版本不匹配时就会出现,我们点击这个upgraded,出现弹窗。
点击Begin Upgrade ,开始升级项目的gradle版本。
这里点击Run Selected Steps,运行选中步骤。同样会下载gradle版本,这里下载的是6.7.1,下载完会进行编译。这个过程大概也要十几分钟,完成后,再看。
然后通过下拉框,将4.2.2改成7.3.0,再点击Run Selected Steps,这里也需要一点时间。
这里只剩下最后一步了,最后这个是建议步骤,可做可不做。
做完之后,我们运行一下,然后会遇到一个问题。
我们的项目之前采用1.8,而现在更新了项目的gradle版本,这个版本最低要求是11,所以我们需要更改项目的JDK版本。怎么修改呢?点击File → Settings… → Gradle。
这里会看到Gradle JDK是1.8,点击右边的下拉按钮,我们切换到11
然后点击 Apply 按钮,应用一下刚才的修改,再点击 OK 关闭这个窗口,然后我们再运行一下,这里要用真机运行。因为虚拟机缺少定位传感器,同时SDK不一定兼容虚拟机。
运行后发现报错了。
修改的方式很简单,如下图所示,我们补全一下报名就可以了。
下面没有报错了,我们再运行一下:
OK,没有问题,现在能够正常运行了,检查一下布局预览是否能正常显示。布局预览没有问题,那么我们的项目也在新版本的AS上面跑起来了。在你们哪里不一定能定位成功,因为还需要修改一个地方。
鉴权失败,这个会导致无法进行定位,下面说一下这个问题是怎么产生和解决的。
这里要注意一个问题,首先你在百度地图开放平台上是否创建了应用,没有创建的话,你就需要去创建。创建应用的方式,在天气App的第一篇文章中已经说明了,先不要着急去看,听我说完,创建应用需要几个条件,发布版SHA1、开发版SHA1、应用包名。
开发版SHA1是让你能够在debug运行模式下使用SDK中的功能,注意这个debug运行要在真机上,不要妄想使用虚拟机或者模拟器,问题一大堆,你要是愿意死磕,也可以,鱼死不死不好说,但网一定破。
开发版SHA1随着你本地的环境改变而改变,就拿我们当前这种情况来说,本地没有项目,下载下来到AS中进行编译,这时就需要更换开发版SHA1的值,如果你之前没有创建百度地图平台应用的话,则就是在创建应用的时候将开发版SHA1填进去。另一种情况,比如之前的项目在文件夹A下,现在你挪到文件夹B下,那么你同样需要再次获取项目的开发版SHA1的值,更新平台上的开发版SHA1值。
由于Android Studio版本发生了改变,获取开发版SHA1的获取方式也一样改变了,在你准备获取SHA1版本之后请先配置好Java JDK的环境变量,再来操作。假设你已经配置好了环境变量,下面进行开发版SHA1的获取,Win + R ,输入cmd,进入命令窗口。
先切换到.android目录下,然后输入keytool -list -v -keystore debug.keystore。
回车之后会让你输入密钥,默认的密钥就是android,你输入的时候是不可见的,光标也不会有反应,你只管输入就行,输入完回车就能看到SHA1了,如下图所示。
这里的SHA1就是开发版SHA1,然后将SHA1值更新一下再保存。
现在你再运行一般来说就不会出现定位不成功的情况,也不会出现SDK鉴权失败的情况了。
开发版SHA1的作用是让你在电脑本地通过Android Studio调试运行的时候,能够使用正常使用SDK中功能。而一个应用你不可能只有自己在使用吧,你可能会发给别人,这个时候你就需要将项目打包成APK,将apk发布给别人安装,至于怎么打包,我也有文章说明,搜一下就可以了。而获取发布版SHA1,你需要先成功打一个包,然后再进行发布版SHA1的获取,具体的操作获取方式参考第一篇文章,那个大体没有改动,只有最后不用选择v1、v2。
首先我们需要修改app的build.gradle和mvplibrary的build.gradle。
app的build.gradle代码如下:
api版本由28更改为31,一些依赖库的版本更新了,有第三方的,也有android自己的库,jdk版本也更新了。
下面是mvplibrary的build.gradle。
这里同样更改了一些库的版本,会造成什么问题我们目前尚未可知,有问题再解决就是了,下面Sync Now,然后运行。
这里出现了问题,因为31表示Android 12,在Android 12中android:export需要显式指定元素<activitycom.llw.goodweather.ui.SplashActivity>。针对Android 12及更高版本的应用,当相应的组件定义了意图过滤器时,需要为“Android:exported”指定显式值。意思很明显我们的启动页面,需要增加exported属性,并且值设置为true。在AndroidManifest.xml中找到SplashActivity。
修改后运行一下。
这里使用的是3.0.4版本,相较于之前的改版,改动不到,但由于一个类的路径更改,所以代码中涉及到的地方同样需要更换。
如图所示,我们发现这个com.chad.library.adapter.base包下,已经没有这个了,那么我们重新导包试试看,将之前的那个报错的导报语句删除掉,然后鼠标悬停在baseViewHolder上面。
使用快捷键Alt + Enter进行导包,导包后会增加一行import代码:
我们再对比之前报错的那个导包语句看看
可以看到,区别只是新版本中多了一个viewholder包的层级,那么我们就只需要将新的这个导报语句替换掉报错的导包语句即可,使用全局替换,快捷键Ctrl + Shift + R 。
上面一行是原来的报错导包,下面这一行是我们需要替换的导包语句,有21处需要替换,点击Replace All,替换所有,会弹窗提示你,问你是否确定要这么做,点击Replace。替换完成之后,我们再运行试试看。
发现了一个新的错误,是添加点击事件的方法没有了,因此我们还需要修改这个部分的代码。首先将
这行代码注释掉或者删掉,然后我们进入使用适配器监听点击的地方,在MainActivity中,你找到如下图所示的代码:
这个接口也没有了,那么我们需要怎么添加子控件的点击事件呢?修改方式如下图所示:
这里可以看到我们通过
添加需要进行点击的控件Id,注意这里可以是多个控件Id,例如:
你会发现new onItemChildClickListener()是灰色的,这表示可以省略掉,精简代码,使用Lambda表达式,点击灰色部分,使用快捷键,Alt + Enter,回车出现弹窗。
这里点击Relpace with lambda选项,替换为lambda,替换后如下图所示。
这里你可以替换也可以不替换,随你自己。关于适配器添加点击事件的方法你已经学会了,那么你可以更改其他的适配器中的点击方式了,这个就没有快捷的方式了,你需要一个个去改,我就不重复说明了。所有适配器改完之后再运行看看,哦豁,又报错了。
这个报错的原因是mContext值没有了,这是一个上下文,之前的依赖库版本中是有的,现在没有了,就需要替换了,将mContext,即可,自行替换就好了。然后再运行你会发现,不报错了,可以运行了,这个库的问题改完了。但是还有一个隐藏问题在WallPaperAdapter类中。
这个getAdapterPosition()方法没有了,这个我们也需要替换,将
改成
即可。
好了,这个依赖库我们就改完了,开不开心?来人,奏乐,起舞,老子改了大半天BUG了,还不能享受享受吗?嗯?
为什么要替换掉呢?因为在新版Android Studio中你已经不能使用ButterKnife的插件了,ButterKnife的作者也告诉我们不再维护这个库了,推荐我们使用ViewBinding。
首先要使用ViewBinding,我们需要先开启它。在app的build.gradle的android{}闭包中增加如下所示代码:
然后Sync Now,下面我们以aboutUsActivity为例来修改一下,使用ViewBinding。
还记得之前我们使用的框架吗?是MVP,现在我们去掉了ButterKnife,所以响应的底层也需要改动,之前我们有一个UiCallBack,所以为了区分,我在base包下新建了一个vb包,表示这是使用ViewBinding所需要的一些类和接口,那么我们在vb包下新建一个UiVBCallback接口,代码如下:
这里三个方法,很简单,前面两个不是必须要实现的,最后一个是必须要实现的,因为我们会涉及到ViewBinding的简单封装,除了第一个onRegister()方法你不清楚,其他的方法你之前应该都见过了,这个onRegister()的作用实际上是为了让你更好的使用Activity Result API,因为我们startActivityResult()过时了。具体的你可以上网看一下,这里就不展开说明了,用到了再说。
为了能让所有的Activity都使用ViewBinding,我们创建一个类似于baseActivity的抽象基类,在com.llw.mvplibrary.base.vb包下新建baseVBActivity类,代码如下:
这里的核心思想就是反射。
下面我们修改一下aboutUsActivity中的代码,如下所示:
在这里面我将关于ButterKnife的注解都删除掉了,findViewBinding通过ViewBinding的编译时技术在编译过程中就给我们生成了findViewById的代码了,这个代码就在ActivityaboutUsBinding类中,这个类是编译时生成了,只要你是layout下的xml,在开启了ViewBinding之后都会生成对应的类文件,文件命名规则就是布局名称 驼峰 + Binding,例如布局名称为activity_main.xml,生成的文件就是ActivityMainBinding,掌握这个规律就好了,文件核心就这么多,控件实例化了,但是我们还是需要自己写控件点击的代码,还是比较简单的吧。这个封装的核心思路就是通过编译时生成类,类继承自ViewBinding,通过泛型可以传入任何继承自ViewBinding的类,传入的类通过反射拿到具体的类,再通过类拿到里面的方法,通过方法拿到实例化之后的binding,最后setContentView,将binding.getRoot()设置进去即可,注意一点反射会比不反射在编译的时候耗时一些,子类可以直接拿到父类的binding,通过binding得到xml中的控件id,你会看到很多的binding.xxx,相信你应该能够理解了,不理解也没有关系,你先用,用的多了就理解了,同时我去掉了getLayoutId()。
现在基本的Activity可以使用ViewBinding了,下面是用到MVP的Activity,这里我们依然保留之前的方式,所以我们需要创建一个可以使用ViewBinding的MVPActivity,在mvp包下新建MvpVBActivity,代码如下:
整体上来说,改动不是很大,不过这种方式你可以多加理解一下。
好了,下面我们来使用一下MvpVBActivity。
同样我们需要一个例子来使用这个MvpVBActivity,那么就来改造一下WallPaperActivity吧。
这里我们在泛型里面增加了一个ActivityWallPaperBinding,然后修改一下initData方法。
因为只有一个点击事件,我就直接写在这里面了,原来的点击注解记得删除掉哦,使用就是这么的简单,你学会了吗?后续的其他Activity自己去修改,不会也没有关系,源码就在哪里,你拿去对比看一下就可以了,记住一个事情,如果你的电脑环境,版本,代码、运行环境和作者一样,SDK配置没有问题,那么你就肯定没有问题,那么如果有问题,怎么办,找到问题的发生原因,可能一开始你还不够熟练,但是解决问题比制造问题更能让一个人成长,实在解决不了再去求助,才会有醍醐灌顶的作用,遇到问题先自己想办法解决,这里说一个标准吧,遇到问题之后,百度上搜索,前面七页结果你都看一遍,百分之八十的问题就能解决,耐心很重要,很重要,千万不要浮躁,切记、切记。
现在我们已经不需要ButterKnife了,可以去掉了,有五处地方,第一个地方,在工程的build.gradle中去掉butterknife的插件。
第二个地方,在app模块的build.gradle中去掉butterknife的依赖库和注解处理器库。
第三个地方,在mvplibrary模块的build.gradle中butterknife的依赖库和注解处理器库。
现在关于gradle中的改动就完成了,Sync Now,然后运行一下,看看App中是否哪里有报错,检查是否还有别的类使用了依赖库中的注解和方法。不出意外的话。
第五处,你的baseActivity会报错,因为现在已经有了baseVBActivity了,所以baseActivity可以删掉,或者你把baseActivity里面的关于butterknife的信息删掉也可以,注意baseFragment中的相关信息也要删掉。
第四处,删掉KnifeKit,连同kit包一起删掉。
好了,你可以再次运行有残留包名的就删掉,直到你能够正常运行到手机上即可。
之前的版本是基于Android10做的,而现在目标版本是Android12,因此保存图片的路径需要改动一下,也很简单。根据版本修改一下路径的值就可以了,打开ImageActivity,找到方法,修改代码如下图所示:
然后你就可以在Android10以上的版本下载图片成功了。
时隔一年多再次更新,老来俏啊~