Read Me:Embarcadero Prism

Thank you for choosing Oxygene, the Next Generation Object Pascal development solution from RemObjects Software's Oxygene, licensed by Embarcadero as Prism™ XE3.2.

Oxygene comes in three flavors: Oxygene for .NET, which generates code for the Microsoft CLR as used on .NET, Mono, Silverlight and WinRT, Oxygene for Java, which targets the Java and Android runtimes, and the new Oxygene for Cocoa for native Mac and iOS development. With Prism, you get the .NET edition of Oxygene; the other two flavors are available separately from RemObjects Software.

Our goal with Oxygene is to provide you with a powerful language and state-of-the-art development environment for all your software development needs on the .NET, Cocoa and Java platforms and the surrounding ecosystems.

Oxygene is not standing still. We will continue to improve the product over time and these improvements will be available to you as part of your subscription. To ensure continued access to the latest release and to stay up to date with the most recent fixes and new features, please make sure that your subscription stays active.

Please check remobjects.com/oxygene to keep your product up to date with the latest additions, or register your serial number with us, to receive updated information directly from RemObjects Software

Prism XE3.2

Prism XE3.2 is a major feature update and provides new features and bug fixes throughout the product, along with a major new version (6.0) of the Oxygene language. Information on what's new is available at remobjects.com/oxygene/whatsnew. A comprehensive list of all changes, including bugfixes, is available online on the Change Logs page.

Prism XE3.2 is available to all Prism customers with active SA that extends to May 31, 2013 or beyond. It will require a new "XE3.2" serial number, which customers with SA will receive automatically from Embarcadero. If you have SA and did not receive an XE3.2 serial number, please contact Embarcadero support.

Prism customers without SA can renew to the full Oxygene package to receive Oxygene 6 (for all three platforms, .NET, Cocoa and Java). Read remobjects.com/oxygene/prism for more details.

As a Delphi, RAD Studio or Prism customer, you can choose to renew or cross-grade to a full "Oxygene" license directly from RemObjects Software at any time, to (a) add Oxygene for Cocoa and Java to your development tool belt and (b) receive updates, feature releases and support directly from RemObjects Software. Once again, you can read more at remobjects.com/oxygene/prism.

IDEs and Requirements

Oxygene integrates with the Visual Studio 2010 and Visual Studio 2012 IDEs. Future versions will add integration for other cross-platform IDEs, including MonoDevelop and Eclipse. If you do not have a copy of Visual Studio 2012 installed yet, Oxygene will install the Visual Studio 2012 Shell for you. (You will need to download the larger ISO for this option; it will also install any requirements for Visual Studio and the compiler, including the Microsoft .NET Framework, if necessary.)

.NET Requirements:: The Oxygene compiler will require the .NET 3.5 framework to be installed to run (the .NET 4.0 or 4.5 framework alone does not suffice). The compiler allows you to target any version of the framework from 2.0 to 4.5, as well as Mono 2.x, the Compact Framework 2.0 and 4.0, Silverlight 5.0 and WinRT.

Note: The final ("RTM") release of Windows 8, and either Visual Studio 2012 Professional or higher or a parallel install of Visual Studio Express 2012 for Windows 8 are required to build apps for WinRT.

Cocoa Requirements: Oxygene for Cocoa requires network access to a Mac running OS X Lion or later, with Xcode 4.3 or later and CrossBox installed. Developing for iOS hardware or deploying to the iOS and Mac App Store will require membership to the appropriate Apple Developer Programs. See Setting up Xcode for more details.

Java Requirements: Since Oxygene for Java lets you build applications that link against the Java or Android runtime environments, you will also need to install a copy of the Java Development Kit (JDK) and, optionally, the Android SDK. For Java development, JDK version 6.0 or later is required, we recommend installing the latest version 7 of the JDK. For Android development, the Android SDK is required in addition to the JDK. Please refer to the JDK and Android SDK's documentation for additional requirements.

When opening or creating new Java or Android projects, Oxygene for Java will automatically perform a Preflight Check to see if the necessary components, including the JDK and the Android SDK, are installed as necessary, and provide you with detailed information of what may be missing.

You can read more about the preflight check feature and find the appropriate download links for JSDK and Android SDK here.

Installing, Uninstalling, and Upgrading

If you have a previous version of Oxygene installed, the setup automatically detects that and upgrades to the new version. It is not required to uninstall the previous version first.

If you running the Oxygene for .NET or Oxygene setup on a system that already has Oxygene for Java installed, setup will merge the two products and automatically update Oxygene for Java to the version you are installing, if necessary. The same is the case when running the Oxygene for Java setup on a system that already has Oxygene for .NET installed.

Using the Oxygene Command Line Compiler on Mac OS X

The Oxygene command line compiler can be used on Mac OS X. At the time of this writing, we are not providing a Mac OS X based download and installer for Oxygene, but you can install Oxygene on a Windows machine or VM and copy the \Bin folder over to your Mac. The Oxygene command line compiler requires Mono 2.6 or later (we recommend Mono 2.10 or later) to run, and can be invoked using the command

$ mono Oxygene.exe <parameters> .

The Oxygene compiler will try to automatically locate the Mono SDK and the Apple-provided Java SDK on the system. Please note that as of Mac OS 10.7 Lion, Java is an optional component and must be installed explicitly. You can see if Java is installed simply by executing the command

$ java

from terminal; if Java is not yet installed, the OS will automatically launch the Software Update application and ask whether you want to download and install Java from Apple's servers. You will need to manually install and provide paths to the Android SDK when targeting Android.

Using the Oxygene Command Line Compiler on Linux

Using Mono, the Oxygene command line compiler can also be used on Linux, but this platform combination is not yet officially supported, and you will need to manually let the command line compiler know where to find the Mono, Java and/or Android SDK libraries.

License

After first install, Oxygene install starts out as a time-limited trial. You will be prompted about this trial period and offered an option to activate the product with a Prism XE3.2 serial number when you open or create an Oxygene project in the Visual Studio IDE for the first time. You can choose to either activate your product right away, or keep working with the trial license until the activation is more convenient for you. Activation will be required within 30 days.

RemObjects Software customers: If you own a license for Oxygene 5.2 or later via purchase from RemObjects Software or one of our resellers, or via an active Suite Subscription for .NET, Cocoa or Java, you can skip activation with serial number and choose to download your personal license file, instead.

Command Line Compiler: The command line compiler is freely available at no charge and can be used without a paid license.

Sample Projects

A number of sample projects are included in the RemObjects Samples folder of your Shared Documents folder.

These sample projects will show you how to get started and how to use the various functions of Oxygene and are grouped into various categories such as Language, Android, etc. A detailed introduction to the available samples can be found in the Samples section.

After the first launch of your development IDE, the Welcome Page for Oxygene will be presented, giving you the option to directly open any of the sample client applications.

Please Note: Samples have been moved from underneath the product install to the Shared Documents folder to make them more easily usable for non-Admin users on Windows Vista and Windows 7, where the Program Files folder is read-only during normal operation.

Product Support

Peer-to-peer support for Oxygene is available via our community platform, “RemObjects Connect” at connect.remobjects.com.

Beta Access

Note that as user with an active product subscription, you automatically have access to our beta program, which gives you access to regular beta and gamma builds of the product. You can read more about this here: Beta Access.

We strive to have weekly beta or gamma releases (and sometimes both) available, usually every Friday. Please refer to the Oxygene Beta category on RemObjects Connect for details, and use this category for all discussion of beta and gamma releases and for feedback and bug reports.

Problems and Issues

A list of known and resolved problems and issues is available on this wiki under Known Issues. Please also make sure to review the list of any Breaking Changes that might affect your projects.

Thank You

Let us thank you again for choosing Prism and Oxygene. We are confident that you will find it to be a worthwhile addition to your development toolset. Should you at any time encounter a problem or need assistance using the product, please feel free to ask on the forums or contact us directly via email at support@remobjects.com.

 

Best Regards,
Your RemObjects Team
www.remobjects.com