Accessible is tool which makes your UITesting experience way better on iOS.
| CI | Status |
|---|---|
| Master |  |
| Development |  |
Accessible parses your .storyboard files and generates accessibilityIdentifiers for every IBOutlet connection.
enum Accessible {
struct Storyboard {
struct Screen {
static let rootView = "Accessible.Storyboard.Screen.rootView"
struct UIElementTpye {
static let aView = "Accessible.Storyboard.Screen.UIElementTpye.aView"
}
...
}
...
}
...
}UITestableExtensions.swift makes setting the previously generated id-s for every UIElement easy. If you provide UITestableExtensions.swift path then Accessible will also generate a Swift file like below.
protocol UITestable {
func setAccessibilityIdentifiers()
}
extension ScreenViewController: UITestable {
func setAccessibilityIdentifiers() {
view.accessibilityIdentifier = Accessible.Storyboard.Screen.rootView
aView.accessibilityIdentifier = Accessible.Storyboard.Screen.UIElementTpye.aView
...
}
}
...You should call setAccessibilityIdentifiers() in the viewDidLoad() method of the UIViewController instance.
UITapMans.swift makes writing XCTestCase files way more fun then previously.
class ScreenUITests: XCTestCase {
var tapMan: ScreenTapMan!
override func setUp() {
super.setUp()
continueAfterFailure = false
tapMan = OnboardingTapMan().start()
}
func testCaseA() {
tapMan
.aView.isHittable()
.aView.tap()
}
}-
Download the latest released binary.
-
Make it executable with
chmod +x accessible. (If you have a .dms extension then remove it first) -
Copy it to
/usr/local/bin/. -
Create a
.accessible.ymlconfiguration file in your project's root directory (next to your project file).
#enumName: Accessible
inputs:
- Path/To/Storyboards
- Path/To/OtherStoryboards
- Path/To/One/SpecificStoryboard.storyboard
outputs:
identifiersPath: Directory/Of/Generated/Files
#testableExtensionsPath: Directory/Of/Generated/Files
#tapMansPath: Directory/Of/Generated/FilesUncomment enumName if you would like to provide the Accessibiliy Identifiers enum's name.
Uncomment testableExtensionsPath if you would like Accessible to generate UITestableExtensions.swift file for you.
Uncomment tapMansPath if you would like Accessible to generate UITapMans.swift file for you.
- Call
accessiblein the root directory of your project or set up a new run script build phase in your Xcode project file.