Installation Notes for Appmethod 1.15

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.15.

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:

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)
  • The latest service packs and security updates are recommended for all platforms
  • Microsoft Internet Explorer 6.0 SP1 or later

Prerequisites

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.

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: http://msdn.microsoft.com/en-us/library/hh506443%28v=vs.110%29.aspx.

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 11.0 class or better

For 3D graphics, Direct3D 11.1 or better (Pixel Shader Level 5) is preferred, but the installed version of Direct3D will be used

(files Windows6.1-KB2670838-x64.msu or Windows6.1-KB2670838-x86.msu)

      • Additional memory requirements for 3D: System must allow for resources greater than 4GB in size, while keeping indices of all resources at 32-bit
  • Color quality above 256 colors (32-bit or 16-bit is sufficient)
  • 1GB RAM (2 GB+ recommended)
  • Between 3 and 18 GB (or more) Free disk space are required *
  • 0.5-1.5 GB additional temporary free space for use by the installer
  • Total disk space required can be as much as 35 GB
  • Host OS:
    • Microsoft® Windows 8 or 8.1 (32-bit and 64-bit)
    • Microsoft Windows 7 SP1 (32-bit and 64-bit)
Notes:
  • Appmethod can also be run on Mac OS X by using a virtual machine (VM) such as VMware Fusion or Parallels hosting Windows 7 or Windows 8.
  • Microsoft Windows Server® 2008 and 2012 (32-bit and 64-bit) are supported only for deployment of apps.

The Adobe Flash Player is required to play the tutorial videos. You can obtain the Flash Player from: http://get.adobe.com/flashplayer/

Installing Windows 8 SDK (Appmethod C++ Win32 and Win64)

Microsoft Windows 8 SDK Installer will install the Microsoft Windows 8 SDK and additional headers that are required for Windows 8 Bluetooth LE support in Appmethod C++.

Microsoft Windows 8 SDK Installer is available here: http://altd.embarcadero.com/download/radstudio/xe7/mssdk_15_win.exe

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

System and device requirements vary according to the target platform, as described in this section.

Requirements for Developing 64-bit Windows Applications

Either:

  • A PC running a 64-bit version of Windows
  • A 32-bit PC connected to a PC running a 64-bit version of Windows

Requirements for Mac OS X Development

PC running Windows connected to an Intel-based Mac, with 2 GB RAM or more, running either 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.

For both Mac OS X and iOS app development, you need to install the Platform Assistant server (PAServer) on the Mac. The PAServer directory is located inside the product installation directory. Installation instructions are available here:

For more information, see PAServer, the Platform Assistant Server Application.

Requirements for iOS Development

In addition to the requirements for Mac OS X applications, you need:

  • An iOS device (iPhone, iPad, or iPod Touch) connected to the Mac by Apple USB cable
  • The Mac must run OS X 10.9 or 10.8, with the latest version of Xcode that supports iOS 7.

Requirements for Android Development

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

FireMonkey Requirements

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

Software that You Can Install Using the Product Installer

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

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

Additional Software You Can Download from Appmethod.com

Registered Appmethod users can download the following additional software:

  • Boost Libraries (for C++)
  • Framework Source Files (Object Pascal .pas source files for FMX and RTL units)

To download this software, visit http://www.appmethod.com/downloads (sign in using your Embarcadero Developer Network ID)

Installing the Platform Assistant for Multi-Device Applications

In order to use the IDE to develop multi-device or cross-platform applications, 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:

Installing the Android Development Tools

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.

Serial Number (License Key)

The serial number, also called the license key, that you enter determines the type of your license (commercial or trial).

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.

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.

Registering Your Product

The registration dialog box appears when you start a product that is not registered. You must register your product with Embarcadero Technologies; an unregistered product will shut down and stop running.

To register your product, you need the following:

  • Serial Number: If you used a serial number to install the product, the serial number should be prepopulated in the registration dialog box. If the serial number is not present, please enter it 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 http://www.embarcadero.com/support.

Do Not Use Multi-byte Characters in Install Paths

Do not use double-byte characters in the path or directory for installation. Object Pascal is 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.

Online Help

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. When prompted, enter the serial number for the product. You can find the serial number in the order confirmation email.
  4. The installer downloads the required .zip files and uncompresses them.
  5. 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.
  6. The installer proceeds automatically. Follow the prompts.

Installing for Network Licenses

If you purchased a Network License (managed by AppWave™ or the Embarcadero License Server or FlexNet), 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.
  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 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.

Installing a Trial Edition

If you are going to use the trial edition, you can find the Appmethod trial download at:

To request the Appmethod trial, you can use your private email or your existing Facebook or Google+ account.

To register your Appmethod trial, you do not need to acquire an EDN account.

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:
    HKEY_CURRENT_USER\Software\Embarcadero\BDS\<n.n>

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 if they are present:

  • All Users\Application Data\Embarcadero\Appmethod\13.0
  • All Users\Application Data\Embarcadero\Appmethod\14.0
  • All Users\Shared Documents\Appmethod\13.0
  • All Users\Shared Documents\Appmethod\14.0

If You Have an Installation Problem

Please open a support case on the http://support.embarcadero.com web site if you encounter any problems during installation.

See Also