Set Up macOS for C++ App Development

You.i Engine One app development is supported on macOS with C++ for:

  • Amazon Fire TV
  • Android Touch
  • Android TV
  • Apple iOS
  • Apple tvOS
  • Roku with You.i Engine Cloud
  • Samsung TV (Tizen)

MacOS is one of the three available development platforms for You.i Engine One. See Install for a complete list of target platforms and associated development platforms.

The instructions below offer a detailed list of mandatory and optional installation components.


Before you get going, there are a few third-party tools to install.

Install Xcode and Xcode Command Line Tools

To develop on macOS, you need Xcode and the Xcode command line tools. You.i Engine One release 6.7 supports Xcode version 12.x.

You’ll need an Apple Developer ID and signing certificate to use the Xcode IDE. If you don’t have a signing certificate yet, we suggest you create an iOS development certificate. You can use the same certificate for tvOS development. Read a bit more about certificate management in Apple’s Xcode help.

You can install Xcode command line tools from inside Xcode, or from the command line:

xcode-select --install

Other Prerequisites

  • CMake version 3.19.x
    • We suggest you let the installer add the CMake executable to your PATH. If you choose not to do this, you’ll have to add it manually later.
    • Verify successful installation by running cmake --version from your command prompt.
  • node.js (nodejs-lts and the NPM packager) version to
  • Ruby version 2.0 to 3.x
    • We suggest you let the installer add the Ruby executables to your PATH. If you choose not to do this, you’ll have to add them manually later.
    • Verify successful installation by running ruby --version from your command prompt.
  • Google Protobuf Ruby Gem (use the latest pre-packaged gem)
  • Watchman (version 4.9.0)
  • Yarn (version 1.13.x through 1.22.x)

Optional Third-Party Tools and IDEs

The following tools are optional, but most developers need them. We suggest you install them.

Install the Engine

Install the You.i TV command line interface tool. Then, using your provided API key, install You.i Engine One.

yarn global add youi-cli      
youi-tv login    # Enter your API key or user name when prompted.
youi-tv install 6.7.0 # If asked, accept most recent version of Babel or other dependencies

Our CLI comes with a special command, youi-tv doctor, that verifies the availability and versions of third party tools on your system. Use youi-tv doctor to identify any dependency mismatches. Install any missing tools or versions and run doctor again to verify.

What’s Next?

Congratulations, you’ve completed You.i Engine One installation for your macOS development platform.

Now you can build and generate your first app.