Skip to content
This repository has been archived by the owner on Aug 2, 2019. It is now read-only.

Latest commit

 

History

History
116 lines (79 loc) · 4.87 KB

README.md

File metadata and controls

116 lines (79 loc) · 4.87 KB
Raw

#Android studio基于artifactory的maven私服一键deploy工具

OKDALM = One Key to Deploy Android Library to Maven

##适用范围

有公司内部的lib工程并希望（或已经）存放在公司maven私服，lib模块之间、app引用lib模块的方式使用maven方式进行依赖

尤其适合作者当前的项目结构：

+--------------------------+---------------------+------------------+
|   CommonLib              |     business1       |    business2     |
|        lib_module_1      |          app_1      |         app_1    |
|        lib_module_...    |          app_...    |         app_...  |
|        lib_module_n      |          app_n      |         app_n    |
+--------------------------+---------------------+------------------+

##作用

  • 规范代码管理：公共库专人维护
  • 便于使用Jenkins进行持续集成
  • 一条命令即可deploy发生修改的module及依赖该module的其它module，并立即生效
  • 可以按照工程中module依赖关系的顺序deploy all
  • 便于管理module是否进行deploy管理（通过是否在artifactory_version.properties中进行配置确定）

##使用方式

###涉及到的文件有

  • python_tools 文件夹 （新建：脚本库）
  • artifactory.gradle （新建：artifactory设置）
  • artifactory_version.properties （新建：module通过artifactory发布到maven的版本配置）
  • build.gradle （修改：工程的构建脚本，需要添加对artifactory的支持）
  • deploy.py （新建：deploy的入口，作者当前用的python版本为2.7.10，python3未测试）
  • gradle.properties （修改：添加deploy相关设置项）
  • 各module目录下的build.gradle文件 （修改：将module间的依赖改为maven方式）

###初次使用 假定当前lib工程名称为：CommonLib

  • 使用artifactory搭建maven私服

    • 这一步非常简单：只需下载最新版本的artifactory，解压文件，然后运行与你的平台对应的artifactory可执行文件即可

  • 复制以下文件到CommonLib根目录

    • python_tools 文件夹
    • artifactory.gradle
    • artifactory_version.properties
    • deploy.py

  • 修改build.gradle文件

    • 添加对artifactory.gradle的引用：

        apply from: "artifactory.gradle"

    • buildscript -> dependencies下添加

        classpath(group: 'org.jfrog.buildinfo', name: 'build-info-extractor-gradle', version: '4.1.1')

  • 修改CommonLib根目录的gradle.properties文件

    • 将以下内容复制到CommonLib/gradle.properties中，并进行相应的修改

        maven_groupId=your.group.id
  artifactory_user=admin
  artifactory_password=password
  artifactory_contextUrl=http://localhost:8081/artifactory
  artifactory_snapshot_repoKey=libs-snapshot-local
  artifactory_release_repoKey=libs-release-local
  version_prefix=

  • 修改CommonLib/artifactory_version.properties

    • 将demo里的lib版本号信息去除（lib_module_a等）
    • 将需要deploy到maven私服的module配置按照moduleName=versionName的方式进行配置（如：lib_module_a=1.0.0）

  • 执行命令将上一步配置的版本deploy到maven私服(snapshot版本)

      python deploy.py -a

  • 修改所有module中的依赖配置，从module依赖改为maven依赖的方式：

      compile project(':lib_module_a') -> compile "${maven_groupId}:lib_module_a:${lib_module_a}"
  or
  compile project(':lib_module_a') -> compile group:maven_groupId, name:'lib_module_a', version: lib_module_a

  • 执行命令发布正式版，（作为以后修改发布的最初始版本）

      python deploy.py -r -a

###后续使用

  • 当前为release版的module发生修改，发布snapshot版，将同时发布依赖该module的所有module

      python deploy.py module_name

  • 当前为snapshot版的module发生修改，发布snapshot版，将仅发布当前module，命令相同

      python deploy.py module_name

  • 当前为snapshot的module修改测试完毕，发布release版，将同时发布依赖该module的所有module

      python deploy.py -r module_name

  • 新建lib module

    • 在artifactory_version.properties中添加对应的版本号（否则将不能进行deploy）
    • deploy到maven私服：
      • python deploy.py -r -c module_name
    • 依赖该module的module使用maven方式添加依赖，版本号为上一步在gradle.properties中生成的版本号变量名
    • 再次deploy到maven私服：脚本自动将所有依赖该module的所有module deploy一遍
      • python deploy.py module_name
    • 测试&修改
    • deploy正式版：
      • python deploy.py -r module_name