UIAutomation Safari Launcher (iOS) · Appium 官方文檔

## SafariLauncher 安裝說明在 iOS 9.3 及以下的真機上使用 Instruments 運行移動端網頁測試，需要引入一個第三方 app [SafariLauncher](https://github.com/snevesbarros/SafariLauncher)。這是因為用 Instruments 不能在設備上啟動 Safari。而 `SafariLauncher` 啟動后會啟動 Safari。簡單吧！在一些配置下，Appium 可以在需要時自動構建、簽名并且安裝 `SafariLauncher`，不需要額外做什么。如果不行，很可能是因為新版本的 [Xcode](https://developer.apple.com/xcode/)，需要完成以下配置才能成功在真機上運行 Safari 測試。 ### 自動配置 SafariLauncher 只要新建一個用于發布 `SafariLauncher` 應用的 **provisioning profile** 就可以自動配置 `SafariLauncher`。特殊之處是需要一個通配符證書，而免費的蘋果開發者賬號不能創建通配符證書。所以免費賬號需要用下面的手動配置方法。創建 launcher 使用的 profile 需要進入 **Apple Developers Member Center** 然后： * **步驟 1:** 創建 **新的 App Id**，選擇通配符 App ID 選項并填寫為"*"。 * **步驟 2:** 創建 **新的 Development Profile** 關聯步驟 1 創建的 App Id。 * **步驟 3:** 選擇你的 **certificate(s) and device(s)** 然后點擊下一步。 * **步驟 4:** 填寫 profile 名稱然后 **generate the profile**。 * **步驟 5:** 下載 profile 用編輯器打開。 * **步驟 6:** 搜索 **UUID**，字符串是你的 **identity code**。現在只需在 desired capabilities 中填入你的 UDID 和 device name： ```js { udid: '...', deviceName: '...', platformName: 'iOS', platformVersion: '9.3', browserName: 'Safari' } ``` ### 手動配置 SafariLauncher **注意:** 這個過程假定你是 [Xcode](https://developer.apple.com/xcode/) 7.3 或 7.3.1。可以使用 [appium-ios-driver](https://github.com/appium/appium-ios-driver) 包含的 [SafariLauncher](https://github.com/snevesbarros/SafariLauncher) 版本，但是每次升級 Appium 后都必須重新做一遍。先從 [GitHub](https://github.com/) 克隆 `SafariLauncher` 得到本地拷貝： ```bash git clone https://github.com/snevesbarros/SafariLauncher.git ``` 在本地有了 `SafariLauncher` 應用的源碼后用 [Xcode](https://developer.apple.com/xcode/) 打開 `SafariLauncher` 項目 ![打開 SafariLauncher 項目](https://img.kancloud.cn/3a/42/3a42e6b5c2913284048f708eefe148e9_1920x1080.png) 在 `SafariLauncher` target 面板會看到應用需要 provisioning profile 的錯誤提示。 ![缺少 provisioning profile 錯誤](https://img.kancloud.cn/48/96/48965251141201d33398eed32c7292d8_1512x1048.png) 修復錯誤需要先輸入應用的 "Bundle Identifier"，默認情況 Appium 使用 `com.bytearc.SafariLauncher`。如果用這個不能構建就換一個并記下來。然后選擇 "Team"，接著允許創建 provisioning profile。 ![修復 provisioning profile 錯誤](https://img.kancloud.cn/98/a8/98a8e683d25675b3fa58372ddecbf877_1512x1048.png) 最后選擇連上電腦的設備作為目標 ![選擇設備](https://img.kancloud.cn/75/2a/752a3554becb46f4c9d216af9ac4196f_282x70.png) 執行 "Run"，構建后安裝 app 到你的設備上 ![運行 SafariLauncher](https://img.kancloud.cn/78/24/78242bbf20a16f3b6abc910e833f2b67_546x127.png) 現在 `SafariLauncher` 可以在你的設備上工作了。app 只有一個簡單的頁面，點擊按鈕會啟動 `Safari` ![SafariLauncher on device](https://img.kancloud.cn/0f/c2/0fc277bc7ff118093fb72a2f5f32c835_162x288.png) 最后一步只有在你沒有使用默認 bundle identifier(`com.bytearc.SafariLauncher`) 的情況下才需要。Appium 在創建會話時需要通過 `bundleId` desired capability 知道你使用的 bundle identifier： ```js { udid: '...', deviceName: '...', platformName: 'iOS', platformVersion: '9.3', browserName: 'Safari', bundleId: 'com.imurchie.SafariLauncher' } ```