Creating a Project

When you create a project, you must specify a folder to hold the project file. This folder must already exist somewhere on your computer. If the existing folder has files and subfolders, you can add them to the project.

After creating the initial project you can add, edit, and delete folders in the project as necessary. You can also add and remove individual project files.

Creating the initial project

Before creating a project, you can optionally set options to apply to all new projects. Or you can go ahead and create a project, and edit its properties later if necessary (see "Working with a Project").

To set default options for new projects:

  1. Open Options > Settings > Projects.
  2. Specify project options as needed.

    The following table provides information about each setting.
    Setting
    Description
    Maximum recent projects
    Maximum number of projects to appear in the drop-down list of projects in the top pane of the Projects Resource tab.
    Default project folder type
    Manual include or Auto include. For a description of manual-inclusive and auto-inclusive folders, see "Physical folders".
    New auto-include folders include subfolders
    If selected, a new auto-inclusive project folder will include in the project not only the files it contains but also the files and folders in its subfolders.
    Include project resources checkbox and the resource table
    For instructions to select, add, edit, and delete default resources for a new project, see "Working with resources".
    Options in the Projects > Deployment pane
    For a description of these options, see "Setting Project Level Deployment".

  3. When you are done, click Apply.

To create a project:

  1. Create a folder on your computer to hold the new project, if the folder does not already exist.
  2. Select Project > New Project from the menu.

    The New Project dialog box appears.

  3. Complete the New Project dialog box as follows:
  4. Click OK to create the project structure and the project control file.

Adding folders

When you add a folder to a project, you must decide where that folder falls within the project tree. You can add a folder to the project root or you can add a folder to an existing folder.

There are some limitations to where you can add virtual folders. Virtual folders can only be added to the project root or to another virtual folder. You cannot add a virtual folder to a physical, but you can add a physical folder to a virtual folder. Also, you cannot place a virtual folder under source control, and files in a virtual folder must be manually selected for deployment. So, only use virtual folders when you need a container to hold a number of files in different locations.

When you create a physical folder, you are in essence just creating a reference to a directory that already exists on your computer.

For a full description of each type of folder, see "About project folders".

To add a virtual folder:

  1. Right-click on the project root icon (the globe) for the new virtual folder (either the project root or another virtual folder) and select Add Folder from the popup menu.

    The Add a Project Folder dialog box appears.

  2. Type a folder name in the Folder Name box.
  3. Click Virtual Folder and click OK.

The folder is added to your project.

To add a physical folder:

  1. Right-click the parent for the new manual-inclusive folder (either the project root or any other folder) and select Add Folder from the popup menu.

    The Add a Project Folder dialog box appears.

  2. Type a folder name in the Folder Name box.
  3. Click Physical Folder.
  4. Click the Browse button to locate the directory using the Select Directory dialog box, or type the path for the directory to be referenced in the Directory Path box.
  5. For a manual-inclusive folder, click OK and skip the rest of this procedure.

    The manual-inclusive folder is added to your project. You must manually add files in order to populate the folder.

  6. For an auto-inclusive folder, click Auto Include Files Using Filter.
  7. Select a filter from the drop-down menu (a filter limits the files that will be included based on the file extensions that you specify). Or, type the file extension of each type of file to include in the folder, separated by semicolons.
  8. Click OK.
  9. Complete the Include Files in New Folder dialog box:
  10. Click OK.

The auto-inclusive folder is added to your project and is populated according to the options you set in steps 7 and 9.

To edit a physical folder:

  1. Right-click the parent for the new manual-inclusive folder (either the project root or any other folder) and select Properties from the popup menu.

    The Edit a Project Folder dialog box appears.

  2. Change properties as needed.

    For details, see "To add a physical folder:".

  3. Click OK to save your changes.

To remove any folder:

  1. Right-click the folder and select Remove Folder from the popup menu.
  2. Click Yes to confirm that you want to remove the folder.

The folder is removed from the project. This has no effect on the actual files in the mapped directory; you have only removed the reference to the folder in the APF file.

Adding files

The methods for working with a file in a project can vary slightly, depending on the type of folder that contains the file.

You can perform standard drag and drop operations to move files from the Projects file list in the bottom pane of the Projects tab into project folders. You can also drag files from the Project tab to the Editor for editing.

Files in manual-inclusive or virtual folders

The process for adding and deleting files is the same for both virtual and manual-inclusive folders. However, you cannot use these methods for adding files to or removing files from an auto-inclusive folder.

To add files to a manual-inclusive or virtual folder:

  1. Right-click the folder and select Add Files to Folder from the popup menu.

    The Add Files to Folder dialog box appears.

  2. Locate and select the files you want to add to your project folder.

    You can select multiple files by holding down the Shift or Ctrl key.

  3. Click Open to add the files to the folder.

To remove files from a manual-inclusive or virtual folder:

  1. Select the folder in the project tree.

    The files contained in the selected folder appear in the Project file list.

  2. Right-click the file that you want to remove in the Project file list and select Remove From Project.
  3. Click Yes to confirm that you want to remove the file.

The file is removed from the project. This has no effect on the actual file in the mapped directory; you have only removed the reference to the file in the APF file.

Files in auto-inclusive folders

You control the files that are included in an auto-inclusive folder by specifying the files types that are allowed. You can change the file types at any time to alter the included files.

To change the types of files allowed in an auto-inclusive folder:

  1. Right-click the auto-inclusive folder and select Properties from the menu.

    The Edit Folder Properties dialog box appears.

  2. Change the Include Files Using Filter list to contain the extensions for the file types you want included in the folder. You can change the extensions by using the drop-down list or by manually entering the extensions, separated by semi-colons.
  3. Click OK.

The list of included files is filtered according to the extensions you specified.

Comments