Difference between revisions of "Creating New Projects with Eclipse"

From wiki.emacinc.com
Jump to: navigation, search
Line 1: Line 1:
{{todo|Port this and finish it.|Michael Gloff|project=oe 4,mg}}
+
{{todo|Port this and finish it.|Michael Gloff|project=oe 4,InProgress,mg}}
  
 
The purpose of this guide is to demonstrate how to create a new project in Eclipse using the EMAC Open Embedded SDK. This will include a step-by-step procedure which assumes that the SDK has already been [[ Importing_the_EMAC_OE_SDK_Projects_with_Eclipse | imported ]].
 
The purpose of this guide is to demonstrate how to create a new project in Eclipse using the EMAC Open Embedded SDK. This will include a step-by-step procedure which assumes that the SDK has already been [[ Importing_the_EMAC_OE_SDK_Projects_with_Eclipse | imported ]].
Line 15: Line 15:
 
Before getting started creating a new project, the following setup must be performed. It is up to the application developer whether the new project will be placed in the EMAC-OE-arm-linux-gnueabi-SDK_XX.YY/projects project folder in the Eclipse Project Explorer View or within its own project folder. The latter does involve more complexity during setup, though it is a bit neater to work with since it does not require the developer to navigate the SDK directory tree to get to the new project.
 
Before getting started creating a new project, the following setup must be performed. It is up to the application developer whether the new project will be placed in the EMAC-OE-arm-linux-gnueabi-SDK_XX.YY/projects project folder in the Eclipse Project Explorer View or within its own project folder. The latter does involve more complexity during setup, though it is a bit neater to work with since it does not require the developer to navigate the SDK directory tree to get to the new project.
 
Note that only one of the following subsections is necessary to move on to the General Setup Section.
 
Note that only one of the following subsections is necessary to move on to the General Setup Section.
==Creating a New SDK Project==
+
 
 +
==Creating a New SDK C Project==
 
   
 
   
 
<cl>
 
<cl>
Line 27: Line 28:
 
<br clear=all>
 
<br clear=all>
  
* From the workspace, select File->New->Project
+
* From the Eclipse menubar, select File->New->Project
 
* Under C/C++, select C Project then next
 
* Under C/C++, select C Project then next
  
Line 34: Line 35:
 
<br clear=all>
 
<br clear=all>
  
* In the C Project dialog window, enter “hello” in the Project name: field.
+
* Enter “hello” in the Project name: field.
 
* Scroll down and choose Makefile Project -> Empty Project in the Project type: list.
 
* Scroll down and choose Makefile Project -> Empty Project in the Project type: list.
 
* Ensure that – Other Toolchain – is selected in the Toolchains: list.
 
* Ensure that – Other Toolchain – is selected in the Toolchains: list.
Line 51: Line 52:
  
 
</cl>
 
</cl>
 +
 +
==Creating a New SDK QT Project==
 +
 +
The process for creating a new QT project is similar to creating a new C project with some minor differences.
 +
 +
<cl>
 +
1. Make sure that the SDK has been configured according to [[Configuring_EMAC_OE_4.0_SDK | Configuring the SDK ]]
 +
* Start Eclipse.
 +
* From the Eclipse menubar, select File->New->Project
 +
* Under Qt, select Qt Gui Project or Qt Console Project then click Next
 +
 +
[[File:New_qt_project.png|600px|thumb|left|Figure 4: New Qt Project ]]
 +
 +
<br clear=all>
 +
 +
* Enter myproject in the Project Name: field and click Finish.
 +
 +
{{mbox | type=information | text = Make sure that the Location is set to the /path/to/sdk/projects folder as noted above.}}
 +
 +
[[File:New_qt_gui_project.png|600px|thumb|left|Figure 5: New Qt Project ]]
 +
 +
<br clear=all>
 +
 +
* Accept the default file names for the project and click Next
 +
 +
[[File:New_qt_project_pg2.png|600px|thumb|left|Figure 6: New Qt Project ]]
 +
 +
<br clear=all>
 +
 +
* Select any additional Qt modules that are required for the project, then click Finish
 +
 +
[[File:New_qt_gui_project_pg3.png|600px|thumb|left|Figure 7: New Qt Project ]]
 +
 +
<br clear=all>
 +
 +
</cl>
 +
 +
The project is now set up and ready to begin coding an application. For more information on creating Qt applications see [ http://qt-project.org/doc/qt-4.8/gettingstartedqt.html Getting Started Programming with Qt ] on the Qt website.
  
 
==General Setup==
 
==General Setup==
Line 123: Line 162:
  
 
===Cross-Compile===
 
===Cross-Compile===
To build the project, ensure the project is highlighted in the Project Explorer treeview in the left pane, then select Project->Build Project.  The project will now build, and your window should appear similar to figure 9.
+
To build the project, ensure the project is highlighted in the Project Explorer treeview in the left pane, then select Project->Build Project. For a Qt project first run Project->Run qmake.  The project will now build, and your window should appear similar to figure 9.
  
 
:[[File:Eclipse hello project built.png|400px|thumb|left|Figure 9: Eclipse Workspace]]
 
:[[File:Eclipse hello project built.png|400px|thumb|left|Figure 9: Eclipse Workspace]]

Revision as of 21:09, 7 November 2013

TODO: {{#todo:Port this and finish it.|Michael Gloff|oe 4,InProgress,mg}}

The purpose of this guide is to demonstrate how to create a new project in Eclipse using the EMAC Open Embedded SDK. This will include a step-by-step procedure which assumes that the SDK has already been imported .
Since this guide is specific to the EMAC OE SDK, it is not interchangeable with a general guide on creating a new Eclipse project.


Required Tools

New Project Setup

Before getting started creating a new project, the following setup must be performed. It is up to the application developer whether the new project will be placed in the EMAC-OE-arm-linux-gnueabi-SDK_XX.YY/projects project folder in the Eclipse Project Explorer View or within its own project folder. The latter does involve more complexity during setup, though it is a bit neater to work with since it does not require the developer to navigate the SDK directory tree to get to the new project. Note that only one of the following subsections is necessary to move on to the General Setup Section.

Creating a New SDK C Project

  1. Make sure that the SDK has been configured according to Configuring the SDK

  2. Start Eclipse.

    Figure 1: Select Eclipse Workspace


  3. From the Eclipse menubar, select File->New->Project

  4. Under C/C++, select C Project then next

    Figure 2. Open C Project


  5. Enter “hello” in the Project name: field.

  6. Scroll down and choose Makefile Project -> Empty Project in the Project type: list.

  7. Ensure that – Other Toolchain – is selected in the Toolchains: list.

  8. Click the Finish button.

  9. Select Yes to open the C/C++ perspective if prompted

    Figure 3: New Eclipse Project


  10. The workbench should look similar to Figure 4 below.

    Figure 3: New Eclipse Project



Creating a New SDK QT Project

The process for creating a new QT project is similar to creating a new C project with some minor differences.


  1. Make sure that the SDK has been configured according to Configuring the SDK

  2. Start Eclipse.

  3. From the Eclipse menubar, select File->New->Project

  4. Under Qt, select Qt Gui Project or Qt Console Project then click Next

    Figure 4: New Qt Project


  5. Enter myproject in the Project Name: field and click Finish.

    Figure 5: New Qt Project


  6. Accept the default file names for the project and click Next

    Figure 6: New Qt Project


  7. Select any additional Qt modules that are required for the project, then click Finish

    Figure 7: New Qt Project



The project is now set up and ready to begin coding an application. For more information on creating Qt applications see [ http://qt-project.org/doc/qt-4.8/gettingstartedqt.html Getting Started Programming with Qt ] on the Qt website.

General Setup

Generate Eclipse Make Targets

The following will demonstrate how to add the all, clean and upload targets for make


  1. Click on the Make Target view tab in the right hand pane.

  2. Right click on hello to bring up the context menu.

  3. Select New...

    Figure 4: Make Target context menu


  4. Create the make targets all, clean and upload as in figures 5,6 and 7.


Modify the Makefile

Once the Make Targets have been created, a Makefile needs to be created that contains the same targets so that GNU make knows how to compile and link the source into a binary that will run on the target machine. See the Makefile modification section of the EMAC OE SKE New Project guide for more explanation.

Alternate Project Locations

If the project is created outside of the /path/to/sdk/projects directory, the paths present in the make file and path to the SDK and global.properties files will need to be modified as below.


  1. Copy the correct global.properties file from the SDK/projects directory to the current project directory

    cp -L /path/to/sdk/projects/global.properties /path/to/project/hello
    
  2. Modify the include line at the top of the make file to refer to the new global.properties file

    include global.properties
    
  3. Change the value of SDKBASE in global.properties to point to the location of the SDK installation.


Using the New Project

The next step is to write some example C code for the project. See Write the C Code section of the EMAC OE SKE New Project guide for more explanation.


  1. Open the C/C++ Perspective if it is not open already.

    1. From the Eclipse menubar, select Window -> Open Perspective -> Other...

    2. Select C/C++ and click OK

  2. Create a new C file using the Eclipse New Source Wizard.

    1. From the Eclipse menubar, select File-> New-> Source File.

    2. Set the Source File: field to hello.c

    3. Set the value of Template: to <None>

    4. Click Finish

  3. If the new C file did not open automatically, open it by double clicking hello.c the the left pane

  4. Copy the code from Listing 1. in the C code writing section of the EMAC OE SKE New Project guide.

  5. Save the file by selecting File->Save from the Eclipse menubar. See figure 8 for how Eclipse should look.

    Figure 8: Eclipse Workspace


Cross-Compile

To build the project, ensure the project is highlighted in the Project Explorer treeview in the left pane, then select Project->Build Project. For a Qt project first run Project->Run qmake. The project will now build, and your window should appear similar to figure 9.

Figure 9: Eclipse Workspace


If there are any build errors, they will be shown in the Console and/or Problems tabs on the bottom.


see http://wiki.emacinc.com/doku.php?id=linux:eclipse:newsdkproject

See Also

Compile and Run procedure from the Eclipse Example Project Guide to compile the project. Note: There may be differences between