Installation Notes for Appmethod 1.14

From Appmethod Topics
Jump to: navigation, search

These notes provide important information about installing the product, and we recommend that you read this entire document before any uninstall or install procedure. You can find the most recent version of these notes at Installation Notes for Appmethod 1.14.

This document sometimes uses the term "the product" or "your product" to describe Appmethod.

For additional information about installing the product, see the Release Notes (Readme.htm), available at the following locations:


Minimum System Requirements

Windows Platforms

The following Windows platforms are supported as development platforms:

  • Microsoft® Windows 8 and 8.1 (32-bit and 64-bit)
  • Microsoft Windows 7 SP1 (32-bit and 64-bit)
  • Microsoft Windows VistaTM SP2 (32-bit and 64-bit) requires administrator rights
  • Microsoft Windows Server 2008 (32-bit and 64-bit)
  • The latest service packs and security updates are recommended for all platforms
  • Microsoft Internet Explorer 6.0 SP1 or later


The product requires a number of prerequisites that are typically installed automatically on your system during the install process if they are not already present. In particular, the Microsoft .NET Framework is installed on your system if it is not already present (unless you are installing on Windows 8, as described below).

Prerequisites include:

  • Microsoft .NET Framework 3.5
  • Microsoft Visual J# version 2.0 Redistributable Package (32-bit)
  • Microsoft Document Explorer

The .NET Framework should be automatically installed for you during installation. However, if you are installing on Windows 8, .NET is not automatically installed. Instead, you can choose to install the .NET framework from MS Windows Update Server.


  • For developing 64-bit Windows applications (using Object Pascal or Appmethod C++):
    Either a PC running a 64-bit version of Windows or a 32-bit development PC connected to a PC running a 64-bit version of Windows.
  • For developing OS X applications:
    A PC running Windows connected to an Intel-based Mac with 2 GB RAM or more, running either OS X 10.8 (Mountain Lion) or OS X 10.9 (Mavericks), over a local area network using an SSH, VNC or Windows file-sharing solution.
  • For developing iOS applications:
    In addition to the requirements for OS X applications, an iOS device (iPhone, iPad, or iPod Touch) connected to the Mac by Apple USB cable, Xcode installed: Xcode 4.5 for iOS 6, Xcode 4.6 for iOS 6.1.

Installing the .NET Framework on the Windows 8 Platform

On Windows 8, the Appmethod installer does not install the prerequisite Microsoft .NET Framework 3.5. Before starting the Appmethod install, you should perform the following steps:

  1. Open the Control Panel.
  2. Choose Programs and Features.
  3. Choose Turn Windows features on or off.
  4. Select Microsoft .NET Framework 3.5 (or 3.5.n), and its two subnodes (for HTTP Activation and non-HTTP activation).

If your machine is not connected to the Internet, Microsoft provides the following instructions on how to install .NET Framework 3.5 from ISO:

System Requirements

  • Intel Pentium processor or compatible, 1.6GHz minimum (2GHz+ recommended)
  • Mouse or other pointing device
  • DVD-ROM drive (if installing from a Media Kit DVD)
  • 1024x768 or higher resolution monitor
  • Basic GPU – Any vendor DirectX 9.0 class or better (Pixel Shader Level 2)
  • Color quality above 256 colors (32-bit or 16-bit is sufficient)
  • 1 GB RAM (2 GB+ recommended)
  • At least 35 GB Free disk space are required
    • 2-5 GB additional temporary free space for use by the installer
  • Host OS:
    • Microsoft® Windows 8 or 8.1 (32-bit and 64-bit)
    • Microsoft Windows 7 SP1 (32-bit and 64-bit)
    • Microsoft Windows Vista™ SP2 (32-bit and 64-bit) requires administrator rights
    • Microsoft Windows Server® 2008 and 2012 (32-bit and 64-bit)
      Appmethod can also be run on Mac OS X by using a virtual machine (VM) such as VMware Fusion or Parallels hosting Windows Vista, 7 or 8

Installing Boost Libraries (Appmethod C++ 32-bit Windows and 64-bit Windows)

If you are installing Appmethod C++ 1.14, you can download the Boost Libraries after signing in at

Note: For a 64-bit Windows Appmethod C++ installation, you might need 18 Gigabytes of free space (for the full product installation) in order to ensure that the Boost Libraries are correctly installed.
  • On a 64-bit Windows system, both Boost 1.50.0 and Boost 1.39 are installed.
  • When installing Boost 1.39, two separate versions are installed (32-bit Windows and OS X).

For more information, see Boost Libraries.

Requirements for Cross-Platform (Multi-Device) Application Development

Specific requirements vary according to the target platform.

Requirements for Developing 64-bit Windows Applications

  • Either a PC running a 64-bit version of Windows or a 32-bit PC connected to a PC running a 64-bit version of Windows
  • If the host is a Win32 machine, Platform Assistant server (paserver) must be installed on the remote platform:

Requirements for Developing Mac OS X Applications

  • PC running Windows connected to an Intel-based Mac, with 2 GB RAM or more, running OS X 10.9 (Mavericks) or OS X 10.8 (Mountain Lion) over a local area network using a SSH, VNC or Windows file sharing solution.
  • Platform Assistant server (paserver) installed on the Mac:

Requirements for Developing iOS Applications

  • PC running Windows connected to an Intel-based Mac, or a Mac running Windows in a VM, with 2 GB RAM or more.
  • The Mac must run OS X 10.9 or 10.8, with the latest version of Xcode that supports iOS 6.x or later.
  • An Apple Developer account is required to deploy iOS apps to physical devices.
  • Platform Assistant server (paserver) installed on the Mac:

Requirements for Developing Android Applications

  • PC running Windows connected to a supported Android device (that is, running on an ARMv7 processor with NEON support).

FireMonkey Requirements

FireMonkey development requires Object Pascal or Appmethod C++ running on Windows.

FireMonkey applications run on multiple platforms with these requirements:

  • 2 GB RAM or more
  • Basic Graphics Processing Unit (GPU):
    • For Windows development, any vendor DirectX 9.0 class or better (Pixel Shader Level 2)
    • For OSX development, OpenGL
      Note: Qualified Macs all have a qualified GPU.

General Installation Notes

Installer Requires Additional Temporary Space

If the drive containing the folder specified in your TEMP environment variable is low on space, the installer might halt with an error message noting the shortage. If this occurs, assign your TEMP variable to a folder on a drive with more disk space, then rerun the installation.

For more information, see #System Requirements.

Do Not Select the Upgrade Option in the Appmethod 1.14 Installer

Using the Upgrade option in the installer is not supported for this release. You can upgrade your product to a different version by running the Embarcadero License Manager and entering your new serial number.

Software that You Can Install Using the Product Installer

The installer program installs the product and optionally the product Help system.

Dinkumware Standard C++ Library, Internet Direct (Indy), and Subversion are installed as part of the main product.

If you are installing Appmethod 1.14, you can download the Boost Libraries for C++ after signing in at

For details about the third party software, see Third party add-ins.

Installing the Platform Assistant for Mac OS X and iOS Applications

In order to use the IDE to develop cross-platform applications for Mac OS X and iOS, you need to install and run the Platform Assistant on the target platform. The Platform Assistant is provided in the product \PAServer directory. The Platform Assistant installer also provides the Remote Debugger.

For more information, see:

Android Development Tools Installed During Product Installation

Android SDK and NDK: The Appmethod installer by default installs the Android SDK and NDK for you. If you want to develop Android apps, we recommend that you accept the installation of these tools by default. For more information, see Installing the Android Development Tools.

Java and the JDK: The Appmethod installer installs Java and the JDK by default if you do not already have Java 1.6 or 1.7 installed, even if you choose not to install the Android SDK and NDK. Following the installation, the installer will display the license agreement for Java and the JDK unless you prevent the installation of Java and the JDK by deselecting AndroidCore on the Feature Selections page of the installer.

FireMonkey Platform Requirements

Applications developed using FireMonkey have specific platform requirements, such as for the Graphics Processing Unit (GPU). For details see FireMonkey Platform Prerequisites.

Windows Vista, Windows 7, and Windows 8 Require Administrator Privileges

You must run as Administrator or be on the Administrator privileges list to install the product on Microsoft Windows Vista, Windows 7, or Windows 8.

Signing Up for Appmethod

You must sign up (register your product) with Embarcadero Technologies at An unregistered product will shut down and stop running. The registration dialog box appears when you start a product that is not registered.

To register your product, you need the following:

  • Serial Number: Enter the serial number in the registration dialog box, including hyphens.
  • Embarcadero Developer Network ID: You need to provide your EDN user name and password in the registration dialog box.

If you have any issues with registering your product, please contact Product Support at

Do Not Use Multi-byte Characters in Install Paths

Do not use double-byte characters in the path or directory for installation. Object Pascal and Appmethod C++ are Unicode-enabled, but the installer has not been enabled for Unicode.

Product is Available to All Licensed Users on the Same Machine

After installation, the product is available to all licensed users on the same machine.

Samples and Samples Source Code

Project samples (previously called Demos) are installed by default. The samples are also checked into Subversion at SourceForge. You can check SourceForge for additions or updates to the samples. For more information, see Samples Descriptions.

Online Help

In this release, the Help installer is integrated with the main product installer. If you see the message, "Online Help is being installed. This might take an extended length of time" but the install seems hung, minimize all open windows, so that you can find the help installer launch window. If it is present, click Yes to start the help installer. The help installer should complete in just a few minutes.

Microsoft Document Explorer 2008 (dexplore.exe) is required to install product documentation locally on your machine and for use with F1 lookups. If Microsoft Document Explorer 2008 is not installed, it will be installed as part of the Help system installation.

The Help is generated from the online docwiki. The docwiki is updated continuously, so please refer to it for more recent information. On the compiled H2 help, just click the Current Wiki Page link at the bottom of a page of help.

Installing from an ESD

If the product is purchased using Electronic Software Delivery (ESD), you receive an .exe file for Appmethod.

To install using an ESD download:

  1. Make sure you have an active Internet connection.
  2. Double-click the setup.exe to begin product installation.
  3. The installer downloads the required .zip files and uncompresses them.
  4. The installer asks you to supply an archive location for the .zip files.
    Note: Backing up the downloaded ZIP files is strongly encouraged so that in the future you can do a reinstall without downloading all the ZIP files again.
  5. The installer proceeds automatically. Follow the prompts.

Installing for Network Licenses

If you purchased a Network License (managed by the Embarcadero License Center), follow these instructions to set up the install image.

Note: Follow these instructions precisely or your users will be prompted for a serial number and will be unable to install.

Installing from a Media Kit

If you have a media kit:

  1. Copy all of the DVD files to a writable directory on your network.
  2. Copy the network license .slip file (received in your order confirmation email) to the product's main installation directory, where Setup.exe is located (typically, <Disc Drive:>\Object PascalCBuilder\Install).
  3. Instruct your users to run Setup.exe. When a user runs Setup.exe, the product detects the .slip file and installs the software. During installation, the .slip file is moved to the license folder in the installation directory.
  4. The installer proceeds automatically. Follow the prompts.
  5. Optionally, you can install the Microsoft SDK Help. By default, it is not installed.
  6. Optionally, you can install any or all of the third party products. Installed unless you deselect them.

Installing from a Download

If you have a download URL:

  1. Copy just the Setup.exe and .slip file into the same directory on your machine.
  2. Run Setup.exe and the installer will read the slip to determine which SKU (product version) you have purchased.
  3. The installer will copy the .slip file to the correct directory.
  4. The installer proceeds automatically. Follow the prompts.
  5. Optionally, you can install the Microsoft SDK Help. By default, it is not installed.
  6. Optionally, you can install any or all of the third party products. On the Select Features page of the installer, browse the component tree under "ThirdParty Addons". These are installed unless you deselect them.

Known Installation Issues

Uninstalling the Product

The user with Administrator privileges who initially installed the product can uninstall the product:

  1. Open the Windows Control Panel.
  2. Select Add or Remove Programs or Uninstall a program.
  3. Select the product name.
  4. Click Remove.

Uninstalling Instances that Use Network Licenses

After uninstalling, each user who is not the Administrator must remove user-specific data from the Windows registry:

  1. Log in to the user account.
  2. Make a backup of the registry.
  3. Launch Regedit or another registry editing tool.
  4. Delete the following registry key:

WARNING: Edit the Registry at your own risk. This document and other product documentation describes editing your Windows registry. In most cases, Embarcadero recommends that you use the Microsoft Regedit tool to perform editing. Whatever tool you use, before you make any changes, you should make backups of your registry and thoroughly familiarize yourself with the editing tool and the registry editing process. The registry is a critical component of your operating system, and any mistakes you make while editing it can potentially cause your machine to stop functioning.

Removing Configuration Files

After uninstalling, user-specific data such as default project settings might remain in configuration files. You should manually remove these folders:

  • All Users\Application Data\Embarcadero\BDS\14.0
  • All Users\Shared Documents\Embarcadero\BDS\14.0

If You Have an Installation Problem

Please open a support case on the web site if you encounter any problems during installation.

See Also