Difference between revisions of "Eclipse & Gitlab Tutorial"
From Embedded Systems Learning Academy
| 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.
Contents
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
