Appium-Drivers-UIAutomation Safari Launcher(iOS)

水深无声 2023-01-15 03:47 152阅读 0赞

### SafariLauncher Setup Instructions ###

*   *   *   *   *  Automatic SafariLauncher configuration
                 *  Manual SafariLauncher configuration

Running mobile web tests on iOS real devices with iOS 9.3 or below, using Instruments, requires the introduction of a third-party app, SafariLauncher. This is necessary because with Instruments there is no way to start the Safari app on the device. The `SafariLauncher` app just launches, and then launches Safari. Simple!

运行移动Web测试在iOS真机设备上iOS9.3或更低版本，
    使用仪器，需要引入第三方app，SafariLauncher.
    必要的原因是无法在设备上启动Safari应用程序，
    SafariLauncher app仅启动，
    然后启动Safari,简单

In some configurations, Appium is able to automatically build, sign, and install `SafariLauncher` as it needs, and there is nothing else necessary to be done. If, however, this is not the case, as is more often so with later versions of Xcode, the following configuration needs to be done before Safari tests on real devices can be successfully run.

在一些配置中，Appium可以根据需要自动开发，
    签名，和安装SafariLauncher，没有其他必要做的。
    但如果情况并非如此，
    与Xcode的版本更高，
    在实际设备上上成功运行Safari测试之前，需进行以下配置，
    在真机上可以成功运行

##### Automatic SafariLauncher configuration #####

The only thing needed for automatic `SafariLauncher` configuration is to create a provisioning profile that can be used to deploy the `SafariLauncher` App. This requires, in particular, a wildcard certificate, which is not possible if your Apple developer account is a free one. If that is the case, skip to the manual configuration below.

自动配置`SafariLauncher`所需唯一的事情是创建一个可用于部署'SafariLauncher'app

To create a profile for the launcher go into the Apple Developers Member Center and:

创建启动器的文件，请键入apple开发者部分中心和以下：

*  **Step 1**: Create a new App Id and select the WildCard App ID option and set it to “\*”
 *  **Step 2**: Create a new Development Profile and for App Id select the one created in step 1.
 *  **Step 3**: Select your certificate(s) and device(s) and click next.
 *  **Step 4**: Set the profile name and generate the profile.
 *  **Step 5**: Download the profile and open it with a text editor.
 *  **Step 6**: Search for the UUID and the string for it is your identity code.

Now simply include your UDID and device name in your desired capabilities:

现在只需将UDID和设备名称包含在您所需的功能中：

{ 
      udid: '...',
      deviceName: '...',
      platformName: 'iOS',
      platformVersion: '9.3',
      browserName: 'Safari'
    }

##### Manual SafariLauncher configuration #####

Note: This procedure assumes you have Xcode 7.3 or 7.3.1.

It is possible to use the version of SafariLauncher that comes with the appium-ios-driver, but if you do, each time you update Appium the procedure will have to be done again.

注意：假设你的Xcode是7.3或7.3.1
    可以使用appium-ios-driver附带的SafariLauncher版本，
    如果这样做，每次更新appium时都必须再次执行

To get a local copy of `SafariLauncher`, first clone it from GitHub:

git clone https://github.com/snevesbarros/SafariLauncher.git

Once you have a local copy of the source code for the `SafariLauncher` app, open Xcode and then open the `SafariLauncher` project

一旦你有了SafariLanucher应用程序源码的本地副本，
    打开Xcode然后打开SafariLauncher project

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTU3NjE0Ng_size_16_color_FFFFFF_t_70]  
In the `SafariLauncher` target pane you will see an error, saying that there needs to be a provisioning profile for this app  
`目标窗口中将看到一个错误，表示需要为此程序设置配置文件`![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTU3NjE0Ng_size_16_color_FFFFFF_t_70 1]  
In order to fix this, you first need to enter a “Bundle Identifier” for the app. The default expected by Appium is `com.bytearc.SafariLauncher`, but this might not be available for you to build. In that case, choose something else, and make note of it. Then choose a “Team”, and allow the provisioning profile to be created

为了解决这个问题，首先你需要为应用程序输入一个“Bundle Identifier”。
    默认值预设`com.bytearc.SafariLauncher`，
    但这可能无法供您开发，此时选择别的其他并记录。
    然后选择一个`Team`并允许配置文件创建

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTU3NjE0Ng_size_16_color_FFFFFF_t_70 2]  
Finally, make sure your device is connected to the computer, and choose it as the target

最后，确保你的设备已连接电脑，并选择作为目标

![在这里插入图片描述][20210421155858830.png]

And run the build and install actions to compile the app and push it onto your device

运行建立和安装操作去编译app并推送到你的设备上

![在这里插入图片描述][20210421155923410.png]  
Now you have a working `SafariLauncher` on your device. The app itself is a plain screen that will launch `Safari` at the click of a button

现在你的设备上就有一个`SafariLauncher`在你的设备上运行。
    这个程序本身就是一个普通的屏幕，
    点击一个按钮就可以启动`Safari`

![在这里插入图片描述][20210421160338155.png]  
The last step is only necessary if you chose a bundle identifier for the app that is different from the default (`com.bytearc.SafariLauncher`). If you did, it is necessary to send that to Appium when creating a session, using the `bundleId` desired capability:

只有在为应用选择与默认不同的捆绑标识时，
    最后一步才是必要的，
    如果这样做，
    在创建会话时，需要使用bundleld所需的功能将其发送到Appium

{ 
      udid: '...',
      deviceName: '...',
      platformName: 'iOS',
      platformVersion: '9.3',
      browserName: 'Safari',
      bundleId: 'com.imurchie.SafariLauncher'
    }

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTU3NjE0Ng_size_16_color_FFFFFF_t_70]: /images/20221022/cd079622a5af4974844d2558c78be281.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTU3NjE0Ng_size_16_color_FFFFFF_t_70 1]: /images/20221022/f8f108242998426fa68b98ff9d6b8d43.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTU3NjE0Ng_size_16_color_FFFFFF_t_70 2]: /images/20221022/3bd552c3dc864c6cac7226ab2774bfb2.png
[20210421155858830.png]: /images/20221022/6ce42a7841db44ecb78f7f5fee76bde2.png
[20210421155923410.png]: /images/20221022/9923e7271e324461b0ed334b55c5cbd5.png
[20210421160338155.png]: /images/20221022/2536fb6453d44bcfb295cf3eef8cf864.png