DCCIOS32.EXE, the Delphi Cross Compiler for the iOS Simulator

From RAD Studio
Jump to: navigation, search

Go Up to Command-Line Utilities Index

The DCCIOS32 compiler is a member of a new branch or "next generation" on the Delphi family tree (that is, the Delphi mobile compilers).

DCCIOS32 compiles iOS apps that run on the iOS simulator on a Mac OS X system. The iOS Simulator is a useful test platform for iOS apps, because it requires only a connection to the Mac (no physical iOS device is involved).

To target an iOS device, use the DCCIOSARM.EXE, the Delphi Cross Compiler for the iOS Device.

Differences between DCCIOSARM-DCCIOS32 and Other Delphi Compilers

Many of the differences between the Delphi mobile compilers and other Delphi compilers are related to either the iOS platform or new Delphi language features.

New Language Features in the Delphi Mobile Compilers

The two Delphi iOS compilers introduce some significant new features in the Delphi language.

Following are the major language differences between the Delphi mobile compilers and the Delphi desktop compilers:

  • Automatic reference counting (ARC) for classes is supported by the Delphi mobile compilers. All Delphi compilers (desktop and mobile) support ARC for interfaces and dynamic arrays.
  • Strings are 0-based (instead of 1-based) and are likely to become immutable (constant) in the Delphi mobile compilers.
  • The following string types are NOT supported by the Delphi mobile compilers (but they do support UnicodeString, the default string type):
    • WideString
    • AnsiString and ShortString
    • AnsiChar
    • PAnsiChar and PWideChar
    • OpenString
  • Use of pointers is not supported by the Delphi mobile compilers.

For more information about writing code for the Delphi mobile compilers, see Migrating Delphi Code to iOS from Desktop.

Compiler Project Options for DCCIOS32

DCCIOS32 exposes many of the same compiler options and behaviors as DCCIOSARM, the Delphi mobile compiler for the iOS Device, as well as the other Delphi compilers. Help for compiler options is available in Delphi Compiler Project Options.

Options Supported by DCCIOS32 and Not Supported by DCCIOSARM

The following compiler options are supported in the IDE for DCCIOS32, but are not supported by DCCIOSARM, the Delphi compiler for the iOS Device:

Delphi Options Not Supported by DCCIOS32

The following compiler options for Delphi desktop applications are not supported in the IDE if the target platform is iOS Simulator:

  • No separate .tds file for linking (Linking)
  • No Windows-only options such as PE Headers (Linking)
  • No ARM map file (supported by DCCIOSARM) (Linking)
  • No minimum iOS version supported (supported by DCCIOSARM) (Linking)
  • No additional options for linker (supported by DCCIOSARM) (Linking)
  • No framework search path and no system library root path (both supported by DCCIOSARM) (Delphi Compiler)

Displaying the Help

To display the help for the command-line compiler, run the compiler with the -h switch:

dccios32 -h

DCCIOS32 command-line options are very similar to those for the Delphi desktop compilers, such as DCC32, DCC64, and DCCOSX.

See Also