Implementing test cases using Stego is simple, intuitive, and designed to be easy for anyone to follow.
- Launch Stego.
- Connect devices to Stego.
- Set up the workspace by creating a new workspace or opening an existing one.
- Create new scenarios or select existing ones.
- Configure the scenario steps by adding new steps or modifying existing ones.
- Run tests using the configured scenarios.
Downloading and Installing Stego #
You can download the trial version of the Stego for both Mac and Windows from Apptest.ai’s official website.
Once downloaded, run the installation file to complete the setup.
Note: Stego will automatically update to the latest version if a new update is available when launched.Device Connection #
There are two options for connecting devices: Local (via USB cable) and Remote (via Device Farm).
This document provides a detailed explanation of the local connection option and guides you through the process of connecting Android and iOS devices to Stego.
- Device Connection Types
1. Local Connection: Connect devices directly to a PC using a USB cable.
2. Remote Connection: Connect devices remotely via the Device Farm. (please contact Apptest.ai to enable this feature.)
When using the local connection option, the process differs for Android and iOS devices.
Please follow the appropriate instructions based on your device’s operating system.
1. Pre-Setup #
Android #
The process of connecting an Android device to Stego is as follows:
- Enable Developer Mode on the device.
- Connect the device to Stego.
This process only needs to be completed once when connecting the device for the first time.
The device can be connected and used without any additional setup.
Enabling Developer Mode on the Device #
- Connect the device to the PC using a USB cable.
- Enabling Developer Mode
- On your device, go to Settings > About > Software information.
- Tap the Build number field five times in a row to enable Developer Mode.
- Enabling USB Debugging
- Go to the activated Developer Options menu and enable USB Debugging.
If a pop-up asking to allow USB debugging appears, check “Always allow from this computer” and select “Allow.”
- Make sure the “Verify apps over USB” option in the Developer Options menu is turned off.
If this option is enabled, the device may fail to connect to Stego, so please be aware.
iOS (Premium Users Only) #
According to Apple’s policy, a Mac is required to control iOS devices using external programs.
Additionally, a few initial setup steps are necessary to successfully connect Stego with an iOS device.
Provide Your Email Address #
Please provide Apptest.ai with the email address to be used for the developer account.
Apptest.ai will send an invitation to that email address for creating an Apple Developer account.
Once you receive the invitation, follow the registration process to complete the setup.
Setting up an iOS device may seem complex at first, but it only needs to be done once during the initial connection.
After that, you can connect and use the device without any further configuration.
When you are invited as a member of the Apple Developer team, it will be displayed as shown above.
Providing the Device’s Unique Device Identifier (UDID) #
You need to provide the device’s UDID to Apptest.ai.
This information is required to register the device with an Apple Developer account.
- How to Find the UDID
1. Connect your iOS device to a Mac using a USB cable.
2. Open Finder on the Mac.
3. In the sidebar, select the connected device.
4. Under the General tab, you can view the device information.
5. Click the text next to Serial Number, and it will change to the UDID.
6. Right-click on the UDID and select Copy.
Once you have copied the device’s UDID, please submit it to Apptest.ai to complete the registration process.
Register the Received Keychain #
Double-click the received apptestai.keychain file to activate it.
Copy and paste the activated certificate into the Login section of the Default Keychain group.
Installing Xcode #
- If Xcode is not installed on your Mac, you can install it from the Mac App Store by clicking the link below.
Install Xcode from the Mac App Store - Verify the installation of iOS and macOS components.
- Open Xcode, then go to Xcode > Settings (or Preferences) from the menu bar.
- In the Platforms tab (or Components tab), ensure that both iOS and macOS components are installed.
- Check the Command Line Tools Configuration.
- Open Xcode, then go to Xcode > Settings (or Preferences) from the menu bar.
- In the Locations tab, check that the correct version of Xcode is selected in the Command Line Tools dropdown menu.
Signing into the Apple Developer Account Invited by Apptest.ai #
- Open Xcode, then go to Xcode > Settings (or Preferences) from the menu bar.
- In the Accounts tab, click the + button at the bottom left to add your Apple ID and sign in.
- After signing in, ensure that Apptest.ai appears in the Team section and that the Role is set to Developer.
Configuring Stego Settings #
- From the menu bar, go to Stego > Settings.
- Click the Xcode tab.
- Enter the Team ID provided by Apptest.ai in the Development Team ID field.
- In the Code Signing Identity field, enter Apple Development.
- Once all steps are completed, click the Build button.
2. Connecting Devices #
Android – Connecting Devices to Stego #
In the Device panel of Stego, click the + button.
Select the Android device to connect, then click the Add button to complete the connection.
The Add Device window displays the status and a list of available devices.
Stego allows you to connect up to four devices simultaneously.
- Note – Device Connection Status
- DISCONNECTED : The PC has recognized the device, but it is not connected to Stego.
- CONNECTED : The device is successfully connected to Stego.
- UNTRUSTED : The PC has recognized the device, but USB debugging is not authorized on the device.
If a pop-up appears on the device screen asking for USB debugging permission, check “Always allow from this computer” and tap “Allow.”
Check the screen to confirm the connection
① The name of the connected device is displayed.
② You can disconnect the device.
③ The selected device’s screen is mirrored and displayed in Stego.
If a device in the list appears highlighted in red, it means that USB debugging has not been authorized on the device.
Please check if USB debugging is enabled in the Developer Options.
iOS – Connecting Devices to Stego #
In the Device panel of Stego, click the + button.
Select the iOS device to connect, then click the Add button to complete the connection.
The Add Device window displays the status and a list of available devices.
Stego allows you to connect up to four devices simultaneously.
- Note – Device Connection Status
- DISCONNECTED : The PC has recognized the device, but it is not connected to Stego.
- CONNECTED : The device is successfully connected to Stego.
- UNTRUSTED : The PC has recognized the device, but USB debugging is not authorized on the device.
If a pop-up appears on the device screen asking for USB debugging permission, check “Always allow from this computer” and tap “Allow.”
For devices running iOS 16.x or later, go to Settings > Privacy & Security and enable Developer Mode before attempting to connect.
If a device in the list appears highlighted in red, it indicates that the “Do you trust this device?”pop-up was not accepted on the device.
If you experience connection issues, please restart Stego. This can resolve situations where the connection fails due to timing mismatches with Xcode sessions.
Entering the Access Key #
By entering the Access Key for your Ptero account in Stego > Settings > Ptero,
you can seamlessly integrate with Ptero’s Scenario Repository and directly upload scenarios created in Stego.
Log in to Ptero(app.apptest.ai) and navigate to ① My Profile > ② Edit Profile to find the Access Key.
Enter the Access Key from your profile into ① Settings > ② Ptero > ③ Access Key in Stego, then click ④ Save.