diff --git a/docs/modules/release-notes/partials/KOB-54642.adoc b/docs/modules/release-notes/partials/KOB-54642.adoc new file mode 100644 index 000000000..57f77d467 --- /dev/null +++ b/docs/modules/release-notes/partials/KOB-54642.adoc @@ -0,0 +1,42 @@ +// Release-note partial generated by Robot Ranch (Town Crier). Draft for docs-team review; not approved for publication. +// Source: Jira KOB-54642 (Bug, Released, fix version 2026.10.06). Components: API v2, Emulator/Simulator. + +== Kobiton API + +- Fixed an issue where Kobiton API endpoints rejected Android emulators and iOS simulators, or left them out of results. Users with access to virtual devices can now use the API to: +** Install an app on a virtual device, directly or in a session. This includes `kobiton app install` in Kobiton CLI. +** Mark a virtual device as a favorite. +** Assign and remove tags on a virtual device, and find virtual devices in tag listings. +** Rename a virtual device and restore its original name. +** Find virtual devices in the available devices list and reserve them. +** Convert an automation session that ran on a virtual device into a test case. +- Kobiton does not re-sign apps installed on an iOS simulator. Install a simulator build of the app. Device builds (`.ipa` files) do not install on simulators. +- Users without access to virtual devices now receive `403` with the message `You don't have permission to use virtual devices.` instead of `400` when they install an app on, favorite, or convert a session from a virtual device. + +The following are not yet supported for virtual devices: + +- Running a test run created on a virtual device. The API accepts the test run, but it does not run on the virtual device. +- Using these controls in Kobiton Portal. + +// REVIEWER NOTE: "Users with access to virtual devices" stands in for the ticket's +// "virtual-device entitlement." The public page manual-testing:start-a-virtual-session.adoc +// says an organization admin enables virtual devices. Confirm the entitlement and the admin +// enablement are the same thing before linking the two. +// +// REVIEWER NOTE: The ticket covers both Android emulators and iOS simulators. The existing +// virtual device page describes an Android system image only and says virtual devices are +// available for Cloud and Hybrid deployments, not Standalone. Confirm iOS simulator +// availability and which release page (Cloud weekly and/or Standalone) includes this partial. +// +// REVIEWER NOTE: The ticket also lists a passcode lookup that now works for virtual devices. +// It is not in the ticket's customer-facing release-note field, so it is left out here. +// +// REVIEWER NOTE: API reference pages are a separate surface (api-docs) and are not changed +// in this draft. The ticket states the available devices endpoint description in the API +// reference was updated to include virtual devices. Confirm the published API reference +// reflects the endpoint changes. +// +// REVIEWER NOTE: Test-run execution on virtual devices, Portal controls, and related follow-up +// work are tracked as separate tickets. Remove the matching limitation when each ships. + +// Source: KOB-54642