本地资源检测之民间文档 | 仅需10分钟,我又上手了一个新技能!

本地资源检测之民间文档 | 仅需10分钟,我又上手了一个新技能!

我们在今年推出了一个全新的服务【本地资源检测】,作为一个百利无一害还免费的优化服务,它成功集齐了UWA产品家族的各种良好品质:易用、高效、反馈全面、提供分析建议、大数据阈值推荐等...

但也有用户反馈,文档看起来比较复杂,怕接入麻烦。于是,没有任何技术背景的小编,身先士卒完整体验了下这个使用流程,并写完了这篇600字不到的使用教程,保证你照着做不翻车!!

说明:Jenkins并不是使用该服务的必要条件,但如果有Jenkins,可以让检测更加自动无需人工干预(爽);而且没有任何技术门槛,没有任何技术门槛,没有任何技术门槛(重要的事情说三遍),保证是10分钟就掌握的技能!

第一步:准备环境

在UWA网站上找到【本地资源检测】,创建项目后即可在右上方下载对应版本的组件。

下载解压后总共有7个文件:

除开pdf说明文档外,主要的是3个压缩包:
UwaDataUploader.zip — 用于将本地扫描结果解析到云端。
UwaProjScan.zip — 用于扫描检测目录下的资源信息。
UwaServiceUploader —自动化提测接入组件,如果暂时不用可无视。

将UWAProjScan.zip压缩包解压,将会得到图示5个文件:

Luacheck.exe — 这是在windows系统上使用Luachecker功能的依赖文件。(Mac用户需要配置相关环境,详情可见文末,或者上述的pdf文档“本地资源检测组件接入文档”)
OverDraw.shader — 这是特效扫描中依赖的特殊资源。
UwaProjScan.dll — 集成了当前SDK版本下的所有检测规则,为UwaProjScan插件的程序文件。
UwaProjScanLauncher.cs — 是UwaProjScan.dll的启动脚本,您可以在其中看到使用脚本启动UwaProjScan插件的API。
uwascan_ruleconfig.json — 为插件的配置文件,您可以在其中设置路扫描模式、路径、规则及其他功能模块的开启或关闭等。

我们将上述这些文件,全部放入工程目录中的某个Editor目录下。(如无需使用Lua检测功能,则Luacheck.exe文件可以忽略不拖入)


第二步:扫描并生成解析结果

在确认当前平台(安卓、iOS、PC等)后,我们就可以在编辑器【Tools】-【UWA Scan】里找到相关功能,在Settings里进行详细的设置后,直接Run或者按需Run相关的模块,欢快地扫描起来!

一般几分钟就会出扫描结果,具体要结合项目的复杂度而定。Run完毕后,UWA Scan文件夹里会出来结果(一切都是辣么顺利)~


第三步:数据上传

1,先在UwaDataUploader文件夹中的config.json文件中输入自己的UWA账号和密码,Project可以先忽略。


2,这里根据系统的不同,操作上有些许区别:
Mac端操作为:打开终端,先输入Mono,然后把UwaDataUploader.exe拖进去:

Windows端操作为:可以直接双击UwaDataUploader.exe。

3,然后就都一样了:拖入“第二步:扫描并生成解析结果”中生成的UwaScan文件夹,如下图所示:

4,按下Enter键,数据就开始上传了,看到Send to Online finished即执行完毕。

5,在UwaDataUploader文件夹中内会生成result.json文件,打开即可查看到对应的状态,以及报告相关的ID:

success说明已经成功,可以登录UWA后台查看报告了,刚刚本地Scan的数据结果都成了可视化的报告数据啦~是不是很神奇?


对,就是这样,第一次就成功了,没翻车!

此时我的心情

最后,我们在这里简单说明Mac用户使用Luacheck功能需要做的前期配置:

1、lua环境安装配置

curl -R -O http://www.lua.org/ftp/lua-5.4.1.tar.gz 
tar zxf lua-5.4.1.tar.gz 
cd lua-5.4.1 
make macosx test
make install 

2、使用brew安装luarocks

LuaRocks是一个Lua模块包管理器。方便我们创建、安装Lua模块(Lua模块: 称作rocks的独立的包体)。而brew是MacOS下的一个包管理工具。

brew update -verbose

并按照出现的提示修改响应文件的权限

brew install luarocks 

3、使用LuaRocks安装Luacheck

luarocks install luacheck 
luarcoks install lanes

执行命令luacheck,出现如下界面,表示安装成功。


然后就可以愉快地在Mac端使用Luacheck功能了。

以上是手动检测并上传的步骤说明,便于大家第一次就成功。
当然,大家也可以充分利用这个服务,譬如配合自动出包流水线一起使用,只要简单几步接入后,**每天半夜就可以自动检测一遍,第二天上班后可直接看报告了,无需人工干预,如下图所示:

如果想实现自动化检测,可在Jenkins pipeline的编排中加入命令:

该服务对于在研中的项目非常友好,在打包进行真机测试之前,可通过静态的全量分析来帮助研发团队尽早发现项目中的疏漏之处,包括主流资源的各种属性是否合理、代码和场景设置是否正确;同时也支持阈值的自定义满足大家的定制化需求。

大家也可以参考这位大牛的实践分享,从接入到分析排查到复测再到总结复盘,详尽又落地,可作为大家实践参考的攻略帖(太牛了~)

《UWA本地资源检测功能说明》可了解更多。