Apple TV - Troubleshooting

If you cannot find the solution to your problem in the troubleshooting section, please contact us.

Restart SuitestDrive

Restart SuitestDrive after applying any fixes to allow changes to take effect.


Adding Apple TV device fails

If adding a device fails, please check/do the following:

  • Reboot the Apple TV device.

  • Check that both devices have an active connection to the Internet.

  • Check that the UDID of your Apple TV has been registered to your Apple Developer account.

  • Restart SuitestDrive or the (Xcode) host computer.

  • As a last measure go through the pairing process again. You'll need to unpair your device in Xcode by navigating to Window > Devices and Simulators and remove your Mac from the list of remote devices on the Apple TV by navigating to Settings > Remotes and Devices > Remote App and Devices.

App code sign error

The application that is being launched is signed with a provisioning profile that is not suitable for the currently connected device. Please re-sign the app and re-upload to the configuration. If you have the Apple Configurator 2 app installed, you can try to install you ipa file manually and then verify that the signing is correct.

Apple ID account error

Please make sure that your account is assigned to Standard Apple Developer Team. Assignment to Enterprise Apple Developer Team prevents Suitest from being able to generate a provisioning profile for your application.

The Apple ID used with Xcode currently logged in is incorrect. Please verify that the logged in account matches the Team ID specified. Check that you have inserted the correct Team ID during device setup, you can find the ID in Xcode Settings > Account.

Brew install error

Brew install failed

Run brew install autoconf in your terminal then resolve the errors displayed.

Brew update error

Brew update failed

Update Homebrew by running brew update in your terminal then resolve the errors displayed.

Cannot connect to Apple TV

In order to troubleshoot the issue, please follow these steps:

  1. Open Apple Configurator 2
    • Check that the Apple TV device is listed there
      Apple TV inside the Apple Configurator
  2. Go to the Xcode -> Window -> Devices and Simulators
    • Check that the Apple TV device is listed there
      Apple TV inside Xcode list of devices
    • Check that it is connected without any errors or warnings

      If the device is marked as disconnected or some errors present, try to restart the device with the Xcode and repair the device again

  3. Open the App Store
    • Connect and check that the user is added into your team with a Developer role
      User with a Developer role inside the app store
  4. Go to Xcode -> Preferences -> Account
    • Check that user is logged in and the team is listed
      User inside the Xcode list of accounts
  5. The Apple TV device UDID is registered in your development team
    • If your device is not added into your team, kindly ask you account administrator to add it
      Apple TV listed inside the apple developer team account

Connection error

Please make sure that your account is assigned to Standard Apple Developer Team. Assignment to Enterprise Apple Developer Team prevents Suitest from being able to generate a provisioning profile for your application.

Xcode and the Apple TV have issues connecting. Please reboot the Apple TV and try again. If the issue persists up-pair then pair the device once again.

Failed to initialize device control

If you are having trouble starting tests due to "Failed to initialize device control", consider increasing the server timeout in the configuration file.

Failed to read data from the Apple TV

If you receive Failed to read data from the Apple TV when switching between USB-C cable and network or vice-versa for the 4th generation Apple TV, then follow these steps to fix the issue:

  1. Unpair the device in Xcode by navigating to Window > Devices and Simulators.
  2. Remove all cables except the power cable and reboot the device.
  3. Restart SuitestDrive.
  4. Plug in the USB-C cable and follow the Pairing Xcode and Apple TV section.

General permission issues

Please ask your friendly system administrator to take care of these issues for you.

If the Mac is used by multiple users then set permissions for group of users by doing the following in your terminal:

  1. Check user group by running ls -la /usr/local/lib
  2. sudo chmod -R g+w /usr/local/Cellar
  3. sudo chmod -R g+w $(folder/file) make sure to specify the directory correctly
  4. sudo chmod -R g+w /usr/local/lib

idevice error

idevice error

If this error occurs then run gem install idevice in your terminal after verifying that your macOS user permissions are set to allow access to ruby gems. You can set permission by doing the following: sudo chown -R $(whoami) $(gem enviroment gemdir)/gems

Install utilities errors

Misc libplist errors

Logged in user does not have rights to install in /usr/local. Please add read and write rights to the current macOS user or contact your device administrator. If elevating rights does not solve the error please contact our friendly support team.

iOS Deploy not found

iOS Deploy is not found, could of been removed after resource installation.

If this error occurs then remove the .suitest/resources folder by doing the following:

  1. Open SuitestDrive
  2. Under the File tab select Open SuitestDrive config folder
  3. Delete the resources folder
  4. Restart SuitestDrive and add go through the adding process again

iosdeploy error

If this error occurs then do the following:

  1. Check command line tools version by writing xcode-select --version in the terminal. Output should be something like xcode-select version 2354.
  2. Check the path by writing xcode-select -p in the terminal. Output should be something like /Applications/Xcode.app/Contents/Developer
  3. In case any of the output was missing then write xcode-select --install in the terminal and then open Xcode > Settings > Locations and Verify that Command Line Tools menu is not empty.

Xcode > Settings > Locations > Command Line Tools

If this error still occurs then remove the .suitest/resources folder by doing the following:

  1. Open SuitestDrive
  2. Under the File tab select Open SuitestDrive config folder
  3. Delete the resources folder
  4. Restart SuitestDrive and go through the adding process again

Pairing error

Issue between pairing of Xcode and Apple TV. Please reboot both the Mac Xcode host and the Apple TV.

Xcode error

  • Xcode cannot find the device with the specified UDID. Verify that the device is connected or paired with Xcode. You may need to re-pair the device to Xcode.

  • Xcode command line tools (CLI) are outdated compared to the currently running tvOS version. Please make sure the versions match. You can check the version by navigating to the following: XCode > Settings > Locations > Command line tools.