Skip to content

Commit 44b0fc0

Browse files
Updated best practices and provisional profile docs
1 parent 2e7edf9 commit 44b0fc0

File tree

6 files changed

+243
-116
lines changed

6 files changed

+243
-116
lines changed

src/pages/docs/best-practices/best-practices.md

+195-75
Large diffs are not rendered by default.

src/pages/docs/configuration/ios-settings.md

+32-29
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,18 @@
11
---
2-
title: "Configure your Local iOS Device"
3-
order: 19.3
4-
page_id: "iOS Settings"
5-
metadesc: "Testsigma allows you to run tests on your Local iOS devices in addition to Testsigma Cloud machines/devices. Learn how to configure your local iOS Devices"
2+
title: "Configuring Local iOS Device with Provisioning Profile"
3+
page_title: "Configure Local iOS Device Provisioning Profile for Testing"
4+
metadesc: "Effortlessly configure your local iOS device with a provisioning profile to start. Follow steps for error-free testing and elevate your mobile app development."
5+
order: 19.5
6+
page_id: "creating-provisioning-profile-for-ios-app-testing"
67
noindex: false
78
search_keyword: ""
89
warning: false
910
contextual_links:
1011
- type: section
1112
name: "Contents"
1213
- type: link
13-
name: "iOS Native Setting"
14-
url: "#ios-native-setting"
14+
name: "Steps to Create Provisioning Profile"
15+
url: "#steps-to-create-provisioning-profile"
1516
- type: link
1617
name: "Troubleshooting Errors"
1718
url: "#troubleshooting-errors"
@@ -20,7 +21,7 @@ contextual_links:
2021

2122
---
2223

23-
Testsigma allows you to test local iOS devices and Testsigma Cloud machines/devices. To do this, you need to configure your provisioning profiles on Testsigma. This document provides a step-by-step guide for configuring your provisioning profiles and troubleshooting errors on Testsigma.
24+
Testsigma allows you to seamlessly test your applications on local iOS devices as well as on Testsigma Cloud machines. To achieve this, you need to properly configure your provisioning profiles or WebdriverAgent (WDA) on the Testsigma platform. This guide provides the step-by-step process for configuring your provisioning profiles and troubleshooting any potential errors encountered within Testsigma.
2425

2526
---
2627

@@ -30,33 +31,35 @@ Before configuring your local iOS devices, ensure you have a valid [Apple Develo
3031

3132
---
3233

33-
## **iOS Native Setting**
34-
35-
You must generate a Certificate Signing Request (CSR) and upload it to the Apple Developer portal to run Testsigma tests on your local iOS device. Here's how to do that:
36-
37-
1. Navigate to **Settings** > **iOS Settings**. ![iOS Setting in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/iosprofile_ts.png)
38-
2. Click **+New Profile** in the top-right corner of the screen, and enter **Profile Name** in the field. ![Enter Profile name](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/generate_csr_dwnld.png)
39-
3. Click **Generate Request** to create a **Certificate Signing Request** (CSR) and click **Download Request** to download the CSR. ![Generate CSR and Download](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/download_csr_ts.png)
40-
4. Go to the [Apple Developer](https://developer.apple.com/account/resources/certificates/) portal and navigate to the **Certificates, Identifiers & Profiles** section. ![Apple Developer Website](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/certificate_apple.png)
41-
5. Click on **+** next to **Certificates** in the **Certificates** section, then select **iOS App Development**. Finally, click on **Continue**. ![Select iOS App Developer](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/newiosapp_continue_apple.png)
42-
6. Click **Continue** after uploading the **CSR file** downloaded from **Testsigma**. ![Upload CSR file](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/uploadcsr_continue_apple.png)
43-
7. Click **Download** in the screen's top-right corner to download the certificate file from the Apple Developer Portal. ![Download Certificate from Apple](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/download_certificate_apple.png)
44-
8. Click **Upload Certificate** next to **Certificate** in **Testsigma** and select the certificate downloaded from the Apple Developer Portal. ![Upload CSR file in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/upload_certificate_ts.png)
45-
9. Create your **Mobile Provisioning Profile** by returning to the **Apple Developer** Portal and the **Certificates, Identifiers & Profiles** > **Profiles** section. ![Select Profiles in Apple Portal](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/select_profiles_apple.png)
46-
10. Click on **+** next to **Profiles** in the **Profiles** section, then select **iOS App Development**. Finally, click on **Continue**. ![Select iOS App Developer and click continue](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/newiosapp_continue_profile_apple.png)
47-
11. Click on the drop-down menu and select a **Wildcard App ID** in **Select an App ID**, then click **Continue** to proceed to the next step. ![Select App ID from Profiles](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/appid_profiles_apple.png)
48-
12. Select a **Certificate** downloaded from the **Apple Developer** Portal, upload it to **Testsigma**, and include it in this provisioning profile. Afterwards, proceed to the next step by clicking on **Continue**. ![select certificate](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/selectcerftificate_profiles_apple.png)
49-
13. Select the **Devices** that you want to include in this provisioning profile. ![select devices](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/selectdevices_profiles_apple.png)
50-
14. Enter the **Provisioning Profile Name** in the field and click **Generate**. ![Generate Provisioning Profile](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/generate_profiles_apple.png)
51-
15. Click **Download** in the screen's top-right corner to download the **Provisioning Profile** from the Apple Developer Portal. ![Download Certificate from Apple](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/download_profiles_apple.png)
52-
16. Click **Upload Certificate** next to **Provisioning Profile** in Testsigma and select the Provisioning Profile downloaded from the Apple Developer Portal. ![Upload Provisioning Profile](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/upload_provisioningprofile_ts.png)
53-
17. Click **Provisioning Profile Details** to view **Provisioned Devices** and **Re-signing Uploads Status**. ![Provisioning Profile Details](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/provisional_profiles_details_ts.png)
34+
## **Steps to Create Provisioning Profile**
35+
36+
Follow these steps to generate a Certificate Signing Request (CSR) and upload it to the Apple Developer portal to run Testsigma tests on your local iOS device:
37+
38+
1. Navigate to **Settings** > **iOS Settings**.
39+
2. Under the **Provisional Profile** tab, click on **Create New Profile** located in the top-right corner. ![iOS Setting in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/create_new_profile_pro.png)
40+
3. Enter a name for the profile in the provided field.
41+
4. Click **Generate Request** to create a **Certificate Signing Request** (CSR), and then click **Download Request** to save the CSR file. ![Generate CSR and Download](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/download_csr_ts.png)
42+
5. Visit the [Apple Developer](https://developer.apple.com/account/resources/certificates/) portal and go to the **Certificates, Identifiers & Profiles** section. ![Apple Developer Website](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/certificate_apple.png)
43+
6. Click on the **+** next to **Certificates** in the **Certificates** section, select **iOS App Development**. Click **Continue**. ![Select iOS App Developer](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/newiosapp_continue_apple.png)
44+
7. After you upload the **CSR** file downloaded from **Testsigma**, click **Continue**. ![Upload CSR file](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/uploadcsr_continue_apple.png)
45+
8. Click **Download** in the top-right corner to download the certificate file from the Apple Developer Portal. ![Download Certificate from Apple](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/download_certificate_apple.png)
46+
9. In **Testsigma**, click **Upload Certificate** next to **Certificate** and select the downloaded certificate file. ![Upload CSR file in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/upload_prof_pro_ts.png)
47+
10. Go back to the **Apple Developer** Portal and navigate to the **Certificates**, **Identifiers** & **Profiles** > **Profiles** section. ![Select Profiles in Apple Portal](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/select_profiles_apple.png)
48+
11. Click on the **+** next to **Profiles** in the **Profiles** section, select **iOS App Development**. Click **Continue**. ![Select iOS App Developer and click continue](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/newiosapp_continue_profile_apple.png)
49+
12. Click on the drop-down menu and select a **Wildcard App ID** in **Select an App ID**, then click **Continue** to proceed to the next step. ![Select App ID from Profiles](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/appid_profiles_apple.png)
50+
13. Select a **Certificate** downloaded from the **Apple Developer** Portal, upload it to **Testsigma**, and include it in this provisioning profile. Afterwards, proceed to the next step by clicking on **Continue**. ![select certificate](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/selectcerftificate_profiles_apple.png)
51+
14. Select the **Devices** that you want to include in this provisioning profile. ![select devices](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/selectdevices_profiles_apple.png)
52+
15. Enter a name for the **Provisioning Profile** and click **Generate**. ![Generate Provisioning Profile](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/generate_profiles_apple.png)
53+
16. Click **Download** in the top-right corner to download the **Provisioning Profile** from the Apple Developer Portal ![Download Certificate from Apple](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/download_profiles_apple.png)
54+
17. In Testsigma, click **Upload Certificate** next to **Provisioning Profile** and select the downloaded Provisioning Profile file. ![Upload Provisioning Profile](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/upload_profpro_testsigma.png)
55+
18. Finally, you click **Create** to complete the **Provisioning Profile** setup. ![Provisioning Profile Details](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/create_ios_prof_ts.png)
56+
5457

5558
[[info | NOTE:]]
5659
| 1. You should download the iTunes exe installer from Apple's website for Windows. If you have installed it from Microsoft Store, please uninstall it.
5760
| 2. If you have installed iTunes, ensure that Apple Mobile Device Service runs in Task Manager. If it is not running, open iTunes and check again if the service starts running.
5861

59-
Now that you have set up everything, you can record your iOS tests and run them on your iOS device(s).
62+
You can further manage your certificates by downloading CSR and Provisioned certificates for viewing and checking the validity of the Provisioning Profile certificate. If necessary, you can remove Provisioning Profile certificates by clicking Delete.<br><br>Now that you have set up everything, you can record your iOS tests and run them on your iOS device(s).
6063

6164
---
6265

src/pages/docs/configuration/reset-password.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Reset Password"
33
page_title: "How to reset password in Testsigma Community Edition"
4-
order: 19.4
4+
order: 19.3
55
page_id: "Reset password"
66
metadesc: "Learn steps in detail on how to reset username and password in Testsigma Community Edition. Follow these steps to reset username and password."
77
search_keyword: "Reset password"

src/pages/docs/configuration/storage-types.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Storage Types Supported in Testsigma"
33
page_title: "How to configuration Storage Types in Testsigma Community Edition"
4-
order: 19.5
4+
order: 19.4
55
page_id: "Storage Types Supported in Testsigma"
66
metadesc: "Storage allows you to store files on your integrated cloud storage provider. How to configuration Storage Types in Testsigma Community Edition"
77
search_keyword: "Storage Types"

src/pages/docs/desired-capabilities/most-common.md

+13-9
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
---
22
title: "Common Desired Capabilities"
3-
metadesc: "Learn about most commonly used Desired Capabilities for Chrome, Mozilla Firefox, Microsoft Edge, Execution Timeouts Specific and Environment Customizations in Testsigma Labs in Testsigma"
3+
page_title: "Streamline Testing Processes with Advanced Capabilities"
4+
metadesc: "Enhance efficiency with common desired capabilities in testing. Optimise workflows, boost collaboration, and ensure quality with cutting-edge testing features."
45
noindex: false
56
order: 15.2
6-
page_id: "Common Desired Capabilities"
7+
page_id: "common-desired-capabilities"
78
search_keyword: ""
89
warning: false
910
contextual_links:
@@ -30,6 +31,9 @@ contextual_links:
3031
- type: link
3132
name: "Android Specific"
3233
url: "#android-specific"
34+
- type: link
35+
name: "iOS Specific"
36+
url: "#ios-specific"
3337
---
3438

3539
---
@@ -114,15 +118,15 @@ Below are a few of the most commonly used Desired Capabilities in executions usi
114118
|Description|Capability|Data Type|Value|
115119
|---|---|---|---|
116120
|Persist App data in local Android devices across Hybrid Test sessions|noReset|boolean|true|
121+
|Automatically grant required app permissions based on the [Android manifest](https://developer.android.com/guide/topics/manifest/manifest-intro) during installation.|autoGrantPermissions|boolean|true|
117122

118123
---
119124

125+
## **iOS Specific**
120126

127+
|Description|Capability|Data Type|Value|
128+
|---|---|---|---|
129+
|Automatically approve all permission pop-ups, including privacy access requests for location, contacts, and photos.|autoAcceptAlerts|boolean|true|
130+
|Automatically dismiss all permission pop-ups, including privacy access permissions like location, contacts, and photos.|autoDismissAlerts|boolean|true|
121131

122-
123-
124-
125-
126-
127-
128-
132+
---

src/pages/docs/troubleshooting/agent/mobile-device-not-displayed-recorder.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Testsigma agent may be unable to detect your local mobile device for the test re
5050
<li><strong>Disabled Developer Options and USB Debugging</strong>: Follow the steps to <a href="https://testsigma.com/docs/agent/connect-android-local-devices/">set up a local Android device</a> to enable Developer Options and USB debugging.</li>
5151
<li><strong>Android Debug Bridge (ADB) Recognition Failure</strong>: Verify the ADB recognition by following the steps below if <a href="https://testsigma.com/docs/troubleshooting/agent/mobile-device-not-displayed-recorder/#adb-does-not-recognize-the-device-connected-to-the-system"> ADB does not recognize the device connected to the system </a>.</li>
5252
<li><strong>Desired Capabilities Not Modified</strong>: Use the guide on <a href="https://testsigma.com/docs/desired-capabilities/overview/">desired capabilities</a> to modify desired capabilities according to your device or application.</li>
53-
<li id="driver-install-error"><strong>Driver installation error</strong>: If you encounter a <strong>Failed to install drivers</strong> message, follow these steps: <img src="https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/diver_installation_android.png" alt="driver-install-error"></a>
53+
<li id="driver-install-error"><strong>Driver installation error</strong>: If you encounter a <strong>Failed to install drivers</strong> message, follow these steps: <img src="https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/diver_installation_error.png" alt="driver-install-error"></a>
5454
<ol type="a">
5555
<li>Allow time for the driver installation to finish.</li>
5656
<li>Check device memory for sufficient space.</li>

0 commit comments

Comments
 (0)