Difference between revisions of "Eclipse & Gitlab Tutorial"

From Embedded Systems Learning Academy
Jump to: navigation, search
Line 1: Line 1:
 
This tutorial shows how to use source control software (GIT) from within Eclipse.  There are several hosts that can provide GIT services, and [http://gitlab.com Gitlab] appears to be a great one!  In this tutorial, I will show you how to '''CLONE''' my LPC project for the SJ-One board, and you can use the knowledge to work on your own GIT projects.
 
This tutorial shows how to use source control software (GIT) from within Eclipse.  There are several hosts that can provide GIT services, and [http://gitlab.com Gitlab] appears to be a great one!  In this tutorial, I will show you how to '''CLONE''' my LPC project for the SJ-One board, and you can use the knowledge to work on your own GIT projects.
  
 +
<BR/>
 
== Setup Gitlab Profile ==
 
== Setup Gitlab Profile ==
 
*  Create yourself a Gitlab profile.
 
*  Create yourself a Gitlab profile.
Line 13: Line 14:
 
*  Click on '''Create Project'''
 
*  Click on '''Create Project'''
  
 +
<BR/>
 
== Clone GIT Repository ==
 
== Clone GIT Repository ==
 
In this section, we will bring-in the Gitlab project in your computer through Eclipse.  Eclipse uses '''TEAM''' as a Git client.
 
In this section, we will bring-in the Gitlab project in your computer through Eclipse.  Eclipse uses '''TEAM''' as a Git client.
Line 30: Line 32:
 
*:  Your project will show under "Git Repositories" section.
 
*:  Your project will show under "Git Repositories" section.
  
 +
<BR/>
 
== Import Gitlab project to Eclipse ==
 
== Import Gitlab project to Eclipse ==
 
The final step is to '''IMPORT''' the project in Eclipse.  As of now (June 2014), Eclipse has a bug where you cannot use "Import Project" while adding the Git project in the previous section, so we will do this manually.
 
The final step is to '''IMPORT''' the project in Eclipse.  As of now (June 2014), Eclipse has a bug where you cannot use "Import Project" while adding the Git project in the previous section, so we will do this manually.
Line 37: Line 40:
 
*  Click '''Next''' and browse the root directory of your project and click '''Finish'''
 
*  Click '''Next''' and browse the root directory of your project and click '''Finish'''
  
 +
<BR/>
 
== Check-in code to Gitlab ==
 
== Check-in code to Gitlab ==
 
After you have a project in Eclipse that is connected to Gitlab, you can now perform changes, and check-in the source code.  Making changes is as easy as editing a file.  Eclipse will inform you which files have changed by using icons next to the files or folders.
 
After you have a project in Eclipse that is connected to Gitlab, you can now perform changes, and check-in the source code.  Making changes is as easy as editing a file.  Eclipse will inform you which files have changed by using icons next to the files or folders.

Revision as of 01:01, 19 June 2014

This tutorial shows how to use source control software (GIT) from within Eclipse. There are several hosts that can provide GIT services, and Gitlab appears to be a great one! In this tutorial, I will show you how to CLONE my LPC project for the SJ-One board, and you can use the knowledge to work on your own GIT projects.


Setup Gitlab Profile

  • Create yourself a Gitlab profile.
    Verify it by clicking on the URL sent by Gitlab.
  • I have setup my GIT project with the following HTTP address:
    https://gitlab.com/preet/lpc1758_freertos.git
    Copy the URL above to your clipboard (highlight and Ctrl+C)
  • At the Gitlab homepage, click on "New Project"
  • Click on Import existing repository
    Paste the URL you copied
    This will create a project and copy my project's source code for you.
  • Click on Create Project


Clone GIT Repository

In this section, we will bring-in the Gitlab project in your computer through Eclipse. Eclipse uses TEAM as a Git client.

  • Copy your Git Project HTTPS URL
    This is not my project's URL, but YOUR project's URL
  • In Eclipse, make sure that you have the "Git Repositories" view available
    Go to Window --> Show View --> Other
    Click on Git --> Git Repositories
  • Now in the Git window, click on Clone a Git repository
    Your copied Git repository will auto-fill
  • Type your username and password
    Click Next, and then Next again
  • At this window, you will see Finish, but before you click, use correct destination directory
    Choose your "workspace" directory, such as SJSU_Dev/projects
  • Click Finish, and wait a few minutes for Eclipse to bring-in the Gitlab project
    Your project will show under "Git Repositories" section.


Import Gitlab project to Eclipse

The final step is to IMPORT the project in Eclipse. As of now (June 2014), Eclipse has a bug where you cannot use "Import Project" while adding the Git project in the previous section, so we will do this manually.

  • In the Project Explorer section, right click and choose "Import Project"
  • Under General, pick Existing Projects into Workspace
  • Click Next and browse the root directory of your project and click Finish


Check-in code to Gitlab

After you have a project in Eclipse that is connected to Gitlab, you can now perform changes, and check-in the source code. Making changes is as easy as editing a file. Eclipse will inform you which files have changed by using icons next to the files or folders.

  • Make any changes
  • Right click on your project and click on Team --> Commit
  • Right click on your project, and click on Team --> Push

Other helpful hints:

  • If others' have checked-in source code, you can go to Team and Pull to pull-in their changes