fastlane 中的一些疑问
最近项目中用到了fastlane 打包, Fastfile 如下
default_platform(:ios)
platform :ios do
scheme_name = "DF_HWSQ"
app_version = get_version_number(target: scheme_name)
app_build = get_build_number
app_version_build = "#{app_version}(#{app_build})"
time_string = Time.now.strftime('%Y-%m-%d_%H:%M:%S')
app_ipa_name = "#{scheme_name}_#{app_version_build}_#{time_string}"
desc "打包命令:fastlane pgy config:DEV"
lane :pgy do |option|
#依照装备打包
gym(
scheme: "#{scheme_name}",
export_method: "ad-hoc",#打包所选的种类(就是App Store,生产测试,企业,开发测试那四种), app-store,ad-hoc,enterprise,development
output_directory: "./build",
output_name: "#{app_ipa_name}.ipa",
configuration: option[:config],
)
#上传蒲公英
pgyer(
api_key: "xxxx",
update_description: scheme_name
)
#清零构建产物
clean_build_artifacts
end
end
问题1, lane 这儿如同一个要害字或是Class. 实际上却是个办法, 这个是怎么完成的.
自定义lane的写法如下
default_platform(:ios)
platform :ios do
lane :custom_lane do
# add actions here: https://docs.fastlane.tools/actions
end
end
实际上,lane
是一个 Ruby 办法,在 Fastlane 中定义为一个特别的办法。在 Fastfile 文件中定义一个 lane
时,实际上是在调用 Fastlane 中特定的 lane
办法,并传递您指定的 lane
名称和操作代码块作为参数。
翻开brew 装置目录 /usr/local/Cellar, 在 fastlane 中的fast_file.rb 能够找到lane 的完成
def lane(lane_name, &block)
UI.user_error!("You have to pass a block using 'do' for lane '#{lane_name}'. Make sure you read the docs on GitHub.") unless block
self.runner.add_lane(Lane.new(platform: self.current_platform,
block: block,
description: desc_collection,
name: lane_name,
is_private: false))
@desc_collection = nil # reset the collected description again for the next lane
end
问题2, pgyer 这个办法,没有传递参数. 那它是怎么知道需求上传的ipa文件的地址的.
仍是从源码来分析
找到找到fastlane-plugin-pgyer
的源码途径, brew装置目录下找到 /usr/local/Cellar/fastlane/2.211.0_2/libexec/gems/fastlane-plugin-pgyer-0.2.5
在目录下找到 pgyer_action.rb
文件.
有这么一段代码
FastlaneCore::ConfigItem.new(key: :ipa,
env_name: "PGYER_IPA",
description: "Path to your IPA file. Optional if you use the _gym_ or _xcodebuild_ action. For Mac zip the .app. For Android provide path to .apk file",
default_value: Actions.lane_context[SharedValues::IPA_OUTPUT_PATH],
optional: true,
verify_block: proc do |value|
UI.user_error!("Couldn't find ipa file at path '#{value}'") unless File.exist?(value)
end,
conflicting_options: [:apk],
conflict_block: proc do |value|
UI.user_error!("You can't use 'ipa' and '#{value.key}' options in one run")
end),
这儿的configItem 就是pgy上传的ipa参数, 在这段代码中,PGYER_IPA
用来表示用户传递给 pgyer
动作的 IPA 文件的途径。如果用户没有传递该值,那么该参数的默认值就是通过 lane_context
获取的 SharedValues::IPA_OUTPUT_PATH
环境变量的值。
lane_context
是 fastlane 中的一个 Hash 目标,它是用来在 fastlane 动作之间共享数据的。它存储了当时 fastlane 履行过程中的一些要害信息,比方输出文件途径、代码签名装备等等。当你需求在一个 fastlane 动作中拜访另一个 fastlane 动作的输出成果时,能够通过 lane_context
来完成数据共享。
例如,在上面的代码中,咱们通过 Actions.lane_context[SharedValues::IPA_OUTPUT_PATH]
来获取当时 fastlane 履行过程中生成的 IPA 文件的输出途径,然后将其作为 PGYER_IPA
参数的默认值。
很明显了, 此前的gym 应该对这个IPA_OUTPUT_PATH
赋了值, 继续验证一下.
grep -i -r "IPA_OUTPUT_PATH" /usr/local/Cellar/fastlane/2.211.0_2/libexec/gems/fastlane-2.212.2
找到对IPA_OUTPUT_PATH
赋值的文件, 其途径是 /usr/local/Cellar/fastlane/2.211.0_2/libexec/gems/fastlane-2.212.2/fastlane/lib/fastlane/actions/build_app.rb
Fastfile 中的 gym
就是 alias for build_app
在build_app.rb 中找到
clip1:
if File.extname(absolute_output_path) == ".ipa"
absolute_dsym_path = absolute_output_path.gsub(/.ipa$/, ".app.dSYM.zip")
Actions.lane_context[SharedValues::IPA_OUTPUT_PATH] = absolute_output_path
ENV[SharedValues::IPA_OUTPUT_PATH.to_s] = absolute_output_path # for deliver
elsif File.extname(absolute_output_path) == ".pkg"
absolute_dsym_path = absolute_output_path.gsub(/.pkg$/, ".dSYM.zip")
Actions.lane_context[SharedValues::PKG_OUTPUT_PATH] = absolute_output_path
ENV[SharedValues::PKG_OUTPUT_PATH.to_s] = absolute_output_path # for deliver
end
gym
操作将 absolute_output_path
赋值到 lane_context
的 IPA_OUTPUT_PATH
中.
继续找 absolute_output_path
clip2:
gym_output_path = Gym::Manager.new.work(values)
if gym_output_path.nil?
UI.important("No output path received from gym")
return nil
end
absolute_output_path = File.expand_path(gym_output_path)
Gym::Manager
是 fastlane 中内置的一个类,用于管理 gym
的操作。Gym::Manager.new
创立一个新的 Gym::Manager
目标,work
办法用于履行 gym
的操作,回来生成的 .ipa
文件的途径。
that explains it.