Difference between revisions of "Git"

From BlackBox Framework Wiki
Jump to navigation Jump to search
Line 70: Line 70:


After creation you will be switched to new branch of project. You can change the current brunch by menu '''Branch/Checkout'''.
After creation you will be switched to new branch of project. You can change the current brunch by menu '''Branch/Checkout'''.
4.7. Then you can change the code, test it and commit the results to this temporary branch.
[[File:Demofix.png]]





Revision as of 10:34, 30 June 2014

This page contains the instructions how to use Git for working with open BlackBox Component Builder GitHub repository in Windows.

1. Download and install Git client with default preferences. http://git-scm.com/download/win

2. Run "Git Gui" and add your name and email in Edit/Options...

Setup.png


3.To make some new project and work with it locally (for experiments and education)

3.1. Move folder with a project to some place, that does not require administrator rights for creation of new folders and files (for example, home directory or desktop)

3.1. Go to folder run pop-up menu at some empty space and choose Init Here.

1init.png

The hidden folder ".git" will be created, it will contain all data about repository (do not remove this folder)

3.3. For adding all files from folder to project run pop-up menu and choose "Git Add all files now".

2addallfiles.png

3.4. For fixation of project state use "Git Commit Tool". (If all files in red-titled area, push "Rescan" and they will move to green-titled area). Write some comment message and push "Commit" button.

3commit.png

3.5 Now you can change some code, stage changed files for commit (image bellow) and commit new changes (see 3.4).

Stagechangedtocommit.png

3.6 Finally you will have the project history ("Git History" in pop-up menu) with the ability to restore any project state or make the new branch for experiments.

4. To work with existing project (with public repository shared with Center members)

4.1. Register at http://github.com

4.2. Make ssh-key on your PC.

4.2.1. Open "Git Bash"

Gitbash.png


4.2.2. Make ssh-key with command: ssh-keygen -t rsa -C "your_email@example.com" press Enter several times until the process will not finish generation.

4.2.3. Copy new key to clipboard with command: clip < ~/.ssh/id_rsa.pub

Keygen.png


4.2.4. Close Git Bash

4.3. Add SSH key to GitHub following numbers in next image

Addsshkey.png


4.4. Start "Git GUI" from Windows Start menu and choose "Clone the existing repository"

4.5. Add this line to sources git@github.com:BlackBoxCenter/bbcb.git and any target folder on your PC

Gitclone.png


4.6. Then the precess of cloning will be finished you can make some changes in files, however more save way is to make new branch Branch/Create... for testing new feature or bug fix:

Newbranch.png

After creation you will be switched to new branch of project. You can change the current brunch by menu Branch/Checkout.


4.7. Then you can change the code, test it and commit the results to this temporary branch.

Demofix.png


4.7. After committing the changes in new branch, you need to merge your change with current state of project. Switch to 'master' branch Branch/Checkout.... Fetch the updates from 'origin' Remote/Fetch from/origin. Then you can choose Merge/Local merge, choose the branch to merge, and press Merge button.

Merge.png

4.8. Push to

....