Amethyst Tutorials

Back to -Tutorials -Amethyst Tutorials

Converting and Importing Flex Projects For Amethyst

If you have existing Flex projects, this is how to get them into Amethyst...

The Amethyst Project Import and Conversion Wizard provides an easy way of importing your Flex, AIR and ActionScript projects for use with Amethyst. This guide takes you through this process step by step...

To start the Wizard, select File, Import or Convert Flex Project...

You will now see the opening screen of the Wizard.....

From the drop-down list you may select either Convert project in original location or Import project to new location...

Which option should you choose?

- Convert project in original location

Choose this if you wish to leave your project in its original directory. This may be useful if (for example) you want to share the project between Adobe Flex Builder and Amethyst. The Wizard will create a new project and Solution file to let you work with the project in Visual Studio but it will not modify your source files so you may also continue editing them in Flex Builder.

Note: The names of directories created by Amethyst when a project is built are different from the defaults created by Flex Builder. If you wish to share the same codebase between Amethyst and Flex Builder, ensure that your Flex Builder project does not include directories with the names used by Amethyst. These are:

- config
- bin

- Import project to new location

Choose this if you wish to make a completely new copy of the project in a different directory.

When you have selected an option, click Next.


If you chose to Convert, refer to the section headed Converting later in this tutorial.

- If you chose to Import, you will now see this screen...

There are three fields which you need to complete as shown below:

First you need to select the directory containing the original project. If this is a Flex Builder project this is normally the directory containing the .project file and several subdirectories including \src. The Import Wizard has a button to let you browse the disk to find this directory (the location of the original project)...

Now you need to select a location for the imported project. This is the directory in which a copy of the original project will be made. Once again, there is a button to let you browse your disk. If you need to create a new directory you may do so by clicking the ‘Make New Folder’ button.

Finally you need to give a name to your project. This will define the name of the Visual Studio solution and project files...


- If you chose Convert in screen one of the Wizard you will see this screen...

Since you will not be copying any files to a new location, the Convert Wizard has only two fields: the location of the existing project and the name you wish to give to the Visual Studio project and solution (as with the Importer described above, you can click the button to browse to the project directory)...

Setting Options

Whether you are Importing or Converting you may specify a number of options in the final screen of the Wizard...

The first three items are read-only and show the choices made earlier in the wizard:

- Amethyst Project Name
- Location of Original Project
- Location of new Amethyst Project

If you wish to edit these, click the ’Previous’ button to go back to the previous screen in the Wizard.

Beneath these are a number of additional options...

Project Type lets you specify whether the project is Flex, AIR or ActionScript. If you are importing or converting a Flex Builder project, Amethyst will attempt to auto-detect the project type.

Output Type lets you select whether this is an Application or a Library project. Application is the default.

Exclude selected files and folders from new project lets you enter an optional semicolon-delimited list of file extensions. If files with these extensions exist in the original project they will not be added to the Amethyst project/solution. For example, to omit .bak and .swf files you would enter:


You may also exclude an optional semicolon-delimited list of directories. For example, to omit the directories bin-debug and history you would enter:


The two check-boxes at the bottom allow you to exclude hidden files and directories (those with the hidden attribute set) and Flex Builder settings files (those Flex Builder files beginning with a dot such as .project, .flexProperties and .actionScriptProperties).

Click the Finish button to import or convert your project. A new Amethyst project and solution will now be created and its files and folders will be added to the Solution Explorer. If this is a Flex Builder project, Amethyst will attempt to detect the main file...

If Amethyst is unable to determine the main file or if you wish to define some other file as the main file, you may do so by right-clicking a file name in the Solution Explore and selecting Set as Main. The name of the main file is displayed in bold text in the Solution Explorer:

Bookmark and Share   Keywords:  Amethyst  tutorial
© SapphireSteel Software 2014