每次要發測試包給同事或客戶,還在用 AirDrop、QQ、email 反覆傳輸嗎?其實只要設定一次,之後每次打包完就自動上傳,對方點一下連結就能裝。這篇記錄當時的設定過程。
需要一台能當伺服器的機器:公司內網主機或自己的 Mac 都可以。iOS 裝置不需要越獄,但必須已正常安裝過開發憑證。
以下以伺服器 IP 192.168.1.188、連接埠 8080 為例。
在 Xcode 開啟 target → Build Phases → 新增 Run Script Phase,貼上:

# compress application
if [ "${CONFIGURATION}" = "ad_hoc" ]; then
/bin/mkdir $CONFIGURATION_BUILD_DIR/Payload
/bin/cp -R $CONFIGURATION_BUILD_DIR/InstaSoccer.app $CONFIGURATION_BUILD_DIR/Payload
/bin/cp isoccer/icon/iTunesArtwork $CONFIGURATION_BUILD_DIR/iTunesArtwork
cd $CONFIGURATION_BUILD_DIR
# zip up the Payload directory
/usr/bin/zip -r InstaSoccer.ipa Payload iTunesArtwork
# 上傳到伺服器;若用本機開伺服器,可直接 cp 到 web 目錄
/usr/bin/scp InstaSoccer.ipa sshuser@192.168.1.188:~/ipa_publish/
fi
exit 0
這裡用 CONFIGURATION 名稱做判斷,只在 ad_hoc 設定下執行,避免 Debug 建置也跑一次上傳。ipa 的本質就是一個 zip,把 Payload 資料夾與 iTunesArtwork 壓起來即可,不需要倚靠 xcodebuild 的 archive 流程。
可以用 macOS 的 Web 共享,也可以一行 Python 開一個臨時伺服器。要求極低,能放幾個靜態檔案就行。
macOS 10.8 之後偏好設定裡已經沒有 Web 共享選項,需要手動修改設定檔才能開啟,做法請自行搜尋。
伺服器目錄需要兩個檔案:index.html 與 Info.plist。
只需改一處:把 "https://192.168.1.188:8080/Info.plist" 換成你自己的路徑。
<html>
<head>
<meta charset="utf-8" />
<title>Minroad 一鍵安裝</title>
</head>
<a style="font-size: 5em;"
href="itms-services://?action=download-manifest&url=https://192.168.1.188:8080/Info.plist">install</a>
</html>
itms-services 這個 URL scheme 是 OTA 安裝的入口,iOS 會去抓 manifest 再依內容下載 ipa。
需要修改 ipa 路徑、icon、版本號、bundle id 與程式名稱。注意 scp 之後的實際路徑要與這裡一致。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"https://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>
<string>https://192.168.1.188:8080/InstaSoccer.ipa</string>
</dict>
<dict>
<key>kind</key>
<string>display-image</string>
<key>needs-shine</key>
<true/>
<key>url</key>
<string>https://192.168.1.188:8080/Icon.png</string>
</dict>
<dict>
<key>kind</key>
<string>full-size-image</string>
<key>needs-shine</key>
<true/>
<key>url</key>
<string>https://192.168.1.188:8080/Icon.png</string>
</dict>
</array>
<key>metadata</key>
<dict>
<key>bundle-identifier</key>
<string>com.minroad.appid</string>
<key>bundle-version</key>
<string>2.8.2</string>
<key>kind</key>
<string>software</string>
<key>subtitle</key>
<string>一鍵安裝副標題</string>
<key>title</key>
<string>一鍵安裝程式名</string>
</dict>
</dict>
</array>
</dict>
</plist>
cd 到伺服器根目錄
nohup python -m SimpleHTTPServer 8080 > /dev/null 2>&1 &
接著用 iOS 裝置的 Safari 開啟 https://192.168.1.188:8080,就會看到安裝頁。
點一下安裝就會開始下載並安裝,之後把網址收藏起來,發測試包這件事就跟開發者無關了。
這套流程記錄的是 2013 年的做法,其中幾個環節現在已經改變,值得留意:
整體思路到今天仍然成立:打包階段自動化、透過 manifest 讓裝置 OTA 安裝、用一個穩定的網址對外提供。只是傳輸層與憑證要求變嚴格了。