本文是在 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}")
