Documentation API Reference

ZAT - Known issues

Note:ZAT is in maintenance mode. For the best experience, use theZendesk Command Line Interface (ZCLI)to develop Zendesk apps.

ZAT doesn't run in Windows

Problem: The Windows installer for Ruby 2.4 and later has a dependency issue that prevents ZAT from running in Windows.

Solution: Use the Ubuntu terminal environment for Windows. In the Ubuntu terminal environment, install and use Ruby 2.6.9 for ZAT.

To install the Ubuntu terminal environment for Windows, refer toSetting up a Windows development environment for ZAT. To install and use Ruby 2.6.9 in the environment, refer toInstalling RubyandUsing a specific Ruby version.

App content doesn't load when ZAT server is running

After starting the ZAT server and appending ?zat=true to the Zendesk product interface URL, your app may be blank. The browser is blocking the content from the local zat server because it considers itmixed content.

Note:Firefox and Chrome doesn't block app content, but Safari does. Safari doesn't have an option to disable blocking. As a result, you must use Chrome or Firefox to work with the local zat server.

"Failed to build gem native extension" error in Mac OS X or Linux

OS X

Installing ZAT on Mac OS X may fail with the error shown below:

             

              
Buildingnative extensions.Thiscould take awhile...ERROR:Errorinstalling zendesk_apps_tools:ERROR:Failedto build gem native extension.

Possible causes:

  • C compiler is not installed on your Mac. To fix this issue,download and install Xcode, and then install the Xcode command line tools. For information on installing Xcode command line tools, seethis guideon macports.org. After installing Xcode, try installing ZAT again.

  • Thin gem is not installed on your Mac. To install, run the following command in your command-line editor:

    gem install thin -v 1.7.2 -- --with-cflags="-Wno-error=implicit-function-declaration".

    Thezendesk_apps_toolsgem has a dependency on thin version 1.7.2. Without specifying a version, the later version of thin will compile by default.

You can also use a beta version of ZCLI to build and deploy Zendesk apps. SeeUsing ZCLIfor more information.

Linux

Installrakeseparately with$ gem install rake, then update ZAT with$ gem install zendesk_apps_tools.

"Failed to build gem native extension" error in Windows

Your system environment might be not have all the tools necessary to build and use native Ruby gems. You can install an add-on called DevKit to get these tools. Download the DevKit from theDownloadspage on the RubyInstaller website. SeeWhich Development Kit?on the page.

Validate not working in Windows

If you're a Windows user and the ZAT validate function gives you an error, ZAT might be having trouble finding a JavaScript runtime on your system. The best solution we’ve found is to install Node.js. You can download Node.js athttp://nodejs.org/download/.