iOS 测试 [Google EarlGrey] 0x00 安装及运行

八戒你干嘛

EarlGrey简介EarlGrey 是一个面向iOS apps源码的用户界面测试框架，让使用者可以编写清楚且简洁的测试。Google 已经在在其少数iOS应用上使用此框架进行功能测试，例如YouTube，日历，Photos，翻译，Play Music等在内的Google应用。
EarlGrey提供的主要特性如下：

• 强大的内建同步机制：使用EarlGrey构建测试用例后，在UI交互前，程序会自动等待动画，网络请求等事件。这更有利于测试人员编写测试用例，测试人员无需将程序进行sleep或wait来等待特定的测试场景；同时也方便维护测试用例，测试人员只需用程序描述测试步骤即可。一般来说，你无需考虑同步性，因为EarlGrey会自动同步界面交互，网络请求，主Dispatch Queue以及主NSOperationQueue。在测试中会有这样测试场景，当要进入下一个UI交互时你需要等待某些特定的事件发生，为了支持这样的场景，EarlGrey提供了同步相关的APIs让用户可以控制EarlGrey的同步行为。测试人员可以通过使用此类APIs提高测试用例的稳定性
  
• 可见性检测：所有用户可见元素上的交互。例如，尝试点击图片后面的按钮会导致测试立即失败。EarlGrey使用屏幕快照差异对比的方法(也叫做“screenshots diffs”)在与UI元素交互前确定其可见性。这样，你就可以确定对于EarlGrey与之交互的UI，用户可以看到并且也能与之交互。注意：进程外(比如系统产生的)的弹层或者其他对话框遮盖住UI会对这个过程产生干扰
  
• 灵活的设计：用户确定元素选中，交互，断言和同步的组件在设计上都是可扩展的。点击和滑动都是通过应用级的点击点击事件来实现的，并非使用元素级的事件处理器。在每一次UI交互前，EarlGrey会判断交互的元素是否可见而不是仅仅只出现在视图中即可。EarlGrey的UI交互模拟了真实用户与应用交互的方式，可以帮你找到和修复用户在使用应用时所遇到的同样的bug。
  
  

安装和运行先决条件为了EarlGrey能够正常运行，确保被测应用满足以下要求：

• 可以在所有支持设备上展现的正确的启动界面图片(参见iOS Developer Library，Launcher Files)
  
• 主UIApplicationDelegate实现了(UIWindow *)window属性(参见UIKit Framework Reference，window Property)
  
  

最后确保测试目标已启用断言(例如，不用设置NS_BLOCK_ASSERTIONS)
安装EarlGrey你可以通过两种方式添加EarlGrey到你的XCode项目中：使用CocoaPods，或者通过框架的形式。如果你想为EarlGrey贡献自己的代码，通过Github安装的EarlGrey.xcodeproj也集成了单元和功能测试。
CocoaPods 安装官方推荐通过CocoaPods安装EarlGrey
第一步：创建一个测试目标1 EarlGrey需要一个Test Target。由于EarlGrey修改了Test Target的Scheme和Build phases，建议创建一个独立的Test Target用来添加EarlGrey测试。如果还没有创建，那么可以在Xcode Project Navigator中选中项目，然后点击Editor > Add Target
2 在Add Target对话框中，选中 iOS > Test > iOS Unit Testing Bundle：


3 因为EarlGrey会使用到Schemes，所以Test Target必须有一个与之关联的Scheme。如果该Scheme是共享的会更好。如果你的Test Target没有Scheme，那么在Manage Schemes的对话框中，点击+按钮，在下拉框中选中目标。勾选Shared单选框，Container设为需要测试的应用。



注意：如果之前创建过Scheme，你需要执行一次才能让pod install命令选中。如果在执行pod install后你的Test Target的Scheme和Build Phase没有包含这些变更，请再次运行pod install。第二步：添加EarlGrey为依赖框架1 添加完Test Target后(如上图中BullsEyeEarlGreyTests)，你需要将EarlGrey添加为依赖框架。这样做，将EarlGrey作为测试依赖加入Podfile。
2 因为EarlGrey必须嵌入被测应用中，我们需要对测试目标的Build Phases和Scheme进行一些修改。将configure_earlgrey_pods.rb文件放入执行pod install命令的目录下。你需要在post_install钩子中调用这个脚本，使用项目名称，测试目标名称和xcscheme文件名。
如果CocoaPods版本为0.39.0，包含EarlGrey的Podfile如下：

1. PROJECT_NAME='BullsEye'
   
2. TEST_TARGET='BullsEyeEarlGreyTests'
   
3. SCHEME_FILE='BullsEyeEarlGreyTests.xcscheme'
   
4. 
   
5. xcodeproj PROJECT_NAME
   
6. target TEST_TARGET, :exclusive => true do
   
7.   pod 'EarlGrey'
   
8. end
   
9. 
   
10. post_install do | installer |
    
11.   load('configure_earlgrey_pods.rb')
    
12.   configure_for_earlgrey(installer, PORJECT_NAME, TEST_TARGET, SCHEME_FILE)
    
13. end

复制代码

如果CocoaPods版本为 1.0.0，包含EarlGrey的Podfile如下：

1. PROJECT_NAME='BullsEye'
   
2. TEST_TARGET='BullsEyeEarlGreyTests'
   
3. SCHEME_FILE='BullsEyeEarlGreyTests.xcscheme'
   
4. 
   
5. target TEST_TARGET do
   
6.   project PROJECT_NAME
   
7.   inherit! :search_paths
   
8.   pod 'EarlGrey'
   
9. end
   
10. 
    
11. post_install do | installer |
    
12.   load('configure_earlgrey_pods.rb')
    
13.   configure_for_earlgrey(installer, PORJECT_NAME, TEST_TARGET, SCHEME_FILE)
    
14. end

复制代码

• 如果有多个Targets和Schemes，每个Target/Scheme都需要调用configure_for_earlgrey方法
• :exclusive => true do或inherit! :search_paths标记是为了防止多次链接到Test Target引起冲突
  

第三步：执行pod install命令如果pod install命令执行成功，通过点击项目目录下的workspace文件(例如BullsEye.xcworkspace)在xcode中打开项目。
执行pod install命令如下：

1. pod install --verbose --no-repo-update

复制代码

--verbose 显示安装日志，--no-repo-update不做仓库更新
日志如下：

1. Preparing
   
2. [!] Unable to load a specification for the plugin `/Library/Ruby/Gems/2.0.0/gems/cocoapods-deintegrate-1.0.0.beta.1`
   
3. 
   
4. Analyzing dependencies
   
5. 
   
6. Inspecting targets to integrate
   
7.   Using `ARCHS` setting to build architectures of target `Pods`: (``)
   
8.   Using `ARCHS` setting to build architectures of target
   
9.   `Pods-BullsEyeEarlGreyTests`: (``)
   
10. 
    
11. Resolving dependencies of `Podfile`
    
12. 
    
13. Comparing resolved specification to the sandbox manifest
    
14.   A EarlGrey
    
15. 
    
16. Downloading dependencies
    
17. 
    
18. -> Installing EarlGrey (1.0.0)
    
19.   > Copying EarlGrey from
    
20.   `/Users/Hill/Library/Caches/CocoaPods/Pods/Release/EarlGrey/1.0.0-d2369` to
    
21.   `Pods/EarlGrey`
    
22.   - Running pre install hooks
    
23. 
    
24. Generating Pods project
    
25.   - Creating Pods project
    
26.   - Adding source files to Pods project
    
27.   - Adding frameworks to Pods project
    
28.   - Adding libraries to Pods project
    
29.   - Adding resources to Pods project
    
30.   - Linking headers
    
31.   - Installing targets
    
32.     - Installing target `Pods-BullsEyeEarlGreyTests` iOS 8.4
    
33.   - Running post install hooks
    
34. Checking and Updating BullsEye for EarlGrey.
    
35. Adding EarlGrey Framework Location as an Environment Variable
    
36. EarlGrey setup complete. You can use the Test Target : BullsEyeEarlGreyTests for EarlGrey testing.
    
37.     - Podfile
    
38.   - Writing Xcode project file to `Pods/Pods.xcodeproj`
    
39.     - Generating deterministic UUIDs
    
40.   - Writing Lockfile in `Podfile.lock`
    
41.   - Writing Manifest in `Pods/Manifest.lock`
    
42. 
    
43. Integrating client project
    
44. 
    
45. [!] Please close any current Xcode sessions and use `BullsEye.xcworkspace` for this project from now on.
    
46. 
    
47. Integrating target `Pods-BullsEyeEarlGreyTests` (`BullsEye.xcodeproj` project)
    
48.   Adding Build Phase 'Embed Pods Frameworks' to project.
    
49.   Adding Build Phase 'Copy Pods Resources' to project.
    
50.   Adding Build Phase 'Check Pods Manifest.lock' to project.
    
51.   - Running post install hooks
    
52.     - cocoapods-stats from
    
53.     `/Library/Ruby/Gems/2.0.0/gems/cocoapods-stats-0.6.2/lib/cocoapods_plugin.rb`
    
54. 
    
55. Sending stats
    
56.       - EarlGrey, 1.0.0
    
57.     - cocoapods-stats from
    
58.     `/Library/Ruby/Gems/2.0.0/gems/cocoapods-stats-1.0.0.beta.3/lib/cocoapods_plugin.rb`
    
59. 
    
60. Sending stats
    
61.       - EarlGrey, 1.0.0
    
62.   Pod installation complete! There is 1 dependency from the Podfile and 1 total
    
63.   pod installed.
    

复制代码

点击workspace文件打开项目，目录结构如下，说明安装成功