The Scope iOS agent allows you to perform manual tests on your application that will be recorded for later troubleshooting in Scope. You can either run your application from Xcode in your simulator or device, or distribute a build to your testers with the functionality built-in.
The results will appear in your Local Development scratchpad in Scope
Link your application target with
By adding the pod to your
Podfile and running
pod install. For example:
target 'MyApp' do
target 'MyFramework' do
ScopeAgent dependency to your
Cartfile if not already done in previous steps, and run
In your application or framework targets, add
ScopeAgent.framework located in
Carthage/Build/iOS to the
Linked frameworks and Libraries in General target settings or to the Link Binaries With Libraries build phase.
If you want to run your application from Xcode in your simulator or device, the following environment variables must be set in your Run target (instructions):
Alternatively, if you want to distribute the instrumented application (e.g. to the QA team), then you must add the following entries in your application's
After the application launches, a floating Scope logo will appear in the screen over your application elements. When you want to start a test, click on the logo and provide the test with a name.
While the test is being recorded, the Scope logo will be glowing in red. To finish the test and stop the recording, click on the logo, and choose whether the test passed or failed.
Manual tests will appear in your Local Development scratchpad section.