tvOS / iOS suitester¶
Suitest tests are heavily dependent on how robust element selectors are. The Suitest framework that is integrated into your tvOS/iOS application generates XPath for each UIView. This absolute XPath is however fragile.
As XPath is not stable because the UI element may have been wrapped, moved up or down in the view hierarchy very easily therefore making your selector obsolete. Of course, you could change the XPath to something more robust and unique for the element however this greatly increases the amount of effort. This is where the tvOS/iOS suitester command line tool will become very useful.
To use the tool, download and extract the zip file based on your Xcode version:
What does the tool do?¶
The tool sets the AccessibilityIdentifier for elements that do not have this attribute set. The
tools scans your project folder for any interface builders such as *.xibs or *.storyboards,
reads them and then modifies them.
The tool modifies elements which are UIView's or a subclass, that contain an empty
AccessibilityIdentifier will be given the ID property that the Xcode Interface Builder generated.
Once the tool is ran on the project, all UI elements will have their AccessibilityIdentifier
attributes set correctly in the interface builder.
Usage examples¶
| Action | Example | output | Notes |
|---|---|---|---|
| build ipa | ./suitester build --path $HOME/Projects/SomeProject --export $HOME/ExportOptionsList.plist --scheme AnotherScheme --configuration Release -b |
build using scheme and configuration from arguments then from export plist | |
| build ipa | ./suitester build --path $HOME/Projects/SomeProject --export $HOME/ExportOptionsList.plist -b |
/Users/username/.suitest/CommandLineTool/AppBuilds/SomeProject |
only build app from the source code without modification |
| Build specific help and options | ./suitester build -h |
||
| Copy and modify | ./suitester modify --path $HOME/Projects/SomeProject --output ~/Desktop/ |
/Users/username/Desktop/Project/ |
--output is optional, if null then project will be copied to ~/.suitest/CommandLineTool/Projects/SomeProject |
| General help and options | ./suitester -h |
||
| Modify and build ipa | ./suitester build --path $HOME/Projects/SomeProject --export $HOME/ExportOptionsList.plist |
/Users/username/.suitest/CommandLineTool/AppBuilds/SomeProject |
|
| Modify specific help and options | ./suitester modify -h |
Commands¶
| Command | Description |
|---|---|
| modify | Copies source code, looks for elements without AccesibilityIdentifier in Interface Builder files and sets a value. See -h for options. |
| build | Can set AccesibilityIdentifier and/or build IPA file. See -h for options. |
Arguments¶
| Argument | Description | Required |
|---|---|---|
--configuration |
Configuration to build e.g. AdHoc, Release. | No |
--options |
A path to ExportOption plist used for export ipa. | Yes |
--path |
A path to the Project folder which will be built for Suitest. | Yes |
--scheme |
Scheme name to build. | No |
--workspace |
Project workspace to build. Tool supports only workspaces for now. | No |
-h |
Shows all options. | No |
-verbose |
Log message level. | No |