工作日报2022。1。19mavengradle插件如何上传多渠道library

　　2022.1.19问题澄清；记录仪屏蔽通知栏开发澄清文档书写。codex问题处理；后续流程跟踪。翻译词条归一整理；安全终端加密服务密保保存功能，增加OTA参数；合入布控球振动修改；
　　maven gradle插件如何上传多渠道library
　　1、背景
　　对接的第三方SDK分联调版（测试环境）跟正式版（生产环境），调试时用联调版，上线用正式版。两个环境对应不同的代码、资源文件，考虑到复用问题，因此新建一个library集成这个SDK，并上传到公共库，之后在项目中直接依赖即可。
　　2、需求及实现
　　2.1、需求
　　因为分两个版本，且版本的代码、资源各不相同，因此这个library应该要实现以下需求
　　一个library module包含多个渠道flavor
　　可以单独上传flavor，并且互不影响
　　2.2、一个任务上传一个渠道
　　正常情况下使用maven 插件是这样：
　　apply plugin: ＂com.android.library＂
　　apply plugin: ＂maven＂
　　1
　　2
　　然后用uploadArchives配置pom相关信息，和上传路径等：
　　uploadArchives {
　　repositories.mavenDeployer {
　　pom.groupId = GROUP
　　pom.artifactId = ARTIFACT_ID
　　pom.version = VERSION_NAME
　　repository(url: REPOSITORY_URL) {
　　authentication(userName: NEXUS_USERNAME, password: NEXUS_PASSWORD)
　　}
　　}
　　}
　　最后执行uploadArchives任务即可上传成功。
　　但是这样显然不符合需求，多个渠道的情况下会有多个aar，且pom.artifactId也是不一样的，需要针对性的配置。
　　2.3、一个任务同时上传多个渠道
　　查了好几天资料，都没发现什么有用的信息，大多都是针对单个flavor的，终于在StackOverflow上找到了一些有用信息，照葫芦画瓢，最后gradle如下：
　　import org.gradle.api.internal.artifacts.publish.DefaultPublishArtifact //导入类
　　...
　　android {
　　publishNonDefault true
　　productFlavors {
　　//调试环境、测试环境
　　dev {
　　}
　　//生产环境、正式环境
　　production {
　　}
　　}
　　...
　　}
　　//配置要上传的文件信息
　　artifacts {
　　archives new DefaultPublishArtifact(＂production＂, ＂aar＂, ＂aar＂, null, new Date(), new File(＂build/outputs/aar＂, ＂lib-production-release.aar＂))
　　archives new DefaultPublishArtifact(＂dev＂, ＂aar＂, ＂aar＂, null, new Date(), new File(＂build/outputs/aar＂, ＂lib-dev-release.aar＂))
　　}
　　//上传任务配置
　　uploadArchives {
　　repositories.mavenDeployer {
　　...
　　//添加过滤器
　　//正式环境
　　addFilter(＂pro＂) { artifact, file ->
　　artifact.name.contains(＂production＂) //production就是artifacts里指定的name
　　}
　　//测试环境
　　addFilter(＂dev＂) { artifact, file ->
　　artifact.name.contains(＂dev＂)
　　}
　　//单独设置pom文件
　　pom(＂pro＂).groupId = GROUP
　　pom(＂pro＂).artifactId = PRODUCTION_MAVEN.ARTIFACT_ID
　　pom(＂pro＂).version = PRODUCTION_MAVEN.VERSION_NAME
　　pom(＂dev＂).groupId = GROUP
　　pom(＂dev＂).artifactId = DEV_MAVEN.ARTIFACT_ID
　　pom(＂dev＂).version = DEV_MAVEN.VERSION_NAME
　　}
　　}
　　这样执行uploadArchives之后，就会上传多个渠道的aar了，这里算完成了一半。
　　2.4、自定义上传任务
　　要实现单个渠道上传，只靠uploadArchives这一个任务是不行的，因此要自定义上传任务，实现一样的功能。本质上uploadArchives也是Upload类型的Task，即我们可以照着uploadArchives自定义Task继承Upload：
　　//上传调试版aar
　　task uploadDev(type: Upload, group: ＂upload＂) {
　　repositories.mavenDeployer {
　　repository(url: uri(＂../repos＂)) {
　　}
　　addFilter(＂dev＂) { artifact, file ->
　　println(＂artifact ＂ + artifact.name)
　　artifact.name.contains(＂dev＂)
　　}
　　pom(＂dev＂).groupId = MIGU_GROUP
　　pom(＂dev＂).artifactId = DEV_MAVEN.ARTIFACT_ID
　　pom(＂dev＂).version = DEV_MAVEN.VERSION_NAME
　　}
　　}
　　同步之后就会在upload目录下多了一个任务：
　　执行之后，就会发现这个错误：
　　No value has been specified for property ‘artifacts’.
　　这时看uploadArchives的源码是最好的，但是我不知道去哪里看，所以又耗费了我一些时间查资料。最后实在没辙，终于直面这个错误：既然没指定，那就显示的设置好了。
　　2.4.1 artifacts和configuration
　　配置上传信息的时候用到了artifacts，但是不知道为什么要这样写，看了下源码，artifacts和configurations都是位于project下：
　　//Configures the published artifacts for this project.
　　*configurations {
　　* //declaring new configuration that will be used to associate with artifacts
　　* schema
　　* }
　　* task schemaJar(type: Jar) {
　　* //some imaginary task that creates a jar artifact with the schema
　　* }
　　* artifacts {
　　* //configuration name and the task:
　　* schema schemaJar
　　* }
　　void artifacts(Closure configureClosure);
　　根据注释的说明，应该有个默认的configuration，是这样写的:
　　configurations {
　　archives
　　}
　　所以我们才能使用archives来配置要上传的文件，而看了Upload的源码后发现，artifacts并没有直接设置的方法，而是通过Configuration获取的：
　　/**
　　* Returns the artifacts which will be uploaded.
　　*
　　* @return the artifacts.
　　*/
　　@InputFiles
　　public FileCollection getArtifacts() {
　　Configuration configuration = getConfiguration();
　　return configuration == null ? null : configuration.getAllArtifacts().getFiles();
　　}
　　也就说是要设置artifacts必须要先设置Configuration。通过打印configurations和上面的分析，archives就是我们的目标。所以手动把archives这个配置加进来:
　　//上传调试版aar
　　task uploadDev(type: Upload, group: ＂upload＂) {
　　//设置configuration
　　setConfiguration(project.configurations.getByName(＂archives＂))
　　repositories.mavenDeployer {
　　...
　　}
　　到这里已经可以了。
　　2.4.2 自定义artifacts和configuration
　　同样地，可以自定义configuration来过滤配置文件，自定义上传Task设置为该configuration即可
　　configurations {
　　dev
　　pro
　　}
　　//配置要上传的文件信息
　　artifacts {
　　pro new DefaultPublishArtifact(＂production＂, ＂aar＂, ＂aar＂, null, new Date(), new File(＂build/outputs/aar＂, ＂lib-production-release.aar＂))
　　dev new DefaultPublishArtifact(＂dev＂, ＂aar＂, ＂aar＂, null, new Date(), new File(＂build/outputs/aar＂, ＂lib-dev-release.aar＂))
　　}
　　//上传调试版aar
　　task uploadDev(type: Upload, group: ＂upload＂) {
　　//设置configuration
　　setConfiguration(project.configurations.getByName(＂dev＂))
　　repositories.mavenDeployer {
　　...
　　}
　　2.4.3 最终版本
　　configurations {
　　devArchives
　　proArchives
　　}
　　//配置要上传的文件信息
　　artifacts {
　　proArchives new DefaultPublishArtifact(＂production＂, ＂aar＂, ＂aar＂, null, new Date(), new File(＂build/outputs/aar＂, ＂lib-production-release.aar＂))
　　devArchives new DefaultPublishArtifact(＂dev＂, ＂aar＂, ＂aar＂, null, new Date(), new File(＂build/outputs/aar＂, ＂lib-dev-release.aar＂))
　　}
　　//上传调试版aar
　　task uploadDev(type: Upload, group: ＂upload＂, dependsOn: ＂assembleDevRelease＂) {
　　setConfiguration(project.configurations.getByName(＂devArchives＂))
　　repositories.mavenDeployer {
　　pom.groupId = MIGU_GROUP
　　pom.artifactId = DEV_MAVEN.ARTIFACT_ID
　　pom.version = DEV_MAVEN.VERSION_NAME
　　repository(url: uri(＂../repos＂)) {
　　}
　　}
　　}
　　//上传正式版aar
　　task uploadPro(type: Upload, group: ＂upload＂, dependsOn: ＂assembleProRelease＂) {
　　setConfiguration(project.configurations.getByName(＂proArchives＂))
　　repositories.mavenDeployer {
　　pom.groupId = MIGU_GROUP
　　pom.artifactId = PRODUCTION_MAVEN.ARTIFACT_ID
　　pom.version = PRODUCTION_MAVEN.VERSION_NAME
　　repository(url: uri(＂../repos＂)) {
　　}
　　}
　　}
　　生成的两个任务分别用于上传联调版和正式版。为了每次上传都是最新版本，task可以依赖于assembleXXX后执行，如dependsOn: ‘assembleProRelease’