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.

  • 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

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
Brew install failed

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

Brew update error

Brew update failed
Brew update failed

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

Connection error

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
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
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 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.