Create New Force.com Project

To launch the Create New Force.com Project wizard, select File | New | Force.com Project.

If you do not see Force.com Project in the File | New menu, you are not using the Force.com perspective. You can still create a Force.com project without using the Force.com perspective by selecting File | New | Other | Force.com | Force.com Project; however, you should use the Force.com perspective because it includes other views and features that aid development. To activate the Force.com perspective, select Window | Open Perspective | Other | Force.com Perspective.

Note

The New Force.com Project wizard has two pages:

  1. On the first page of the wizard, enter the appropriate properties for the project. For details on these settings, see Force.com Project Properties. Click Next.

    When you create a new project, you might be prompted about a new master password. This is a separate password of your choosing required by Eclipse secure storage, and is not associated with your Salesforce credentials. For details on Eclipse secure storage, see the Eclipse Workbench User Guide.

    Note

  2. On the Project Contents page, choose which metadata components are retrieved:
    Field Description
    Apex and Visualforce (classes, triggers, pages, components, and static resources) Select this option to retrieve only Apex and Visualforce components, including classes, triggers, components, pages, and static resources.
    Selected metadata components Select this option and click Choose... to open the Choose Metadata Components dialog.
    Contents of package Select this option and click Choose package... to retrieve the contents of a particular package. Note that this option is only available when there are packages on the organization you connect to.
    None Select this option to retrieve no components. You might want to select this option if you are working in a team-based environment where source files are checked out from a source-control system. When creating a project offline, this is the only option available.
  3. Click Finish to create the new project.

The selections you make in the New Force.com Project wizard are used to create the package.xml file, which defines which components from the server are downloaded into your project. To later modify the project contents, right-click your project and choose Properties, and go to Force.com | Project Contents. In special cases you may want to edit the package.xml file by hand. For information on changing the contents of your project manifests after project creation, see About Package.xml.

Note