Xojo Documentation Xojo Documentation

Download Xojo 2016 Release 1.1

<a id="Xojo IDE" name="Xojo IDE">Xojo IDE</a>

The Xojo IDE can be used on systems that meet the following requirements:

<thead> </thead> <tbody> </tbody>

	Windows	OS X	Linux (x86, x86-64)
OS	Windows 10 Windows 8.1 Windows 7 SP1 Windows Vista SP21 Both 32-bit and 64-bit versions of Windows are supported. 1 Vista support is <a hqid="291564" href="#">deprecated</a>.	OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.5 OS X Mountain Lion 10.8.52 OS X Lion 10.7.52 iOS development requires 10.9.x or later and Xcode 6.x or later. <a href="#iOS Apps">See below</a> for iOS requirements. 2 OS X 10.7 and 10.8 support is <a hqid="291564" href="#">deprecated</a>.	32-bit distributions are recommended (refer to <a href="#Linux Information">Linux Information</a> below regarding 64-bit). Linux Mint 16 or later (17.3 suggested) Ubuntu 10.04 or later (15.10 suggested) Debian 6.0 or later OpenSUSE 11.3 or later Fedora 13 Desktop or later CentOS 6.0 or later The Xojo IDE does not run on ARM.
RAM	Minimum 2GB	Minimum 2GB	Minimum 2GB
Other	PDF viewer for documentation		PDF viewer for documentation

<a id="Desktop Apps" name="Desktop Apps">Desktop Apps</a>

Desktop apps created with Xojo have these requirements:

<thead> </thead> <tbody> </tbody>

	Windows	OS X	Linux (x86, x86-64)	Raspberry Pi
OS	32-bit and 64-bit versions of Windows are supported. Windows 10 Windows 8.1 Windows 7 SP1 Windows Vista SP21 1 Vista support is <a hqid="291564" href="#">deprecated</a>.	OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.5 OS X Mountain Lion 10.8.52 OS X Lion 10.7.52 2 OS X 10.7 and 10.8 support is <a hqid="291564" href="#">deprecated</a>.	32-bit and 64-bit versions of Linux are supported. Linux Mint 16 or later Ubuntu 10.04 or later Debian 6.0 or later OpenSUSE 11.3 or later Fedora 13 Desktop or later CentOS 6.0 or later (7.0 or later for x86-64) For best results on 64-bit distributions, build a 64-bit app.	32-bit ARMv7 is supported (Pi 2 and Pi 3). Raspbian Wheezy Raspbian Jessie

<a id="Web Apps" name="Web Apps">Web Apps</a>

Web apps consist of two parts: user interface displayed in the web browser and the app itself.

<a id="Web Browser" name="Web Browser">Web Browser</a>

Your users can use a web app in one of the following browsers for these platforms:

<thead> </thead> <tbody> </tbody>

	Windows	OS X / OS X Server	Linux	iOS	Android	Raspberry Pi
Browser	Chrome 37+ Firefox 17+ Internet Explorer 9+ SSL requires 11+ or <a href="#SSL">settings change for 9+</a> Edge	Safari 6.0+ SSL requires 7.0+ Chrome 37+ Firefox 17+	Chrome 37+ Firefox 17+	Mobile Safari	Chrome for Android	Raspbian Web Browser

<a id="Security" name="Security">Security</a>

For <a id="SSL" name="SSL">SSL</a> with IE 9 or 10, you may need manually enable TLSv12 with these steps:

1. Select "Tools" ↠ "Internet Options". Depending on your IE settings, the "Tools" menu may be a gear icon in the upper right hand corner.
2. Go to the "Advanced" tab. 
3. Scroll down to the "Security" section. 
4. Locate and check "Use TLS 1.2" in the Security section.
5. Then, press the "OK" button.

You may need to close and reopen all open browser windows in order for these new settings to take effect.

<a href="http://blog.xojo.com/microsoft-is-killing-internet-explorer-8-9-and-10" target="_blank">Microsoft no longer supplies security updates to IE 9 and 10 for most users</a>, so you may want to consider upgrading to IE 11 or using a different browser.

<a id="Web Server" name="Web Server">Web Server / Deployment</a>

Web apps can be deployed to servers with these requirements:

<thead> </thead> <tbody> </tbody>

	Windows	OS X / OS X Server	Linux (x86, x86-64)	Raspberry Pi
OS	32-bit and 64-bit servers are supported. Windows Server 2016 Windows Server 2012 Windows Server 2008 SP11 Windows Server 2008 R2 Windows 10 Windows 8.1 Windows 7 Windows Vista SP21 1 Vista and Windows Server 2008 SP1 support is <a hqid="291564" href="#">deprecated</a>.	OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.5 OS X Mountain Lion 10.8.52 OS X Lion 10.7.52 2 OS X 10.7 and 10.8 support is <a hqid="291564" href="#">deprecated</a>.	32-bit and 64-bit servers are supported.  CentOS 6.0 or later (7.0 or later for x86-64) Debian 6.0 or later OpenSUSE 11.3 or later Linux Mint 16 or later Ubuntu 10.04 or later Fedora 13 later	32-bit ARMv7 is supported (Pi 2 and Pi 3). Raspbian Wheezy Raspbian Jessie
Deployment	<a hqid="298523" href="#Stand-alone Application">Standalone</a> <a hqid="298523" href="#Apache">Apache 2</a> <a hqid="301710" href="#">IIS</a>	<a hqid="298523" href="#Stand-alone Application">Standalone</a> <a hqid="298523" href="#Apache">Apache 2</a>	<a hqid="298523" href="#Xojo Cloud">Xojo Cloud</a> <a hqid="298523" href="#Stand-alone Application">Standalone</a> <a hqid="298523" href="#Apache">Apache 2</a>

<a id="Console Apps" name="Console Apps">Console Apps</a>

Console apps do not have a user interface and run on systems with these requirements (or any of the server requirements listed for Web Apps):

<thead> </thead> <tbody> </tbody>

	Windows	OS X / OS X Server	Linux (x86, x86-64)	Raspberry Pi
OS	Windows 10 Windows 8.1 Windows 7 Windows Vista SP21 1 Vista support is <a hqid="291564" href="#">deprecated</a>.	OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.5 OS X Mountain Lion 10.8.52 OS X Lion 10.7.52 2 OS X 10.7 and 10.8 support is <a hqid="291564" href="#">deprecated</a>.	Linux Mint 16 or later Ubuntu 10.04 or later Debian 6.0 or later OpenSUSE 11.3 or later Fedora 13 Desktop or later CentOS 6.0 or later (7.0 or later for x86-64)	32-bit ARMv7 is supported (Pi 2 and Pi 3). Raspbian Wheezy Raspbian Jessie

<a id="iOS Apps" name="iOS Apps">iOS Apps</a>

In order to work on iOS projects, you must be using Xojo on OS X 10.9 and later with Xcode 6.x or later (required for iOS Simulator).

<tbody> </tbody>

Supported iOS Versions	iOS 9 iOS 8 iOS 71 1 iOS 7 support is <a hqid="291564" href="#">deprecated</a>.
Supported iOS Devices	iPhone 4S and newer iPhones iPad mini (all models) iPad 2 and newer models iPod Touch (5th gen and newer)
iOS Developer Subscription Requirements	Deploying to iOS devices Submitting to App Store Test Flight

<a id="Linux Information" name="Linux Information">Linux Information</a>

Because various Linux distributions have different libraries installed by default, you may need to install additional libraries installed before your Xojo apps will run on Linux. At a minimum, Xojo requires these Linux libraries:

<thead> </thead> <tbody> </tbody>

Always Required	Required for Desktop	Optional
glib 2.0	GTK+ 2.20	libwebkitgtk-1.0.0 or libgtkhtml (HTMLViewer) Ubuntu install command: sudo apt-get install libwebkitgtk-1.0.0
glibc-2.11 (32-bit) glibc-2.14 (64-bit)		libsoup 2.4 (Xojo.Net.HTTPSocket)
libstdc++.so.6.0.13		GTK+ 2.32 for Picture.Open Horizontal and Vertical resolutions.
libicu 4.2+

If you're looking for a specific version and distribution, check out <a href="http://mirrors.kernel.org" target="_blank">mirrors.kernel.org</a>.

<a id="64-bit Configuration" name="64-bit Configuration">64-bit Configuration</a>

For best results, create 64-bit Xojo apps for distribution on 64-bit Linux systems. If you have to distribute a 32-bit Xojo app on a Linux distribution, you need to ensure that the 32-bit libraries are installed. They are not installed by default, so you'll have to install them manually. Below are some commands that might be helpful.

<thead> </thead> <tbody> </tbody>

Debian/Ubuntu/Mint	CentOS/Fedora/OpenSUSE
sudo apt-get install ia32-libs sudo apt-get install ia32-libs-multiarch	sudo yum install ia32-libs sudo yum install ia32-libs-multiarch
sudo dpkg --add-architecture i386 sudo apt-get update sudo apt-get install ia32-libs-multiarch	sudo yum install glib2.i686 libgcc.i686 libstdc++.i686
sudo apt-get install libicu52:i386 sudo apt-get install libicu52 sudo apt-get install libicu48:i386	sudo yum provides missinglibrarypathorname sudo yum install packagenamewithlibrary
Ubuntu 14+: sudo dpkg --add-architecture i386 sudo apt-get update sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 libglib2.0-0:i386 libsoup2.4-1:i386 libicu52:i386 libgtk2.0-0:i386	/usr/bin/yum -y install glib2.i686 libgcc.i686 libstdc++.i686
sudo apt-get install libgtk2.0-0:i386	yum install libicu.i686

If you are still having trouble identifying necessary libraries, the ldd command might help. You can run from Terminal in the Xojo directory to return a list of libraries required by Xojo and their status on the system:

ldd Xojo

<a id="International Components for Unicode" name="International Components for Unicode">International Components for Unicode</a> (libicu)

Most recent Linux distributions have <a href="http://site.icu-project.org" target="_blank">libicu</a> installed, but depending on the Linux distribution you may need to install it yourself. These command may be helpful:

<thead> </thead> <tbody> </tbody>

Debian/Ubuntu/Mint	CentOS/Fedora/OpenSUSE
sudo apt-get install libicu52	yum install libicu

Ubuntu 12.04 64-bit is <a href="https://bugs.launchpad.net/ubuntu/+source/icu/+bug/992439" target="_blank">unable to have both 32-bit and 64-bit libicu installed</a>. If you require this, use 12.10 or later or create a 64-bit build.