组件化-自动化实现

• 什么是自动化?

通过简单的一条命令, 去自动执行一组固定操作

• 自动化使用场景：

  测试
  打包上传审核
  分发
  ...

• Action机制

  Action是Fastlane自动化流程中的最小执行单元，体现在Fastfile脚本中的一个个命令
  比如：cocoapods, git_add等等，而这些命令背后都对应一个用Ruby编写的脚本。
  目前所有的Action
  fastlane actions
  描述链接
  https://docs.fastlane.tools/actions/Actions/
  源码链接
  https://github.com/fastlane/fastlane/tree/master/fastlane/lib/fastlane/actions
  常用action
  produce 创建可用于 iTunes Connect 和 Apple Developer Portal 的 iOS app。
  cert 自动创建和维护 iOS 代码签名证书。
  sigh 创建、更新、下载和修复 provisioning profiles。
  snapshot 自动将 App 屏幕截图本地化到每种设备上。
  frameit 将屏幕截图适配到适当的设备屏幕大小。
  gym 创建和打包 iOS app。
  deliver 上传屏幕截图、元数据和 App 到 App 商店。
  PEM 自动创建和更新 Push 通知的 profile。

• 使用概念

lane ：航道
Action机制
1.Action是Fastlane自动化流程中的最小执行单元，体现在Fastfile脚本中的一个个命令
2.比如：cocoapods, git_add等等，而这些命令背后都对应一个用Ruby编写的脚本。
3.目前所有的Action：fastlane actions
描述链接：https://docs.fastlane.tools/actions/Actions/
源码链接：https://github.com/fastlane/fastlane/tree/master/fastlane/lib/fastlane/actions
4.常用action
produce 创建可用于 iTunes Connect 和 Apple Developer Portal 的 iOS app。
cert 自动创建和维护 iOS 代码签名证书。
sigh 创建、更新、下载和修复 provisioning profiles。
snapshot 自动将 App 屏幕截图本地化到每种设备上。
frameit 将屏幕截图适配到适当的设备屏幕大小。
gym 创建和打包 iOS app。
deliver 上传屏幕截图、元数据和 App 到 App 商店。
PEM 自动创建和更新 Push 通知的 profile。

• 安装

  1.sudo gem install fastlane
  2.sudo gem install -n /usr/local/bin fastlane
  要求ruby版本最新
  brew update
  brew install ruby

• 实现

下图是自动化的实现步骤，那么4的pod install-7步骤都是以后重复要做的，那么这几步可进行自动化，1步骤的到4的修改spec还是跟之前一样的人工操作。

1.进入项目根目录
2.fastlane init
注意: 如果不需要实现上传等操作, 其实我们可以直接在工程目录下, 创建一个文件夹, 在文件夹内部创建"使用文件"
fastlane：创建Fastfile文件

Fastfile：

desc 'ManagerLib 使用这个航道, 可以快速的对自己的私有库, 进行升级维护'
lane :ManagerLib do |options|

tagName = options[:tag]
targetName = options[:target]

# 具体这个巷道上面执行哪些行为

# 1. pod install
cocoapods(
clean: true,
podfile: "./Example/Podfile"
)

# 2. git add .
git_add(path: ".")
#    git commit -m 'xxx'
git_commit(path: ".", message: "版本升级维护")
#    git push origin master
push_to_git_remote

# 验证tag是否存在,如果存在, 应该删除本地标签和远程标签
#if 判断标签是否存在
#    执行删除本地/远程标签
#end

if git_tag_exists(tag: tagName)
    UI.message("发现tag:#{tagName} 已经存在, 即将执行, 删除动作 🚀")
    remove_tag(tag:tagName)
end


# 3. git tag 标签名称
add_git_tag(
tag: tagName
)
#    git push --tags
push_git_tags

# 4. pod spec lint
pod_lib_lint(allow_warnings: true)
#    pod repo push XXXX xxx.podspec
pod_push(path: "#{targetName}.podspec", repo: "XMGFMSpecs", allow_warnings: true)

end

其中remove_tag属于自定义action，因为有些action, 并没有人提供，那么我们可以自己自定来满足我们的需求
1.操作指令fastlane new_action，响应后输入你的action的名字就可以生成新的action
2.remove_tag.rb内容如下：

module Fastlane
  module Actions
    module SharedValues
      REMOVE_TAG_CUSTOM_VALUE = :REMOVE_TAG_CUSTOM_VALUE
    end

    class RemoveTagAction < Action
      def self.run(params)
      
      tagName = params[:tag]
      isRemoveLocalTag = params[:rL]
      isRemoveRemoteTag = params[:rR]
      
      # 1. 先定义一个数组, 用来存储所有需要执行的命令
      
      cmds = []
      
      # 2. 往数组里面, 添加相应的命令
      # 删除本地标签
      # git tag -d 标签名称
      if isRemoveLocalTag
        cmds << "git tag -d #{tagName} "
      end
    
      # 删除远程标签
      # git push origin :标签名称
      if isRemoveRemoteTag
        cmds << " git push origin :#{tagName}"
      end

      #3. 执行数组里面的所有命令
     
      result = Actions.sh(cmds.join('&'));
      return result
      end


      def self.description
        "恩, 牛逼"
      end

      def self.details
        # Optional:
        # this is your chance to provide a more detailed description of this action
        "我们可以使用这个action ,来删除本地或者远程标签"
      end

      def self.available_options
        # Define all options your action supports. 
        
        # Below a few examples
        [

                FastlaneCore::ConfigItem.new(key: :tag,
                                             description: "需要被删除的标签名称",
                                             optional: false,
                                             is_string: true),
                FastlaneCore::ConfigItem.new(key: :rL,
                                             description: "是否需要删除本地标签",
                                             optional: true,
                                             is_string: false,
                                             default_value: true),
                FastlaneCore::ConfigItem.new(key: :rR,
                                             description: "是否需要删除远程标签",
                                             optional: true,
                                             is_string: false,
                                             default_value: true)
        ]
      end

      def self.output

      end

      def self.return_value
        nil
      end

      def self.authors
        # So no one will ever forget your contribution to fastlane :) You are awesome btw!
        ["你的名字"]
      end

      def self.is_supported?(platform)
        # you can do things like
        # 
        #  true
        # 
        #  platform == :ios
        # 
        #  [:ios, :mac].include?(platform)
        # 

        platform == :ios
      end
    end
  end
end

3.执行：fastlane lanes

控制台打印上图说明没有语法问题，但是不代表没有逻辑问题。
4.升级提交版本库：fastlane ManagerLib tag:版本号 target:工程名字

注意事项：
1.在制作私有库的过程中, 如果上一个标签已经存在, 再次创建则会报错
解决方案, 先判断标签是否存在, 如果存在, 则删除标签(本地/远程)
2.如果标签存在, 则删除本地/远程标签
标签存在：git_tag_exists
删除本地&远程标签：remove_tag(tagName: target_version, dR:true, dL:true)