一、升級(jí)必備操作
- 修改完核心代碼后,一共還需要做以下幾步:
- 1、修改spec文件(修改s.version,s.description等)
- 2、pod install (使Example與pod下來(lái)的庫(kù)產(chǎn)生關(guān)聯(lián))
- 3、提交本地倉(cāng)庫(kù)代碼至遠(yuǎn)程倉(cāng)庫(kù)
- 4、打標(biāo)簽,并提交至遠(yuǎn)程
- 5、驗(yàn)證spec,并提至私有索引庫(kù)
二、Fastlane
1、簡(jiǎn)介
Fastlane是一個(gè)ruby腳本集合,它可以按照我們指定的路線,在指定位置執(zhí)行我們所要執(zhí)行的操作。這里我們稱(chēng)這樣的路線為「航道(lane)」,這樣的操作稱(chēng)為「Action」
Action是Fastlane自動(dòng)化流程中的最小執(zhí)行單元,用來(lái)執(zhí)行Fastlane腳本中的命令,關(guān)于更多的描述可以到Actions - fastlane docs查看,里面也介紹了常用的action有哪些,順帶附上action的源碼地址,這個(gè)源碼在后面自定義起參考作用
2、 安裝
- 確保ruby為最新版本
brew update
brew install ruby
安裝fastlane
sudo gem install -n /usr/local/bin fastlane查看當(dāng)前fastlane版本
fastlane --version查看所有action
fastlane actions
三、fastlane初始化
cd到你的本地組件倉(cāng)庫(kù)的根目錄
- 初始化fastlane
fastlane init
不過(guò)這個(gè)步驟對(duì)我們來(lái)說(shuō)可以跳過(guò),在init后提示你輸入一些東西,包括上傳需要用到的APPLE ID什么的一堆東西,由于我們并不涉及這些,所以我們使用更方便的方式
# 創(chuàng)建一個(gè)fastlane文件夾
# 進(jìn)入fastlane目錄
# 創(chuàng)建一個(gè)Fastfile文件
mkdir fastlane
cd fastlane
touch Fastfile

1、修改Fastfile
desc 'EmojiToolModelTool 航道用來(lái)自動(dòng)化升級(jí)維護(hù)私有庫(kù)'
lane :EmojiToolModelTool do |options|
tagNum = options[:tag]
podspecName = options[:specName]
# 航道上需要執(zhí)行的操作
# 具體action到 https://docs.fastlane.tools/actions 上面查找
# 這里的路徑以倉(cāng)庫(kù)根目錄為準(zhǔn)
# 1、修改spec文件(修改s.version,s.description等)
# 2、pod install (使Example與pod下來(lái)的庫(kù)產(chǎn)生關(guān)聯(lián))
cocoapods(
clean: true,
podfile: "./Example/Podfile"
)
# 3、提交本地倉(cāng)庫(kù)代碼至遠(yuǎn)程倉(cāng)庫(kù)
git_add(path: ".")
git_commit(path: ".", message: "upgrade repo")
push_to_git_remote
# 4、打標(biāo)簽,并提交至遠(yuǎn)程
add_git_tag(
tag: tagNum
)
push_git_tags
# 5、驗(yàn)證spec,并提至私有索引庫(kù)
pod_lib_lint(allow_warnings: true)
# 因?yàn)楸镜厮饕龓?kù)repo的名字是基本上不會(huì)去改變的,所以這里直接寫(xiě)死 XDSpecs
# podspec的名字需要由外界傳入
pod_push(path: "#{podspecName}.podspec", repo: "XDSpecs", allow_warnings: true)

end
2 、驗(yàn)證Fastfile
fastlane lanes

3、執(zhí)行fastlane
需要在組件倉(cāng)庫(kù)的根目錄下執(zhí)行,進(jìn)入到fastlane的同級(jí)目錄下
cd EmojiToolModel

- 3.1 然后執(zhí)行
#EmojiToolModelTool : 是你自定義的航道名稱(chēng)(在上面修改Fastfile里定義的名稱(chēng))
#tag : 是你要打的tag(tag要與spec文件的tag一致,注意這里不能存在已經(jīng)存在的tag,如果存在會(huì)報(bào)錯(cuò),后面會(huì)說(shuō))
#EmojiToolModel : 是你定義的spec文件名稱(chēng)
fastlane EmojiToolModelTool tag:0.1.1 specName:EmojiToolModel

四、自定義Action
- 以上的過(guò)程已經(jīng)可以完成一整個(gè)自動(dòng)化更新了,但是有一點(diǎn)需要注意的是,這個(gè)輸入的tag可能會(huì)面臨一個(gè)問(wèn)題,那就是本地和遠(yuǎn)程都可能已經(jīng)存在,即發(fā)生沖突,這個(gè)時(shí)候我們可以選擇自動(dòng)刪除本地和遠(yuǎn)程沖突的那個(gè)tag,再重新上傳當(dāng)前tag
1、創(chuàng)建一個(gè)新的action
fastlane new_action

-
完成后fastlane目錄下就會(huì)多出一個(gè)名為actions的文件夾,里面存放的就是你自定義action
屏幕快照 2018-06-05 17.11.02.png
2、編輯自定義action
打開(kāi)remove_git_tag.rb,開(kāi)始自定義我們的action吧,什么?不會(huì)語(yǔ)法怎么辦?可以參考別人的嘛,上面給出的action的源碼地址就有用武之地了,比如pod_push。這里我直接貼出我已經(jīng)完成的主要代碼
module Fastlane
module Actions
module SharedValues
REMOVE_TAG_CUSTOM_VALUE = :REMOVE_TAG_CUSTOM_VALUE
end
class RemoveTagAction < Action
def self.run(params)
# 這里寫(xiě)要執(zhí)行的操作
# params[:參數(shù)名稱(chēng)] 參數(shù)名稱(chēng)與下面self.available_options中的保持一致
tagName = params[:tag]
isRemoveLocalTag = params[:rL]
isRemoveRemoteTag = params[:rR]
# 定義數(shù)組 添加需要執(zhí)行的命令
cmds = []
# 刪除本地標(biāo)簽
if isRemoveLocalTag
cmds << "git tag -d #{tagName} "
end
# 刪除本地標(biāo)簽
if isRemoveRemoteTag
cmds << " git push origin :#{tagName}"
end
# 執(zhí)行數(shù)組里的命令
result = Actions.sh(cmds.join('&'))
UI.success("Successfully remove tag #{tagName}")
return result
end
def self.description
"刪除本地和遠(yuǎn)程的標(biāo)簽!!!"
end
def self.details
# Optional:
# this is your chance to provide a more detailed description of this action
"使用這個(gè)action,來(lái)刪除本地和遠(yuǎn)程沖突的tag"
end
def self.available_options
# Define all options your action supports.
# Below a few examples
[
# tagName : 標(biāo)簽名稱(chēng) description : 描述 optional : 是否可選 is_string : 是否是字符串
FastlaneCore::ConfigItem.new(key: :tag,
description: "刪除的標(biāo)簽名稱(chēng)",
optional: false,
is_string: true),
# rL(remove Local) : 標(biāo)簽名稱(chēng) description : 描述 optional : 是否可選 is_string : 是否是字符串
FastlaneCore::ConfigItem.new(key: :rL,
description: "是否刪除本地標(biāo)簽",
optional: true,
is_string: false,
default_value: true),
# rR(remove Remote) : 標(biāo)簽名稱(chēng) description : 描述 optional : 是否可選 is_string : 是否是字符串
FastlaneCore::ConfigItem.new(key: :rR,
description: "是否刪除遠(yuǎn)程標(biāo)簽",
optional: true,
is_string: false,
default_value: true)
]
end
def self.output
# Define the shared values you are going to provide
# Example
[
['REMOVE_TAG_CUSTOM_VALUE', 'A description of what this value contains']
]
end
def self.return_value
nil
# If your method provides a return value, you can describe here what it does
end
def self.authors
# So no one will ever forget your contribution to fastlane :) You are awesome btw!
["CodeST"]
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、查看action描述
- 驗(yàn)證我們寫(xiě)的這個(gè)action是否有錯(cuò)
fastlane action remove_tag
屏幕快照 2018-06-05 17.23.04.png
- 驗(yàn)證成功后可以完善自己的
fastlane
- 新增3.1
desc 'EmojiToolModelTool 航道用來(lái)自動(dòng)化升級(jí)維護(hù)私有庫(kù)'
lane :EmojiToolModelTool do |options|
tagName = options[:tag]
podspecName = options[:specName]
# 航道上需要執(zhí)行的操作
# 具體action到 https://docs.fastlane.tools/actions 上面查找
# 這里的路徑以倉(cāng)庫(kù)根目錄為準(zhǔn)
# 1、修改spec文件(修改s.version,s.description等)
# 2、pod install (使Example與pod下來(lái)的庫(kù)產(chǎn)生關(guān)聯(lián))
cocoapods(
clean: true,
podfile: "./Example/Podfile"
)
# 3、提交本地倉(cāng)庫(kù)代碼至遠(yuǎn)程倉(cāng)庫(kù)
git_add(path: ".")
git_commit(path: ".", message: "upgrade repo")
push_to_git_remote
# 3.1 驗(yàn)證tag是否存在,如果存在,應(yīng)該深處本地標(biāo)簽和遠(yuǎn)程標(biāo)簽
if git_tag_exists(tag: tagName)
UI.success("發(fā)現(xiàn)tag:#{tagName} 已經(jīng)存在,即將執(zhí)行,刪除操作??")
remove_tag(tag:tagName)
end
# 4、打標(biāo)簽,并提交至遠(yuǎn)程
add_git_tag(
tag: tagName
)
push_git_tags
# 5、驗(yàn)證spec,并提至私有索引庫(kù)
pod_lib_lint(allow_warnings: true)
# 因?yàn)楸镜厮饕龓?kù)repo的名字是基本上不會(huì)去改變的,所以這里直接寫(xiě)死 XDSpecs
# podspec的名字需要由外界傳入
pod_push(path: "#{podspecName}.podspec", repo: "XDSpecs", allow_warnings: true)
end
5 . 最后驗(yàn)證
查看已經(jīng)存在的tag
git tag-
用工具刪除已經(jīng)存在的tag
fastlane EmojiToolModelTool tag:0.1.3 specName:EmojiToolModel
屏幕快照 2018-06-05 18.00.52.png


