Skip to content

Commit

Permalink
Merge branch 'main' into patch-5
Browse files Browse the repository at this point in the history
  • Loading branch information
@si-net
si-net authored Jan 14, 2025
2 parents bcef003 + c8604bd commit 1be0d59
Show file tree
Hide file tree
Showing 9 changed files with 112 additions and 195 deletions.
259 changes: 85 additions & 174 deletions docs/mobile-apps/automated-testing/appium/appium-versions.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -213,27 +213,27 @@ The following list of custom Appium plugins are supported:
<span className="sauceGreen">Active</span>
</td>
<td>
This will hold a collection of drivers that are compatible with the latest Appium server and driver versions that are installed in our cloud. We try to keep versions up to date every two weeks. <br />
This will hold a collection of drivers that are compatible with the latest Appium server and driver versions that are installed in our cloud.<br />
This is a collection of drivers that were released in this version <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.11.2" target="_blank">
<code>appium</code>: 2.11.2
<a href="https://github.com/appium/appium/releases/tag/appium%402.13.1" target="_blank">
<code>appium</code>: 2.13.1
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.9.0" target="_blank">
<code>appium-flutter-driver</code>: 2.9.0
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.11.0" target="_blank">
<code>appium-flutter-driver</code>: 2.11.0
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v3.7.4" target="_blank">
<code>appium-uiautomator2-driver</code>: 3.7.4
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v3.9.6" target="_blank">
<code>appium-uiautomator2-driver</code>: 3.9.6
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v7.24.6" target="_blank">
<code>appium-xcuitest-driver</code>: 7.24.6
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v7.35.0" target="_blank">
<code>appium-xcuitest-driver</code>: 7.35.0
</a>
</li>
<li>
Expand Down Expand Up @@ -281,6 +281,82 @@ The following list of custom Appium plugins are supported:
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20250101</code>
</td>
<td>
<span className="sauceGold">December 31th, 2025</span>
</td>
<td>
This is a collection of drivers that were released in January 1st 2025 <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.13.1" target="_blank">
<code>appium</code>: 2.13.1
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.11.0" target="_blank">
<code>appium-flutter-driver</code>: 2.11.0
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v3.9.6" target="_blank">
<code>appium-uiautomator2-driver</code>: 3.9.6
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v7.35.0" target="_blank">
<code>appium-xcuitest-driver</code>: 7.35.0
</a>
</li>
<li>
<a href="https://github.com/AppiumTestDistribution/appium-flutter-integration-driver/releases/tag/v1.1.3" target="_blank">
<code>appium-flutter-integration-driver</code>: 1.1.3
</a>
</li>
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20240901</code>
</td>
<td>
<span className="sauceGold">August 31th, 2025</span>
</td>
<td>
This is a collection of drivers that were released in September 1st 2024 <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.11.3" target="_blank">
<code>appium</code>: 2.11.3
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.9.2" target="_blank">
<code>appium-flutter-driver</code>: 2.9.2
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v3.7.8" target="_blank">
<code>appium-uiautomator2-driver</code>: 3.7.8
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v7.25.0" target="_blank">
<code>appium-xcuitest-driver</code>: 7.25.0
</a>
</li>
<li>
<a href="https://github.com/AppiumTestDistribution/appium-flutter-integration-driver/releases/tag/v1.1.3" target="_blank">
<code>appium-flutter-integration-driver</code>: 1.1.3
</a>
</li>
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20240801</code>
Expand Down Expand Up @@ -522,171 +598,6 @@ The following list of custom Appium plugins are supported:
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20240101</code>
</td>
<td>
<span className="sauceGold">December 31st, 2024</span>
</td>
<td>
This is a collection of drivers that were released in January 1st 2024 <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.3.0" target="_blank">
<code>appium</code>: 2.3.0
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.3.0" target="_blank">
<code>appium-flutter-driver</code>: 2.3.0
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v2.37.0" target="_blank">
<code>appium-uiautomator2-driver</code>: 2.37.0
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v5.12.2" target="_blank">
<code>appium-xcuitest-driver</code>: 5.12.2
</a>
</li>
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20231201</code>
</td>
<td>
<span className="sauceGold">November 30th, 2024</span>
</td>
<td>
This is a collection of drivers that were released in December 1st 2023 <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.2.2" target="_blank">
<code>appium</code>: 2.2.2
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.2.4" target="_blank">
<code>appium-flutter-driver</code>: 2.2.4
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v2.34.1" target="_blank">
<code>appium-uiautomator2-driver</code>: 2.34.1
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v5.11.0" target="_blank">
<code>appium-xcuitest-driver</code>: 5.11.0
</a>
</li>
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20231101</code>
</td>
<td>
<span className="sauceGold">October 31st, 2024</span>
</td>
<td>
This is a collection of drivers that were released in November 1st 2023 <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.2.1" target="_blank">
<code>appium</code>: 2.2.1
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.2.0" target="_blank">
<code>appium-flutter-driver</code>: 2.2.0
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v2.33.1" target="_blank">
<code>appium-uiautomator2-driver</code>: 2.33.1
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v5.8.0" target="_blank">
<code>appium-xcuitest-driver</code>: 5.8.0
</a>
</li>
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20231001</code>
</td>
<td>
<span className="sauceGold">September 30th, 2024</span>
</td>
<td>
This is a collection of drivers that were released in October 1st 2023 <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.1.3" target="_blank">
<code>appium</code>: 2.1.3
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v2.0.0" target="_blank">
<code>appium-flutter-driver</code>: 2.0.0
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v2.29.10" target="_blank">
<code>appium-uiautomator2-driver</code>: 2.29.10
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v5.4.0" target="_blank">
<code>appium-xcuitest-driver</code>: 5.4.0
</a>
</li>
</ul>
</td>
</tr>
<tr>
<td>
<code>appium2-20230901</code>
</td>
<td>
<span className="sauceGold">August 31st, 2024</span>
</td>
<td>
This is a collection of drivers that were released in September 1st 2023 <br />
<ul>
<li>
<a href="https://github.com/appium/appium/releases/tag/appium%402.1.3" target="_blank">
<code>appium</code>: 2.1.3
</a>
</li>
<li>
<a href="https://github.com/appium/appium-flutter-driver/releases/tag/v1.21.1" target="_blank">
<code>appium-flutter-driver</code>: 1.21.1
</a>
</li>
<li>
<a href="https://github.com/appium/appium-uiautomator2-driver/releases/tag/v2.29.5" target="_blank">
<code>appium-uiautomator2-driver</code>: 2.29.5
</a>
</li>
<li>
<a href="https://github.com/appium/appium-xcuitest-driver/releases/tag/v4.35.0" target="_blank">
<code>appium-xcuitest-driver</code>: 4.35.0
</a>
</li>
</ul>
</td>
</tr>
<tr>
<td>
<code>2.0.0</code>
Expand Down
4 changes: 2 additions & 2 deletions docs/secure-connections/sauce-connect.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ title: Sauce Connect Proxy 4
sidebar_label: Overview
---

:::caution Sauce Connect Proxy 5 is released
Please refer to [Sauce Connect Proxy 5 Overview](/secure-connections/sauce-connect-5/) for the most recent Sauce Connect Proxy documentation.
:::caution Important Notice: Sauce Connect 4 is reaching end-of-life status.
Starting May 5, 2025, servers will no longer support Sauce Connect version 4 traffic. To avoid interruptions, upgrade to [Sauce Connect 5](/secure-connections/sauce-connect-5/migrating) at your earliest convenience.
:::

If your company has firewall rules that limit your ability to run tests on Sauce Labs, you can use our Sauce Connect Proxy feature to connect to Sauce Labs in the cloud without exposing your company's IT infrastructure to security risks.
Expand Down
5 changes: 2 additions & 3 deletions docs/secure-connections/sauce-connect/installation.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,5 @@ title: Downloading Sauce Connect Proxy
sidebar_label: Download
---

Sauce Connect 4 has entered end-of-life status. The servers will be turned off on May 5, 2025.

We recommend upgrading to [Sauce Connect 5](/secure-connections/sauce-connect-5/installation).
Sauce Connect 4 is reaching end-of-life status.
Starting May 5, 2025, servers will no longer support Sauce Connect version 4 traffic. To avoid interruptions, upgrade to [Sauce Connect 5](/secure-connections/sauce-connect-5/migrating) at your earliest convenience.
4 changes: 2 additions & 2 deletions docs/secure-connections/sauce-connect/quickstart.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

:::caution Sauce Connect Proxy 5 is released
Please refer to [Sauce Connect Proxy 5 Quickstart Guide](/secure-connections/sauce-connect-5/quickstart/) for the latest quickstart guide.
:::caution Important Notice: Sauce Connect 4 is reaching end-of-life status.
Starting May 5, 2025, servers will no longer support Sauce Connect version 4 traffic. To avoid interruptions, upgrade to [Sauce Connect 5](/secure-connections/sauce-connect-5/migrating) at your earliest convenience.
:::

Sauce Connect is required to run a local test on an app or website located behind a firewall. Get up and running with a basic Sauce Connect Proxy tunnel in minutes using the steps below.
Expand Down
14 changes: 7 additions & 7 deletions docs/testfairy/app-distribution/auto-update.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@ Auto-update is not available in production.

There are two ways to configure auto-update for a specific build:

- In Build Settings
- Via Upload API
- In build settings

### In Build Settings

Expand All @@ -29,7 +29,7 @@ After uploading a build, access the build settings and navigate to the **App Dis

### Via Upload API

When uploading a new build via the upload api /testfairy/api-reference/upload-api, set the `auto-update` parameter to `on`.
When uploading a new build via the [upload API](/testfairy/api-reference/upload-api), set the `auto-update` parameter to `on`.

### Implementing Auto Update in Your App

Expand All @@ -47,7 +47,7 @@ curl -XPOST \
-F bundleShortVersion=2.0.1
```

And the response would include to fields, "status" and "autoUpdateDownloadUrl" (optional). Like so:
And the response would include the fields "status" and "autoUpdateDownloadUrl" (optional). Like so:

```json title="Sample Response"
{
Expand All @@ -57,20 +57,20 @@ And the response would include to fields, "status" and "autoUpdateDownloadUrl" (
```

- `status`: Is the distribution of the current version still allowed? Useful for invalidating specific versions after distribution.
- `autoUpdateDownloadUrl`: Optional string, if available, points out to the url the end user needs to open in a browser.
- `autoUpdateDownloadUrl`: Optional string, if available, points to the URL the end user needs to open in a browser.

### Reasons Auto-Update May Fail

Auto-update may fail for the following reasons:

- The version number and name of the new build are the same as the old one. Auto-update only works when versions are different.
- (iOS) The app is not signed with an ad-hoc or enterprise certificate.
- (Android) The sign certificates for each version is different. If an app does not sign with the same certificate, auto-update is rejected. This is because it's impossible to install the new version without previously uninstalling the current one.
- (Android) The sign certificates for each version are different. If an app does not sign with the same certificate, auto-update is rejected. This is because it's impossible to install the new version without previously uninstalling the current one.

### Notes on Security

`getDistributionStatus` is called from within your mobile app. It uses **TestFairy App Token**, which is a public token that cannot be used to make changes on the platform.

If your app is publicly available for download, the returned url is for a direct download (only for Android). Otherwise, the returned url is of a download page, which will require re-authentication before build can be downloaded.
If your app is publicly available for download, the returned URL is for a direct download (only for Android). Otherwise, the returned URL is of a download page, which will require re-authentication before the build can be downloaded.

Also note, that there can be only 1 build version marked for auto-update. This may point to any version, not necessarily a version that the current tester has been invited to. Please plan your auto-update policy.
Also, note that only 1 build version can be marked for auto-update. This may point to any version, not necessarily a version that the current tester has been invited to. Please plan your auto-update policy.
3 changes: 3 additions & 0 deletions docs/testfairy/security/sso/okta.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,6 @@ To import groups each time a user signs into TestFairy:
1. Open the TestFairy app in your OKTA account, select **Sign On**, and click **Edit**.
1. Click on **Attributes**.
1. Under **Group Attribute Statements**, add a rule with the name: "groups" (in **lowercase**) and filter "Matches regex" with value `.*`. (dot asterisk).
1. Note: We recommend adding at least one **Attribute Statement** (e.g., email), as shown below. Failing to do so may prevent SAML from including group data in the response.

<img src={useBaseUrl('img/test-fairy/security/okta-groups-attributes.png')} alt="Okta groups attributes" width="700"/>
Loading

0 comments on commit 1be0d59

Please sign in to comment.