Deploying the test application on an Apple TV

Deploy the test application on an Apple TV for running tests. This is the same for both the TVML and Swift versions of the test application.

Prerequisites

  • You must have an Apple laptop with Xcode installed.
  • Ensure that the Apple TV is connected to the Apple laptop properly.
  • Ensure that you are using the correct versions of Xcode, tvOS, and macOS. Update them as needed:
    • Xcode 8.1 Build 8B62
    • tvOS 10.0.1 Build 14U71 (To update the tvOS, you need iTunes 12.5.3.)
    • macOS Sierra 10.12.1 Build 16B2657

Procedure

  1. Download or copy the test application .zip file (either AppleTV_tvml_app.zip or AppleTV_swift_app.zip) to an appropriate directory on your Apple laptop.

    If you have had the kit downloaded and unpacked on your Apple laptop, locate the .zip file in the <kit parent directory>/Test_Apps/ directory.

    Otherwise, download the .zip file from the web page <kit starting page>/Test_Apps/ on the DISC website (https://disc.dolbycustomer.com).

  2. Extract the file (for example, AppleTV_tvml_app.zip), and make sure the folder contains an .xcodeproj file.
  3. Launch Xcode, and load the project file for the Apple TV test application.
    In the Xcode UI, go to File > Open and open the project file .xcodeproj.
  4. Select Apple TV as the target device for deployment.
    Xcode UI

    If the Apple TV is switched on and connected to the Apple laptop properly, it can be detected by Xcode automatically.

  5. Start deploying by either clicking on the triangle button or selecting Product > Run.

Results

The test application automatically launches on the Apple TV.