InterBase ToGo

From RAD Studio
Jump to: navigation, search

Go Up to Developing Database Applications


InterBase ToGo is a database engine that can be embedded in an application directly by using the InterBase database engine library. InterBase ToGo does not have to be installed on any server or end-user workstation, and does not require that InterBase be installed on a machine before it is used (as InterBase Server and InterBase Desktop do).

InterBase ToGo has two licensing options for deployment: ToGo and IBLite.

Developers targeting database application deployment to Desktop (Windows and macOS) and Mobile (iOS and Android) OS platforms can deploy either with a "ToGo" license (for cost), or "IBLite" license (no cost). ToGo mobile licenses are included with some high end SKUs of the product for free. ToGo and IBLite have the same development model; both are embedded applications using the InterBase ToGo library.

Deploying ToGo and IBLite applications to PAServer

If you want to test InterBase ToGo or IBLite applications you should deploy to a PAServer even on the local machine. Doing this, the application is bundled completely including all required InterBase feature files.

Note: When installing InterBase ToGo, the MSVC 2013 runtime is required. This is not available by default on Windows 7 and earlier versions of Windows, and will need to be installed prior to using InterBase ToGo. The required files are available at: https://www.microsoft.com/en-us/download/details.aspx?id=40784, or by searching the web for Visual C++ Redistributable Packages for Visual Studio 2013.

You need to install PAServer on the machine where you want to run ToGo and IBLite applications. The installation files for both Windows and macOS can be found at:

C:\Program Files (x86)\Embarcadero\Studio\20.0\PAServer\

How to Install and start PAServer

To install and start PAServer on Windows or macOS, please follow these instructions: Platform Assistant Server Topics.

Note: On Windows, you should run PAServer as Administrator.

Developing InterBase ToGo Applications on Windows Platforms

The InterBase ToGo edition is available on the following Windows platforms and can access any InterBase database created by InterBase Desktop or Server editions from the same InterBase version.

System Requirements for Windows

  • Windows 10
  • Windows 8, 8.1
  • Windows 7
  • Windows Vista
  • Windows Server 2016
  • Windows Server 2012, 2012 R2
  • Windows Server 2008, 2008 R2

Example

For a description of the basic steps to browse data managed by InterBase ToGo on your mobile device:

Developing InterBase ToGo Applications for the macOS Platform

System Requirements for Mac

  • The Mac should be running either:
    • High Sierra (10.13)
    • Sierra (10.12)
    • El Capitan (10.11)

Sandboxing Interbase ToGo Applications for Mac

Building sandboxed applications with RAD Studio in Delphi/C++ is enabled in InterBase 2017. For more information, see App Sandboxing with InterBase ToGo for OS X.

Note: In case you want to deploy non-sandboxed applications to macOS, please see Non-sandboxed InterBase applications for macOS.

Example

For more information on how to develop InterBase ToGo applications for macOS, see the OS X Platform

Developing InterBase ToGo Applications for Mobile Devices

System Requirements for iOS

Supported iOS devices:

  • iPod Touch, iPhone, or iPad
  • iOS 8 and later

For macOS and iOS application development, you need to have installed on the Mac:

System Requirements for Android

Android devices that run the following versions of the operating system are supported:

  • Nougat (7.x)
  • Marshmallow (6.x)
  • Lollipop (5)
  • KitKat (4.4)
  • Jelly Bean (4.1.x, 4.2.x, 4.3.x)
  • Ice Cream Sandwich (4.0.3, 4.0.4)

Example

For a description of the basic steps to browse data managed by InterBase ToGo on your mobile device:

Apply InterBase ToGo Updates

InterBase ToGo files used by RAD Studio are contained in the following folder: C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2017

PathInterbaseToGoFilesXE6.png

To download InterBase ToGo updates, go to the InterBase Registered User Downloads page and download the InterBase 2017 ToGo Edition, Win/Linux/macOS/iOS/Android.

The InterBase 2017 ToGo Update is a collection of zip files of these directories (and more):

DownloadInterbaseToGoXE6.png

To apply the InterBase ToGo Updates, follow the steps below:

  1. Extract the win32_min.zip or win64_min.zip contents to your C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2017 directory.
  2. For the iOS platform, extract the ios_device.zip, ios_sim.zip, ios64_device.zip and ios64_sim.zip contents to the C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2017 folder.
  3. For the Android platform, extract the android_togo.zip contents to the C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2017 folder.
  4. For the macOS platform, extract the osx32_min.zip contents to the C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2017 directory.
  5. Extract libibtogo.a from ios_togo_device.zip to both the lib\iosDevice32\debug and the lib\iosDevice32\release folders within your RAD Studio install.
  6. Extract libibtogo.a from ios64_togo_device.zip to both the lib\iosDevice64\debug and the lib\iosDevice64\release folders within your RAD Studio install.
  7. Extract libibtogo.a from android_togo.zip to both the lib\android\debug and the lib\android\release folders within your RAD Studio install.

Troubleshooting Deploying InterBase ToGo Applications in Mobile Devices

InterBase License Issues

If you get an error ("unavailable database") when you connect to the database in the development environment, this means you forgot to deploy the Interbase ToGo license.

  • To execute your application on mobile, deploy the reg_ibtogo.txt or reg_iblite.txt license files.
  • The license files are located in C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2017 directory.

Typical Errors and Resolutions

Following are typical errors that you might encounter when you connect to the database, and suggestions for resolving the issues:

Error on mobile Suggestion
GDBFileNotFound.PNG Check whether the dataBase file (dbdemos.gdb) is delivered to 'StartUp\Documents\' (for iOS) or 'assets\internal\' (for Android).
IBToGoLic.PNG Provide a valid user and password to access the InterBase ToGo database.
LicenseIssueFD.png Check whether the license file is delivered for InterBase ToGo.
NeedToPointLocalFile.PNG Check whether you pointed to the local file: add an event handler for the OnBeforeConnect event of the connection component (SQLConnection component for dbExpress or FDConnection component for FireDAC).

See Also