iOS-组件化开发- 自动化

在上一篇制作私有库（组件）的过程中，使用的命令有很多，以下我们就使用自动化的方式提交推送私有组件。

Fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. It handles all tedious tasks, like generating screenshots, dealing with code signing, and releasing your application.
简而言之，就是一堆ruby脚本集合，使用Actions机制，实现自动化。

• 安装

  • $ gem install fastlane -NV
  • 或
  • $ brew cask install fastlane

• 创建

  标准创建，是使用$ fastlane init

  此处，我们是简单创建

  • 在私有库（组件）的根目录创建fastlane文件夹和Fastfile文件
    

    

    36.png

  • 配置Fastfile文件

    # 描述航道
    desc "pod私有库自动化"
    
    # 定义航道, 航道名称是 repo
    lane :repo do |options|
    target = options[:target]
    tag = options[:tag]
    
    # 定义action
    
    #测试工程install
    # pod install
    cocoapods(
    podfile: "./Example/Podfile"
    )
    
    # 提交本地仓库
    # git add .
    git_add(path: ".")
    # git commit -m "xxx"
    git_commit(path: ".", message: "维护pod私有库")
    
    # 推送远程仓库
    # git push origin master
    push_to_git_remote
    
    # 判断是否有该版本， 如果有就先删除
    if git_tag_exists(tag:tag)
    UI.message("Found tag #{tag} , remove it")
    remove_tag(tag:tag)
    end
    
    # 打版本标签
    # git tag -a '#{tag}'
    add_git_tag(
    tag: tag
    )
    # 推送到远程库
    # git push --tags
    push_git_tags
    
    # 本地验证私有库
    # pod lib lint
    pod_lib_lint(allow_warnings: true)
    
    # 推送到私有管理库
    # pod repo push HQSpecs "#{targetName}.podspec"
    pod_push(path: "#{target}.podspec", repo: "HQSpecs", allow_warnings: true)
    
    end
    

    其中HQSpecs是私有库管理库

• 使用

  使用之前需注意以下几点：

  1. 必须cd到项目的根目录
  2. 需手动配置.podspec文件信息，例如：增加版本号
  3. 如果是首次创建私有库，则需手动关联远程库，如果是维护升级，则不需要

  • $ fastlane 航道名称 tag:版本号 target:组件库名称
  • 例：$ fastlane repo tag:0.1.1 target:HQMain
    
    

    37.png
    
    
    

    38.png

自定义Action

Action是Fastlane自动化流程中的最小执行单元，体现在Fastfile脚本中的一个个命令。上述所用的action，社区都有提供，但有时，我们所需的action没有提供，需我们手动创建

• 场景
  • 在制作私有库（组件）时，在执行手动或自动命令后，本地和远程的标签已经生成，如果此时验证没通过，修改正确后重新执行命令，此时的版本号如何处理？使用之前的版本会报错，增加一个新版本又不合适。
  • 解决方案： 删除本地和远程的版本号
  • $ git tag -d xxx & $ git push origin :xxx
• 尴尬
  • 在Fastlane社区中，并没有提供类似删除git版本号的action
  • 此时，需要自己创建所需的action
• 创建action

  • 执行命令：$ fastlane new_action

  • 输入自定义action的名称
    

    

    39.png
    
    
    

    40.png

  • 编辑remove_tag.rb

    • 核心代码如下：

    def self.run(params)
        tag = params[:tag]
        isRemoveRemoteTag = params[:isRemoveRemoteTag]
                  
        cmd = []
        cmd << "git tag -d #{tag} "
            
        if isRemoveRemoteTag
            cmd << " git push origin :#{tag}"
        end
          
        result = Actions.sh(cmd.join('&'));
        return result
    end
             
    def self.available_options
        [
            FastlaneCore::ConfigItem.new(key: :tag,
                                                   description: "被删除的标签",
                                                   optional: false,
                                                   is_string: true
                                                   ),
            FastlaneCore::ConfigItem.new(key: :isRemoveRemoteTag,
                                                   description: "是否删除远程标签",
                                                   optional: true,
                                                   is_string: false,
                                                   default_value: true),
        ]
    end
    

  • 查看remove_tag.rb编辑后的文档

    • $ fastlane action remove_tag
    

    41.png

• 使用

  • 重新修改Fastfile文件

    • 在添加版本之前，先判断该版本是否存在，如果存在，则先删除该版本后再添加

    if git_tag_exists(tag:tag)
        UI.message("Found tag #{tag} , remove it")
        remove_tag(tag:tag)
    end
    

  • 验证

    • $ fastlane repo tag:0.1.1 target:HQMain
    

    42.png