<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>EGit User Guide - Tasks</title>
<link type="text/css" rel="stylesheet" href="../../book.css"/>
</head>
<body>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<th style="width: 100%" align="center" colspan="3">Tasks</th>
</tr>
<tr>
<td style="width: 20%" align="left">
<a href="Concepts.html" title="Concepts">
<img alt="Previous" border="0" src="../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right">
<a href="Reference.html" title="Reference">
<img alt="Next" border="0" src="../../images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Concepts</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Reference</td>
</tr>
</table><hr class="navigation-separator"/>
<h1 id="Tasks">Tasks</h1>
<h2 id="Creating_Repositories">Creating Repositories</h2>
<h3 id="Considerations_for_Git_Repositories_to_be_used_in_Eclipse">Considerations for Git Repositories to be used in Eclipse</h3>
<h4 id="The_short_story">The short story</h4>
<p>When setting up Git Repositories with EGit, there are two recommendations for the creation of "productive" (as opposed to "playground") Repositories:</p>
<ul>
<li>Don't create the Repository within the Eclipse workspace.
<ul>
<li>Be careful when cloning or creating a Repository.</li>
<li>Make sure to use the Git Sharing Wizard correctly.</li>
</ul>
</li>
<li>Don't create a Repository with an Eclipse project as root.
<ul>
<li>Make sure to use the Git Sharing Wizard correctly.</li>
</ul>
</li>
</ul>
<p>The first mistake happens when you specify a workspace folder during cloning or creation of a Repository.</p>
<p>Both mistakes will happen when you use the Git Sharing Wizard from an Eclipse project that you have created manually in your workspace without taking precautions (the wizard has been fixed in the latest version).</p>
<p>Below you will find some motivation for these recommendations.</p>
<h4 id="The_longer_story">The longer story</h4>
<h5 id="Eclipse_Workspace_and_Repository_working_directory">Eclipse Workspace and Repository working directory</h5>
<p>Git Repositories can be created in different ways, for example by cloning from an existing Repository, by creating one from scratch, or by using the EGit Sharing wizard.</p>
<p>In any case (unless you create a "bare" Repository, but that's not discussed here), the new Repository is essentially a folder on the local hard disk which contains the "working directory" and the metadata folder. The metadata folder is a dedicated child folder named ".git" and often referred to as ".git-folder". It contains the actual repository (i.e. the Commits, the References, the logs and such).</p>
<p>The metadata folder is totally transparent to the Git client, while the working directory is used to expose the currently checked out Repository content as files for tools and editors.</p>
<p>Typically, if these files are to be used in Eclipse, they must be imported into the Eclipse workspace in one way or another. In order to do so, the easiest way would be to check in .project files from which the "Import Existing Projects" wizard can create the projects easily. Thus in most cases, the structure of a Repository containing Eclipse projects would look similar to something like this:</p>
<p>
<img border="0" src="images/EGit-0.12-SetupRepo-RepoStructureTwoProjects.jpg"/>
</p>
<h5 id="Implications">Implications</h5>
<p>The above has the following implications:</p>
<ul>
<li>It is probably not a good idea to make a project the root folder of your Repository.</li>
</ul>
<dl>
<dd>The reason is that you will never be able to add another project to this Repository, as the .project file will occupy the root folder; you could still add projects as sub-folders, but this kind of project nesting is known to cause lots of problems all over the place. In order to add another project, you would have to move the project to a sub-folder in the Repository and add the second project as another sub-folder before you could commit this change.</dd>
</dl>
<ul>
<li>It is a good idea to keep your Repository outside of your Eclipse Workspace.</li>
</ul>
<dl>
<dd>There are several reasons for this:</dd>
</dl>
<dl>
<dd>The new Repository will consider the complete folder structure of the Eclipse workspace as (potential) content. This can result in performance issues, for example when calculating the changes before committing (which will scan the complete .metadata folder, for example); more often than not, the workspace will contain dead folders (e.g. deleted projects) which semantically are not relevant for EGit but cannot be excluded easily.</dd>
</dl>
<dl>
<dd>The metadata (.git-) folder will be a child of the Eclipse Workspace. It is unclear whether this might cause unwanted folder traversals by Eclipse.</dd>
</dl>
<dl>
<dd>You can easily destroy your Repository by destroying your Eclipse Workspace.</dd>
</dl>
<h3 id="Creating_a_new_empty_Git_Repository">Creating a new empty Git Repository</h3>
<p>You can create a project first and share it afterwards. The Share Project Wizard supports creation of Git repositories (see
<a href="http://wiki.eclipse.org/EGit/User_Guide/Sharing#Adding_a_project_to_version_control" title="EGit/User Guide/Sharing#Adding_a_project_to_version_control" target="egit_external">Adding a project to version control</a>).
</p>
<p>You can also create a new empty Git Repository from the Git Repositories View (see
<a href="#Creating_a_Repository" title="EGit/User_Guide#Creating_a_Repository">Creating a Repository</a>).
</p>
<h3 id="Creating_a_Git_Repository_for_multiple_Projects">Creating a Git Repository for multiple Projects</h3>
<p>You may create multiple projects under a common directory and then create a common repository for all projects in one go:</p>
<ul>
<li>create the Eclipse projects (e.g. a, b, c) under a common directory (e.g. <span style="font-family:monospace;">/repos/examples/</span>)</li>
<li>select all projects (a, b, c), and in the contextual menu click
<b>Team > Share Project > Git</b>
</li>
<li>press
<b>Next</b>
</li>
<li>select all projects (a, b, c)</li>
<li>the wizard automatically moves up the default repository location to the parent folder <span style="font-family:monospace;">/repos/examples/</span> since multiple projects have been selected</li>
<li>click
<b>Create Repository</b> and
<b>Finish</b>
</li>
</ul>
<p>
<br/>
</p>
<h2 id="Starting_from_existing_Git_Repositories">Starting from existing Git Repositories</h2>
<p>In order to work with the content of a Git repository in the Eclipse workbench, the contained files and folders must be imported as projects. In principle, this import can be done using the generic "New Project" or "Import..." wizards, since the working directory of a Git Repository is just a normal directory in the local file system. However, the newly created projects would still have to be shared manually with Git. The "Import Projects from Git" wizard integrates project import and sharing and also offers some extra convenience.</p>
<h3 id="Starting_the_import_wizard">Starting the import wizard</h3>
<p>To start the wizard click
<b>Import > Git > Projects from Git</b>.
</p>
<p>If you started in a clean workspace, the first page will display an empty list:</p>
<p>
<img border=
Eclipse Mac 版
需积分: 10 130 浏览量
2018-05-29
12:17:46
上传
评论
收藏 29.68MB ZIP 举报
Eclipse Mac 版 （3420个子文件） 
.fileTable.10 150B framework.info.16 2.55MB .fileTable.16 76B .fileTable.17 76B .mainData.3 3.46MB .extraData.3 1015KB .table.3 174KB .contributors.3 56KB .namespaces.3 50KB .contributions.3 33KB .orphans.3 261B .fileTable.9 150B README.adoc 393B .api_description 367B
splash.bmp 394KB MarketplaceWizard.class 41KB MarketplaceViewer.class 41KB CustomizationContentsArea.class 39KB MarketplaceDiscoveryStrategy.class 37KB MarketplacePage.class 36KB JdtUtils.class 28KB AbstractMarketplaceDiscoveryItem.class 25KB MavenProjectWizardArchetypePage.class 25KB Messages.class 23KB UniversalIntroConfigurer.class 22KB MavenImportWizardPage.class 22KB MarketplaceCatalog.class 22KB DiscoveryItem.class 20KB ProfileChangeOperationComputer.class 20KB LifecycleMappingsViewer.class 19KB FeatureSelectionWizardPage.class 18KB MavenRepositorySearchDialog.class 18KB MavenProjectWizardArchetypeParametersPage.class 18KB FavoritesViewer.class 18KB SelectionModel.class 17KB NestedProjectsComposite.class 17KB PomEdits.class 16KB LifecycleMappingPage.class 15KB MavenRepositoryView.class 15KB JavaElementResolver.class 15KB MavenPomSelectionComponent.class 15KB SelectionUtil.class 14KB MarketplaceInfo.class 14KB MarketplaceUrlHandler.class 14KB MavenSettingsPreferencePage.class 13KB MavenInstallationWizardPage.class 13KB ControlDecoration.class 12KB OpenPomAction.class 12KB MavenInstallFileArtifactWizardPage.class 12KB OverviewToolTip.class 12KB FavoritesDiscoveryStrategy.class 11KB CatalogSwitcher.class 11KB BuildDebugView.class 11KB ShareSolutionLink.class 11KB MarketplaceClientUi.class 10KB AbstractMarketplaceWizardCommand.class 10KB MavenConsoleImpl.class 10KB ASTNodeUtils.class 10KB MavenModuleWizardParentPage.class 10KB ImportFavoritesPage.class 10KB MarketplaceWizardCommand.class 10KB RcpModule.class 9KB PomHelper.class 9KB IndexSearchEngine.class 9KB MavenInstallationsPreferencePage.class 9KB MavenProjectWizardArtifactPage.class 9KB ItemButtonController.class 9KB MarketplaceNodeCatalogItem.class 9KB AbstractProvisioningOperation.class 9KB NewsUrlHandler.class 9KB EditDependencyDialog.class 9KB Messages.class 9KB MavenProblemResolution.class 9KB MavenModuleWizard.class 9KB NewsViewer.class 9KB MavenArchetypesPreferencePage.class 8KB MavenProjectWizard.class 8KB JavaModelEventsService.class 8KB LocalArchetypeCatalogDialog.class 8KB RemoteArchetypeCatalogDialog.class 8KB MavenDiscoveryProposalWizard$1.class 8KB LifecycleMappingDiscoveryHelper.class 8KB IntroData.class 8KB ResourceProvider.class 8KB AbstractMarketplaceWizardDialog.class 8KB BundleResolutionFailureDialog.class 8KB MavenPomWizardPage.class 8KB JavaElementSelections.class 8KB DiscoverFileSupportJob.class 8KB CompositeProfileChangeOperation.class 8KB AbstractMavenWizardPage.class 8KB ASTStringUtils.class 8KB AbstractSimpleDiscoveryItem.class 7KB LifecycleMappingOperation.class 7KB MavenProjectWizardLocationPage.class 7KB MavenProjectWizardArchetypePage$17.class 7KB MarketplaceClientUiPlugin.class 7KB CustomArchetypeDialog.class 7KB GroupData.class 7KB MavenDiscoveryProposalWizard.class 7KB共 3420 条
- 1
- 2
- 3
- 4
- 5
- 6
- 35
资源评论
