本地资源检测之民间文档 | 仅需10分钟，我又上手了一个新技能！
- 作者：admin
- /
- 时间：2020年06月18日
- /
- 浏览：4642 次
- /
- 分类：厚积薄发
我们在今年推出了一个全新的服务【本地资源检测】，作为一个百利无一害的优化服务，它成功集齐了UWA产品家族的各种良好品质：易用、高效、反馈全面、提供分析建议、大数据阈值推荐等...
但也有用户反馈，文档看起来比较复杂，怕接入麻烦。于是，没有任何技术背景的小编，身先士卒完整体验了下这个使用流程，并写完了这篇600字不到的使用教程，保证你照着做不翻车！！
说明：Jenkins并不是使用该服务的必要条件，但如果有Jenkins，可以让检测更加自动无需人工干预（爽）；而且没有任何技术门槛，没有任何技术门槛，没有任何技术门槛（重要的事情说三遍），保证是10分钟就掌握的技能！
第一步：准备环境
在UWA网站上找到【本地资源检测】，创建项目后即可在右上方下载对应版本的组件。
下载解压后总共有7个文件：
除开pdf说明文档外，主要的是3个压缩包：
UwaDataUploader.zip — 用于将本地扫描结果解析到云端。
UwaProjScan.zip — 用于扫描检测目录下的资源信息。
UwaServiceUploader —自动化提测接入组件，如果暂时不用可无视。
UWAProjScan.zip压缩包解压，将会得到图示7个文件：
“ArtCheckUtils”和“ApiCompatibilityUtils.cs”——这是使用“美术资源检测模块”所需的依赖文件。（暂时不支持MAC OS，敬请等待后续的更新）
Luacheck.exe — 这是在windows系统上使用Luachecker功能的依赖文件。（Mac用户需要配置相关环境，详情可见文末，或者上述的pdf文档“本地资源检测文档-1-快速开始”）
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账号、密码以及项目名称等信息。
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本地资源检测功能说明》可了解更多。