本文是在 iOS使用Jenkins自动打包+上传到 fir+钉钉通知 的基础上做的改造。
研究此项改造，是由于一次 fir-cli 插件版本落后了，导致上传 ipa 包失败，所以想把 ipa 包上传到阿里云，然后下载安装。
iOS使用Jenkins自动打包+上传到 fir+钉钉通知 使用的是 fastlane 自动打包，上传到阿里云替换掉上传到 fir 需要修改 fastlane 文件夹下的 Fastfile 文件。Fastfile 文件是使用 ruby 语言写的，使用阿里云的上传服务需要用到 aliyun-oss-ruby-sdk 工具。
aliyun-oss-ruby-sdk 使用方法
- 打开终端，执行命令：
sudo gem install aliyun-sdk - 打开 Fastfile 文件，在文件顶部输入
require 'aliyun/oss' - 注释掉 fir-cli 的命令和拼接下载链接的命令，然后使用下面的命令替换掉：
client = Aliyun::OSS::Client.new(
endpoint: 'http://xxx.com', # 您的站点 找运维要
access_key_id: 'xxx', # 您的id 找运维要
access_key_secret: 'xxx', # 您的秘钥 找运维要
cname: true) # cname 为 true，代表使用公司自己的域名，生成下载链接。否则，使用阿里云默认拼接的域名，生成下载链接。
bucket = client.get_bucket('xxx') # 存放app文件的目录，让运维给创建一下新的，专门存储 ipa 安装包。
fullPath = "#{output_directory}/#{output_name}"
# 开始上传文件。 output_name 为文件名，fullPath 为 ipa 文件的本地路径。answer 为 true or false。
answer = bucket.put_object("#{output_name}", :file => "#{fullPath}")
# cname 为 true 时，生成下载链接格式为 {endpoint}/{文件名}。
# cname 为 false 时,生成下载链接格式为：https://#{bucket_name}.#{endpoint}/{文件名}
download_url = "http://s1.xxx.com/#{output_name}"
完整脚本如下：
platform :ios do
desc "iOS 自动打包"
lane :SchemeName_Debug do |options|
scheme_name = "SchemeName"
output_directory = "./debug/"
custom_directory = options[:outputDirectory]
if !(custom_directory.nil? || custom_directory.empty?)
output_directory = custom_directory
end
puts "打包输出路径为 #{output_directory}"
buildNumber = get_build_number
output_name = "#{scheme_name}_#{buildNumber}_#{Time.now.strftime('%Y%m%d%H%M%S')}.ipa"
gym(scheme: scheme_name,
workspace: "Project.xcworkspace",
include_bitcode: false,
configuration: "Debug",
include_symbols: true,
export_method: "development",
output_directory: output_directory,
build_path: output_directory,
archive_path: output_directory,
output_name: output_name)
branchName = options[:branchName]
jobName = options[:jobName]
buildUser = options[:buildUser]
macUser = options[:macUser]
changeLog = options[:changeLog]
# 截断字符，因为钉钉消息体有限制：{"errcode":460101,"errmsg":"description: body 大小不合法;solution:请保持大小在 20000bytes 以内;"}
if changeLog.length > 500
changeLog = changeLog[0,497]
changeLog = "#{changeLog}..."
end
client = Aliyun::OSS::Client.new(
endpoint: 'http://xxx.com', # 您的站点 找运维要
access_key_id: 'xxx', # 您的id 找运维要
access_key_secret: 'xxx', # 您的秘钥 找运维要
cname: true) # cname 为 true，代表使用公司自己的域名，生成下载链接。否则，使用阿里云默认拼接的域名，生成下载链接。
bucket = client.get_bucket('xxx') # 存放app文件的目录，让运维给创建一下新的，专门存储 ipa 安装包。
fullPath = "#{output_directory}/#{output_name}"
# 开始上传文件。 output_name 为文件名，fullPath 为 ipa 文件的本地路径。answer 为 true or false。
answer = bucket.put_object("#{output_name}", :file => "#{fullPath}")
# cname 为 true 时，生成下载链接格式为 {endpoint}/{文件名}。
# cname 为 false 时,生成下载链接格式为：https://#{bucket_name}.#{endpoint}/{文件名}
download_url = "http://s1.xxx.com/#{output_name}"
# answer = fir_cli api_token:"xxx", need_release_id: true
# download_url = "https://hey.scandown.com/#{answer[:short]}?release_id=#{answer[:release_id]}"
puts "上传后的结果：#{answer}"
dingdingMsg = "打包结果通知：Jenkins 打包成功。Debug 开发包。\n打包者：#{buildUser}\n分支名:#{branchName}\n任务名:#{jobName}\n打包使用的是#{macUser}的电脑\n下载二维码链接:#{download_url} \n修改日志: \n#{changeLog} \n"
puts "打包结束时，输出文案：#{dingdingMsg}"
# 构造消息格式
text = {
"at": {
"isAtAll": false
},
"text": {
"content": "#{dingdingMsg}"
},
"msgtype": "text"
}
puts "发送的钉钉消息：#{text}"
dingTalk_url = "https://oapi.dingtalk.com/robot/send?access_token=xxx"
uri = URI.parse(dingTalk_url)
https = Net::HTTP.new(uri.host, uri.port)
https.use_ssl = true
request = Net::HTTP::Post.new(uri.request_uri)
request.add_field('Content-Type', 'application/json')
request.body = text.to_json
response = https.request(request)
puts "------------------------------"
puts "Response #{response.code} #{response.message}: #{response.body}"
end
end
上述脚本用到了阿里云的 Client 和 Bucket 命令，详细的使用方法可查看源码，使用终端打开路径如下：
~/.rvm/rubies/ruby-3.0.0/lib/ruby/gems/3.0.0/gems/aliyun-sdk-0.8.0/lib/aliyun/oss
oss.jpg
使用网页下载安装
使用阿里云上传后得到的下载链接，iPhone 设备可以下载 ipa 安装包，但不会自动安装。若希望像 fir.im 或者 pgyer 一样能自动下载安装，需要每一个 ipa 下载链接都有对应的 plist 文件，并配合网页来实现下载安装功能。实现方案参考：iOS 如何做扫码安装 。
实现该方案中，理论上可以分为以下几个步骤：
- Fastfile 脚本中将 ipa 文件上传到阿里云后，再用脚本创建一个 plist 文件，文件中的 software-package 对应的 url 设为对应的 ipa 下载链接，然后同样使用 Fastfile 脚本中上传到阿里云的方法，获取到 plist 文件的下载链接。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>items</key>
<array>
<dict>
<key>assets</key>
<array>
<dict>
<key>kind</key>
<string>software-package</string>
<key>url</key>
//这个地方写 ipa 下载链接
<string>http://s1.xxx.com/#{output_name}</string>
</dict>
<dict>
<key>kind</key>
<string>full-size-image</string>
<key>needs-shine</key>
<false/>
<key>url</key>
<string></string>
</dict>
<dict>
<key>kind</key>
<string>display-image</string>
<key>needs-shine</key>
<false/>
<key>url</key>
<string>安装过程显示图片</string>
</dict>
</array>
<key>metadata</key>
<dict>
<key>bundle-identifier</key>
<string>com.xianhenet.hunpopo</string>
<key>bundle-version</key>
<string>1.0</string>
<key>kind</key>
<string>software</string>
<key>title</key>
<string>packName</string>
</dict>
</dict>
</array>
</dict>
</plist>
- 请前端大佬写一个网页，并将该网页发布到服务器上，我们拿到网页链接后，将第1步得到的 plist 文件链接作为请求参数传给网页。网页内容如下：
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width; initial-scale=1.0">
<meta name="keywords" content="test" />
<meta name="description" content="" />
<title>测试包</title>
<link rel="stylesheet" type="text/css" href="style/css/mobile.css" />
</head>
<body>
<div class="doc">
<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
<p align="center"><a href="itms-services://?action=download-manifest&url=/*plist文件链接*/https://xxx/xxx.plist"><img alt="" src="images/icon.png" style="height:160px; width:160px"/></a></p>
<br/>
<br/>
</div>
</body>
</html>
- 将第2步的网页链接拼接上 plist 的下载链接(如：https://downloadPage.html?plistUrl=https://xxx/xxx.plist) 通过使用 Fastfile 脚本中的发送钉钉消息的方法发送到钉钉群里即可。
之所以说上面是理论步骤，是因为这只是一个思路。由于通过阿里云下载文件是要收费的，大概 470 元/1T。明显没有免费的 fir 和 pgyer 香啊。最终我的解决方案是将 pgyer上传 ipa 的方法也实现一下，当 fir 或 pgyer 出故障时，可以快速切换。
删除阿里云上的 ipa 文件
过往的 ipa 文件可以使用下面的 ruby 脚本删除：
require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
endpoint: 'http://xxx.com',
access_key_id: 'xxx',
access_key_secret: 'xxx',
cname: true)
bucket = client.get_bucket('xxx')
output_name = "xxx.ipa"
answer = bucket.delete_object("#{output_name}")
puts("#{answer}")
