appium/ios-uicatalog

Apple UICatalog App

ios-uicatalog

A simple test application for iOS, used by Appium for certain tests. For more information, see the docs for UICatalog or the docs for UIKitCatalog

UICatalog is for Xcode 10- UIKitCatalog is for Xcode 11+

This package exposes the following:

1. uiCatalog a. relative i. iphoneos: relative path to the real device app ii. iphonesimulator: relative path to the simulator app b. absolute i. iphoneos: absolute path to the real device app ii. iphonesimulator: absolute path to the simulator app
2. uiKitCatalog a. relative i. iphoneos: relative path to the real device app ii. iphonesimulator: relative path to the simulator app b. absolute i. iphoneos: absolute path to the real device app ii. iphonesimulator: absolute path to the simulator app

E.g.,

{
  "uiCatalog": {
    "relative": {
      "iphoneos": "UICatalog/build/Release-iphoneos/UICatalog-iphoneos.app",
      "iphonesimulator": "UICatalog/build/Release-iphonesimulator/UICatalog-iphonesimulator.app"
    },
    "absolute": {
      "iphoneos": "/node_modules/ios-uicatalog/UICatalog/build/Release-iphoneos/UICatalog-iphoneos.app",
      "iphonesimulator": "/node_modules/ios-uicatalog/UICatalog/build/Release-iphonesimulator/UICatalog-iphonesimulator.app"
    }
  },
  "uiKitCatalog": {
    "relative": {
      "iphoneos": "UIKitCatalog/build/Release-iphoneos/UIKitCatalog-iphoneos.app",
      "iphonesimulator": "UIKitCatalog/build/Release-iphonesimulator/UIKitCatalog-iphonesimulator.app"
    },
    "absolute": {
      "iphoneos": "/node_modules/ios-uicatalog/UIKitCatalog/build/Release-iphoneos/UIKitCatalog-iphoneos.app",
      "iphonesimulator": "/node_modules/ios-uicatalog/UIKitCatalog/build/Release-iphonesimulator/UIKitCatalog-iphonesimulator.app"
    }
  }
}

Building

npm install will build the app for a simulator in UICatalog/build directory. If you want also to build for a real device, set the environment variable IOS_REAL_DEVICE or REAL_DEVICE to a truthy value.

REAL_DEVICE=1 npm install

If any special build information is needed, the XCCONFIG_FILE environment variable can be set to the path to an xcconfig file.

notice

UICatalog can work on iOS13, but it has issues such as xctest framework returns wrong coordinate. It is because UICatalog does not use newer framework APIs such as safeArea.

Please use UIKitCatalog instead to work properly. It will be built automatically during npm install, or by running npm run build.

Then, the apps will be in UIKitCatalog/build directory.

Watch

npm run watch

Test

npm test

webView.isInspectable

Since iOS 16.4, the WKWebView insatnce needs to enable isInspectable to make WebView available. The sample app enables it.

ios-uicatalog's Issues

Can I get .ipa file for the ios-uicatalog application

I have worked with this uicatalog application and on my local i was able to test with .app file itself.
However to test it in a sauce-lab, i need a .ipa format of this app. Could you please provide me that. I could not create it from the xcode project because it seems i don't have apple's developer access.

Thanks

Action required: Greenkeeper could not be activated 🚨

🚨 You need to enable Continuous Integration on all branches of this repository. 🚨

To enable Greenkeeper, you need to make sure that a commit status is reported on all branches. This is required by Greenkeeper because it uses your CI build statuses to figure out when to notify you about breaking changes.

Since we didn’t receive a CI status on the greenkeeper/initial branch, it’s possible that you don’t have CI set up yet. We recommend using Travis CI, but Greenkeeper will work with every other CI service as well.

If you have already set up a CI for this repository, you might need to check how it’s configured. Make sure it is set to run on all new branches. If you don’t want it to run on absolutely every branch, you can whitelist branches starting with greenkeeper/.

Once you have installed and configured CI on this repository correctly, you’ll need to re-trigger Greenkeeper’s initial pull request. To do this, please delete the greenkeeper/initial branch in this repository, and then remove and re-add this repository to the Greenkeeper App’s white list on Github. You'll find this list on your repo or organization’s settings page, under Installed GitHub Apps.

Fix npm install

Same as other ios apps.

• remove global grunt dependency
• fix require(".") in Gruntfile

Readme.md

Incorrect docs link referenced.

https://github.com/appium/ios-uicatalog/blob/master/'./uicatalog-info.md'