Skip to content

Add Deque integration page and nav #456

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tiffany-kobiton wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add Deque integration page and nav #456

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/modules/integrations/nav.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@
** xref:integrations:circleci/upload-an-app.adoc[]
** xref:integrations:circleci/run-an-automation-test.adoc[]

* xref:integrations:deque/deque-integration.adoc[Deque]

* xref:integrations:github-actions/index.adoc[]
** xref:integrations:github-actions/upload-an-app.adoc[]
** xref:integrations:github-actions/run-appium-script.adoc[]
Expand Down
53 changes: 53 additions & 0 deletions docs/modules/integrations/pages/deque/deque-integration.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
= Deque axe DevTools Mobile integration
:navtitle: Deque

Use Kobiton iOS devices as the target for link:https://www.deque.com/axe/devtools-mobile/[axe DevTools Mobile] accessibility scans.

For setup and usage of axe DevTools Mobile itself, see Deque's link:https://docs.deque.com/devtools-mobile/2024.9.18/en/ios-kobiton[iOS testing on Kobiton guide,window=read-later].

== Before you start

* A Kobiton Enterprise subscription is required.
* An link:https://www.deque.com/axe/devtools-mobile/[axe DevTools Mobile] subscription is required.
* Install xref:debugging:set-up-virtualusb.adoc[virtualUSB] `4.16.0` or later on the macOS workstation that will run axe DevTools Mobile.
* Install Xcode on the same workstation. The first time you connect an iOS device, Xcode downloads device symbols, which can take several minutes.
* This integration supports iOS devices only. Android is not supported.

== Prepare the Kobiton device

Open *virtualUSB* and select *Connect* next to the iOS device you want to test.

In Kobiton Portal, locate the same device and select *Launch* to start a session.

The device is now available to local iOS tooling on the workstation, including Xcode and axe DevTools Mobile Analyzer.

[NOTE]
====
The first time an iOS device connects through virtualUSB, Xcode may download device symbols automatically. This can take several minutes.
====

== Install the application

Install the app under test from Kobiton Portal.

== Run accessibility scans

In axe DevTools Mobile Analyzer, select the connected Kobiton device and run the accessibility scan.

For detailed analyzer setup and scan workflows, see Deque's https://docs.deque.com/devtools-mobile/2024.9.18/en/mobile-analyzer-setup[axe DevTools Mobile
Analyzer setup guide,window=read-later]

== Review results

Accessibility results are available in the axe DevTools Mobile Dashboard.
Session details, video, logs, and other Kobiton artifacts are available in xref:docs/modules/session-explorer/pages/index.adoc[Session Explorer].

== Notes
* Release the device in *virtualUSB* when you finish testing.
* Kobiton sessions may clear app and analyzer artifacts when they end. Reinstall the app from Kobiton Portal if you start a new session.

== Support

* For Kobiton issues, contact link:mailto:support@kobiton.com[support@kobiton.com].
* For axe DevTools Mobile issues, visit
link:https://support.deque.com[support at Deque,window=read-later].
Loading