snapshot 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e7362693e9f1c922a699d79e0d24fc6f5ec122ff
-  data.tar.gz: ac6413d4502074b7ddd4fb140228cb97dc2cb7b3
+  metadata.gz: 128e1fba0308d08053dbf2817d712d0c469ffa19
+  data.tar.gz: d60afccfcb75690522e94724d620f24dfc52b061
 SHA512:
-  metadata.gz: c0e83d4693307a5f46e9b7f120cc76c42ad7ee6aa7a3642db09b178c8bc756889b17565c93c2ce549311cd3a38b47ece61623bd9e17f9dea554d65c39190a6ff
-  data.tar.gz: 811d67b6f62e29423c84222269805b7e3e2effa328711933ab9447818aaa966fdd928be623199cf70542b966d132eda40e6d5ced86cdc439fbe38328aea3fb92
+  metadata.gz: 05fb00a65d26f783510606a53a862fc615944c9f6fe4fd747e99cd79094a4d82ccf9bae516ee3904cbf1e40092e75d577807d5d2958f43373eb7d00b37b36da8
+  data.tar.gz: 20c2b7848b7cb2bbf316d8dc286f688bc6d13a80c9b65b6464d9f914a371be58720f12d368cfbcb6ddf38390cd2498fb15fb9d405cb0e6a804ead7b60d4b4c9c

data/README.md

@@ -13,7 +13,10 @@
   <a href="https://github.com/KrauseFx/sigh">sigh</a> &bull; 
   <a href="https://github.com/KrauseFx/produce">produce</a> &bull; 
   <a href="https://github.com/KrauseFx/cert">cert</a> &bull; 
-  <a href="https://github.com/KrauseFx/codes">codes</a> 
+  <a href="https://github.com/KrauseFx/codes">codes</a> &bull;
+  <a href="https://github.com/fastlane/spaceship">spaceship</a> &bull;
+  <a href="https://github.com/fastlane/pilot">pilot</a> &bull;
+  <a href="https://github.com/fastlane/boarding">boarding</a>
 </p>
 -------
 
@@ -37,7 +40,7 @@ What's missing?
 
 You want them to look **perfect** and **gorgeous**. They should show the same screens on all devices in all languages.
 
-You have to manually create 20 (languages) x 4 (devices) x 5 (screenshots) = **400 screenshots**.
+You have to manually create 20 (languages) x 5 (devices) x 5 (screenshots) = **500 screenshots**.
 
 It's hard to get everything right!
 
@@ -51,6 +54,21 @@ This gem solves all those problems. It will run completely in the background - y
 
 Get in contact with the developer on Twitter: [@KrauseFx](https://twitter.com/KrauseFx)
 
+### Note: Support for UI Tests with Xcode 7
+
+Apple announced a new version of Xcode with support for UI Tests built in right into Xcode. This technology allows `snapshot` to be even better: Instead of dealing with UI Automation Javascript code, you will be able to write the screenshot code in Swift or Objective C allowing you to use debugging features like breakpoints.
+
+It's still work in progress and there are some technical difficulties I need to solve. 
+
+As a result, `snapshot` will be completely rewritten from ground up without changing its public API :rocket:
+
+**Why change to UI Tests?**
+
+- UI Automation is deprecated
+- UI Tests will evolve and support even more features in the future
+- UI Tests are much easier to debug
+- UI Tests are written in Swift or Objective C
+- UI Tests can be executed in a much cleaner and better way
 
 -------
 <p align="center">
@@ -73,9 +91,10 @@ Get in contact with the developer on Twitter: [@KrauseFx](https://twitter.com/Kr
 - Create hundreds of screenshots in multiple languages on all simulators
 - Configure it once, store the configuration in git
 - Do something else, while the computer takes the screenshots for you
-- Integrated with [`fastlane`](https://fastlane.tools) and [`deliver`](https://github.com/KrauseFx/deliver)
+- Integrates with [`fastlane`](https://fastlane.tools) and [`deliver`](https://github.com/KrauseFx/deliver)
 - Generates a beautiful web page, which shows all screenshots on all devices. This is perfect to send to Q&A or the marketing team
 - ```snapshot``` automatically waits for network requests to be finished before taking a screenshot (we don't want loading images in the App Store screenshots)
+- Support for advanced configuration, like preprocess macros or [prefilling of data](#prefilling)
 
 ##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
 
@@ -90,7 +109,7 @@ This gem automatically switches the language and device type and runs the automa
 - It takes **hours** to take screenshots
 - It is an integration test: You can test for UI elements and other things inside your scripts
 - Be so nice, and provide new screenshots with every App Store update. Your customers deserve it
-- You realise, there is a spelling mistake in one of the screens? Well, just correct it and re-run the script.
+- You realise, there is a spelling mistake in one of the screens? Well, just correct it and re-run the script
 - You get a great overview of all your screens, running on all available simulators without the need to manually start it hundreds of times
 - Easy verification that localizations fit into labels on all screen dimensions
 - Easy verification for translators (without an iDevice) that translations do make sense in real App context
@@ -101,7 +120,7 @@ I've been using many other solutions out there. Unfortunately none of them were
 
 - **UI Automation in Instruments**: Instruments can only run your app on one device in one language. You have to manually switch it.
 - **[ui-screen-shooter](https://github.com/jonathanpenn/ui-screen-shooter)**: This is the best alternative out there right now. It's based on AppleScript, you can not update it properly and there are quite some hacks in there. ```snapshot``` uses a very similar technique - just in a clean and maintainable Ruby gem.
-- **[Subliminal](https://github.com/inkling/Subliminal)**: A good approach to write the interaction code in Objective C. Unfortunately it has a lot of open issues with the latest release of Xcode. Also, it requires modifications of your Xcode project and schemes, which might break some other things.
+- **[Subliminal](https://github.com/inkling/Subliminal)**: A good approach to write the interaction code in Objective C. Unfortunately the project seems to be dead and doesn't work with the latest version of Xcode yet. Also, it requires modifications of your Xcode project and schemes, which might break some other things.
 
 # Installation
 
@@ -123,6 +142,7 @@ Here a few links to get started:
 - [Apple's official documentation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Conceptual/InstrumentsUserGuide/UsingtheAutomationInstrument/UsingtheAutomationInstrument.html)
 - [UI Automation: An Introduction (cocoamanifest.net)](http://cocoamanifest.net/articles/2011/05/uiautomation-an-introduction.html)
 - [Functional Testing UI Automation (mattmccomb.com)](http://www.mattmccomb.com/blog/2013/06/02/ios-functional-testing-with-uiautomation/)
+- [Cheat and use NSNotifications with HSUIAutomationCheat (github.com)](https://github.com/ConfusedVorlon/HSUIAutomationCheat)
 
 # Quick Start
 
@@ -310,7 +330,7 @@ To run a shell script, just use ```system('./script.sh')```.
 ```ruby
 setup_for_device_change do |device, udid, language|
   puts "Running #{language} on #{device}"
-  system("./popuplateDatabase.sh")
+  system("./populateDatabase.sh")
 end
 
 teardown_device do |language, device|
@@ -322,13 +342,6 @@ end
 ### Skip alpha removal from screenshots
 In case you want to skip this process, just add ```skip_alpha_removal``` to your ```Snapfile```.
 
-### Pass Bundle Identifier
-This is only required in case there is a problem automatically detecting it.
-
-```
-SNAPSHOT_APP_IDENTIFIER="com.krausefx.app" snapshot
-```
-
 ### Clear old screenshots
 
 If you add this line in your `Snapfile`, the previously generated screenshots will be deleted before generating new ones:
@@ -353,13 +366,16 @@ You can use the environment variable `SNAPSHOT_FORCE_DELETE` to stop asking for
 ## [`fastlane`](https://fastlane.tools) Toolchain
 
 - [`fastlane`](https://fastlane.tools): Connect all deployment tools into one streamlined workflow
-- [`deliver`](https://github.com/KrauseFx/deliver): Upload screenshots, metadata and your app to the App Store using a single command
+- [`deliver`](https://github.com/KrauseFx/deliver): Upload screenshots, metadata and your app to the App Store
 - [`frameit`](https://github.com/KrauseFx/frameit): Quickly put your screenshots into the right device frames
 - [`PEM`](https://github.com/KrauseFx/pem): Automatically generate and renew your push notification profiles
 - [`sigh`](https://github.com/KrauseFx/sigh): Because you would rather spend your time building stuff than fighting provisioning
 - [`produce`](https://github.com/KrauseFx/produce): Create new iOS apps on iTunes Connect and Dev Portal using the command line
 - [`cert`](https://github.com/KrauseFx/cert): Automatically create and maintain iOS code signing certificates
 - [`codes`](https://github.com/KrauseFx/codes): Create promo codes for iOS Apps using the command line
+- [`spaceship`](https://github.com/fastlane/spaceship): Ruby library to access the Apple Dev Center and iTunes Connect
+- [`pilot`](https://github.com/fastlane/pilot): The best way to manage your TestFlight testers and builds from your terminal
+- [`boarding`](https://github.com/fastlane/boarding): The easiest way to invite your TestFlight beta testers 
 
 ##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
 
@@ -367,7 +383,82 @@ You can use the environment variable `SNAPSHOT_FORCE_DELETE` to stop asking for
 
 If you want to add frames around the screenshots and even put a title on top, check out [frameit](https://github.com/fastlane/frameit).
 
-## Run in Continuous Integration
+## Prefilling
+
+Usually you want to mock your screenshot data to show the same content for all screenshots.
+
+There are 2 ways of doing this:
+
+#### Preprocessor macro
+Use the preprocessor macro `SNAPSHOT` to check if `snapshot` is currently running in your code. This enables you to add checks like this:
+
+```objective-c
+#ifdef SNAPSHOT
+// Your Code here
+#endif
+```
+
+Open your `Snapfile` and add `custom_build_args "GCC_PREPROCESSOR_DEFINITIONS='$(inherited) SNAPSHOT=1'"` to it.
+
+#### By pre-filling data/documents in the bundle
+
+As used by [MindNode](https://github.com/fastlane/examples/blob/master/MindNode/Snapfile) you can fill your bundle after building with demo data using your `Snapfile` to use it on run-time.
+
+```ruby
+example_files = './ExampleDocuments'
+folder_name = "ExampleDocuments"
+
+setup_for_device_change do |device, udid, language|
+  # This will make sure, all example documents are installed on the simulator
+
+  puts "Copying example files to .app"
+
+  app_path = "/tmp/snapshot/build/MindNode.app/"
+
+  FileUtils.mkdir_p(File.join(app_path, folder_name))
+
+  Dir.glob(File.join(example_files, '*.mindnode')).each do |example_path|
+    puts "Copying '#{example_path}' to .app container"
+    FileUtils.cp_r(example_path, File.join(app_path, folder_name)) rescue nil # in case the file already exists
+  end
+end
+```
+
+This is simple Ruby that gets executed **after** the app was built and **before** it is installed on the simulator.
+
+In your `Objective-C` code you can now load the documents from your bundle and copy them over to your `Documents` folder (if necessary).
+
+```objective-c
+#ifdef SNAPSHOT
+/** This method will take care of copying over the example documents from the app's bundle into the `Documents` directory */
++ (void)load
+{
+    static NSString *exampleFolderName = @"ExampleDocuments";
+    if ([[NSBundle mainBundle] pathForResource:exampleFolderName ofType:@""]) {
+        NSArray *filesToCopy = @[@"File1",
+                                 @"File2"];
+        NSString *documents = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
+        
+        for (NSString *currentFile in filesToCopy) {
+            NSString *from = [[NSBundle mainBundle] pathForResource:currentFile ofType:@"filetype" inDirectory:exampleFolderName];
+            if (from && documents) {
+                NSError *error = nil;
+                NSString *resultingFileName = [NSString stringWithFormat:@"%@.filetype", currentFile];
+                [[NSFileManager defaultManager] copyItemAtPath:from
+                                                        toPath:[documents stringByAppendingPathComponent:resultingFileName]
+                                                         error:&error];
+                
+                if (error) {
+                    NSLog(@"Error copying the example MindNode file: %@", error);
+                }
+            }
+        }
+    }
+}
+
+```
+
+## Run in Continuous Integration System
 If you want to run `snapshot` on your `Jenkins` machine (or any other CI-system), you might run into an `authorization` popup coming up.
 
 You can disable this dialog, running the following command:
@@ -386,7 +477,7 @@ Be aware: The file will be executed from the current directory, not the location
 
 ## Available language codes
 ```ruby
-["da-DK", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-US", "es-ES", "es-MX", "fi-FI", "fr-CA", "fr-FR", "id-ID", "it-IT", "ja-JP", "ko-KR", "ms-MY", "nl-NL", "no-NO", "pt-BR", "pt-PT", "ru-RU", "sv-SE", "th-TH", "tr-TR", "vi-VI", "cmn-Hans", "zh_CN", "cmn-Hant"]
+["cs-CZ", "da-DK", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-US", "es-ES", "es-MX", "fi-FI", "fr-CA", "fr-FR", "id-ID", "it-IT", "ja-JP", "ko-KR", "ms-MY", "nl-NL", "no-NO", "pt-BR", "pt-PT", "ru-RU", "sv-SE", "th-TH", "tr-TR", "vi-VI", "cmn-Hans", "cmn-Hant"]
 ```
 
 ## Use a clean status bar
@@ -434,6 +525,10 @@ When the app dies directly after the application is launched there might be 2 pr
 - The simulator is somehow in a broken state and you need to re-create it. You can use `snapshot reset_simulators` to reset all simulators (this will remove all installed apps)
 - You haven't enabled the correct architectures. Make sure you have the same architectures as in the example project of this repository. 
 
+### Snapshot throws an `Instruments Usage Error: Timed out waiting for device to boot: ...` error 
+
+This can happen when you launch `fastlane` or `snapshot` inside of a tool like `tmux`. Thankfully, Chris Johnsen wrote a fix to help us out, which you can find [here](https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard). Just follow the instructions at his repository, and launching the Simulator from `tmux` will work!
+
 ## Determine language in UI Automation script
 
 To detect the currently used localization in your Javascript file, use the following code:
@@ -450,6 +545,8 @@ var language = result.stdout.substring(0, result.stdout.length - 1);
 # License
 This project is licensed under the terms of the MIT license. See the LICENSE file.
 
+> This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.
+
 # Contributing
 
 1. Create an issue to discuss about your idea

data/lib/assets/SnapfileTemplate

@@ -32,6 +32,11 @@ screenshots_path "./screenshots"
 # By default, the latest version should be used automatically. If you want to change it, do it here
 # ios_version '8.1'
 
+# Comment out the line below to add a `SNAPSHOT` preprocessor macro
+# More information available: https://github.com/krausefx/snapshot#custom-args-for-the-build-command
+# custom_build_args "GCC_PREPROCESSOR_DEFINITIONS='$(inherited) SNAPSHOT=1'"
+
+
 # Custom Callbacks
 
 # setup_for_device_change do |device, udid, language|

data/lib/snapshot/dependency_checker.rb

@@ -40,7 +40,7 @@ module Snapshot
         Helper.log.info '#############################################################'
         Helper.log.info "# xctool is recommended to build the apps"
         Helper.log.info "# Install it using 'brew install xctool'"
-        Helper.log.info "# Falling back to xcode build instead "
+        Helper.log.info "# Falling back to xcodebuild instead "
         Helper.log.info '#############################################################'
       end
     end

data/lib/snapshot/page.html.erb

@@ -27,6 +27,7 @@
       }
       td {
         text-align: center;
+        min-width: 200px;
       }
       #overlay {
         position:fixed;
@@ -176,7 +177,7 @@
           overlay.style.display = "none";
         })
         
-      document.onkeypress = function(e) {
+      function keyPressed(e) {
         e = e || window.event;
         var charCode = e.keyCode || e.which;
         switch(charCode) {
@@ -196,9 +197,11 @@
           case 100:
             e.preventDefault();
             document.getElementById('imageDisplay').dataset.counter -= 2; // hacky
+            doClick(imageDisplay);
             break;
          }
       };
+      document.body.addEventListener('keydown', keyPressed);
       </script>
   </body>
 </html>

data/lib/snapshot/version.rb

@@ -1,3 +1,3 @@
 module Snapshot
-  VERSION = "0.9.0"
+  VERSION = "0.9.1"
 end

metadata

@@ -1,125 +1,125 @@
 --- !ruby/object:Gem::Specification
 name: snapshot
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Felix Krause
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-15 00:00:00.000000000 Z
+date: 2015-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fastimage
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.6.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.6.3
 - !ruby/object:Gem::Dependency
   name: fastlane_core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.7.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.7.2
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.1.0
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.7.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.7.4
 - !ruby/object:Gem::Dependency
   name: codeclimate-test-reporter
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: Automate taking localized screenshots of your iOS app on every device
@@ -161,17 +161,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: Automate taking localized screenshots of your iOS app on every device