GitHub Extension for Visual Studio
Switch branches/tags
Clone or download
Latest commit 2d88489 Sep 19, 2018
Permalink
Failed to load latest commit information.
.ncrunch Merge branch 'master' into feature/serilog-logging Oct 24, 2017
docs Fix broken src links in docs Jul 26, 2018
lib Build against Microsoft.TeamFoundation.* v15.0 Aug 29, 2018
script @ 5ed9b3d WIP: Add fork feature. Dec 11, 2017
scripts Added `zn-CH` translations for .resx files. Sep 11, 2018
src New translations Resources.resx (Chinese Simplified) Sep 18, 2018
submodules Fix akavache submodule. Aug 14, 2018
test Merge branch 'master' into refactor/clone-include-owner-in-path Sep 13, 2018
tools Need these debugging tools too Oct 28, 2017
.editorconfig added .editorconfig to help prevent wrong indent types Oct 28, 2016
.gitattributes Let's get this party started! Dec 12, 2014
.gitignore Ignoring that file Sep 6, 2018
.gitmodules Remove Rothko submodule. Dec 7, 2017
CONTRIBUTING.md Grammar fixes in CONTRIBUTING.md Aug 2, 2018
Directory.Build.Props Bump version in Directory.Build.props. Sep 7, 2018
GitHubVS.sln Merged resources into GitHub.Resources assembly. Sep 12, 2018
GitHubVS.v3.ncrunchsolution Fix ncrunch compilation. Aug 7, 2017
ISSUE_TEMPLATE.md Add more fields to the issue template Aug 17, 2018
LICENSE.md Merge pull request #862 from Phineas/patch-1 Feb 16, 2017
README.md Added `zn-CH` translations for .resx files. Sep 11, 2018
appveyor.yml Trying to run codecoverage differently Sep 6, 2018
build.cmd Fix build/install to match README.md Nov 24, 2017
codecov.yml Getting greedy with the options Sep 4, 2018
crowdin.yml Merge branch 'master' into i18n-merge-resources Sep 13, 2018
deploy-local.cmd Remove unused flag Aug 4, 2017
global.json Update MSBuild.Sdk.Extras version. Sep 5, 2018
install.cmd Fix build/install to match README.md Nov 24, 2017
nuget.config Stop NuGet from creating binding redirects when package is installed Nov 17, 2017
signingkey.snk Fix public key name Nov 2, 2017
test.cmd Make test.cmd execute scripts\test.ps1 Dec 20, 2017

README.md

GitHub Extension for Visual Studio

Notices

If you are having issues with the installer, please read

If you need to upgrade, downgrade, or uninstall the extension, and are having problems doing so, refer to this issue: https://github.com/github/VisualStudio/issues/1394 which details common problems and solutions when using the installer.

The location of the submodules has changed as of 31-01-2017

If you have an existing clone, make sure to run git submodule sync to update your local clone with the new locations for the submodules.

About

The GitHub Extension for Visual Studio provides GitHub integration in Visual Studio 2015. Most of the extension UI lives in the Team Explorer pane, which is available from the View menu.

Official builds of this extension are available at the official website.

Build status Crowdin codecov

Join the chat at freenode:github-vs Join the chat at https://gitter.im/github/VisualStudio

Documentation

Visit the documentation for details on how to use the features in the GitHub Extension for Visual Studio.

Installing beta versions

Older and pre-release/beta/untested versions are available at the releases page, and also via a custom gallery feed for Visual Studio.

You can configure the gallery by going to Tools / Options / Extensions and Updates and adding a new gallery with the url https://visualstudio.github.com/releases/feed.rss. The gallery will now be available from Tools / Extensions and Updates.

Beta releases will have (beta) in their title in the gallery, following the version number. You can view the release notes in the gallery by hovering over the description, or by clicking the Release Notes link on the right side.

Build requirements

  • Visual Studio 2017 (15.7.4)+
  • Visual Studio SDK

Build

Clone the repository and its submodules in a git GUI client or via the command line:

git clone https://github.com/github/VisualStudio
cd VisualStudio
git submodule init
git submodule deinit script
git submodule update

Open the GitHubVS.sln solution with Visual Studio 2017+. To be able to use the GitHub API, you'll need to:

Build using Visual Studio 2017 or:

build.cmd

Install in live (non-Experimental) instances of Visual Studio 2015 and 2017:

install.cmd

Note, the script will only install in one instance of Visual Studio 2017 (Enterprise, Professional or Community).

Build Flavors

The following can be executed via cmd.exe.

To build and install a Debug configuration VSIX:

build.cmd Debug
install.cmd Debug

To build and install a Release configuration VSIX:

build.cmd Release
install.cmd Release

Logs

Logs can be viewed at the following location:

%LOCALAPPDATA%\GitHubVisualStudio\extension.log

More information

  • Andreia Gaita's presentation at Codemania 2016 about this extension.

Contributing

Visit the Contributor Guidelines for details on how to contribute as well as the Open Code of Conduct for details on how to participate.

Copyright

Copyright 2015 - 2018 GitHub, Inc.

Licensed under the MIT License