ZAT doesn't run in Windows
Problem: ZAT is a Ruby gem that requires Ruby 2.1 or later to run. However, the Windows installer for Ruby 2.4 and later has a dependency issue that prevents ZAT from running in Windows.
Solution: Install and use Ruby 2.3, or consider using Ubuntu for Windows 10 as your development environment. To install Ubuntu, see Setting up a Bash shell in Windows 10.
App content doesn't load when ZAT server is running
After starting the ZAT server and opening a ticket with ?zat=true in the URL, your app may be blank. The browser is blocking the content from the local zat server because it considers it mixed content.
To unblock app content in Chrome:
- Click the lock icon on the left side of the address bar and select Site settings.
- On the Settings page, scroll to the Insecure Content section and select Allow.
"Failed to build gem native extension" error in Mac OS X or Linux
Installing ZAT on Mac OS X may fail with the error shown below:
This can occur if you don't have a C compiler installed on your Mac. To fix this issue, download and install Xcode, and then install the Xcode command line tools. If you need help installing the Xcode command line tools, please see this guide on macports.org for more information.
Building native extensions. This could take a while... ERROR: Error installing zendesk_apps_tools: ERROR: Failed to build gem native extension.
After installing Xcode, try installing ZAT again.
Install rake separately with
$ gem install rake, then update ZAT with
$ gem install zendesk_apps_tool.
"Failed to build gem native extension" error in Windows
Validate not working in Windows