{"id":138,"date":"2018-08-27T00:00:00","date_gmt":"2018-08-27T07:00:00","guid":{"rendered":"http:\/\/devblogs.microsoft.com\/nuget\/introducing-source-code-link-for-nuget-packages"},"modified":"2018-08-27T00:00:00","modified_gmt":"2018-08-27T07:00:00","slug":"introducing-source-code-link-for-nuget-packages","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/introducing-source-code-link-for-nuget-packages\/","title":{"rendered":"Introducing Source Code Link for NuGet packages"},"content":{"rendered":"

NuGet.org now supports surfacing source code repository link for NuGet packages. This will enable package authors to surface both the project’s website and the source repository using the projectUrl<\/code> and the repository<\/code> properties respectively instead of having to choose between the two using just the projectUrl<\/code> property. The nuspec has supported the repository<\/code> property for a while and today more than 16,000 packages contain this property. We have now come a full circle by surfacing this information on the package details page (on NuGet.org). This is how it looks for the Newtonsoft.Json<\/a> package: \"Source In this post, I would like to elaborate on the different ways to light up this feature for your packages.<\/p>\n

Using nuspec<\/code><\/h3>\n

If you are using a nuspec<\/code> file for packaging, you will need to add a repository tag within your nuspec. For example, take a look at NUnit’s nuspec<\/a>: <\/p>\n

      <!-- Add this line and making the URL targets your project --> \n      <repository type=\"git\" url=\"https:\/\/github.com\/nunit\/nunit\" \/>\n\n      <!-- .. snipped ... --> \n   <\/metadata> \n<\/package>\n<\/code><\/pre>\n
Using project file<\/h3>\n
If you create your NuGet package directly with a project file, you will need to add a RepositoryUrl<\/code> and a RepositoryType<\/code> to the project file to enable this new feature on your package. Here’s an example on how RestSharp<\/a> implements it directly within their csproj<\/code>.   <\/p>\n
    <RepositoryUrl>https:\/\/github.com\/restsharp\/RestSharp.git<\/RepositoryUrl> \n    <RepositoryType>git<\/RepositoryType> \n    <!-- .. snipped ... --> \n   <\/PropertyGroup> \n   <!-- .. snipped ... --> \n<\/Project>\n<\/code><\/pre>\n
Using SourceLink<\/h3>\n
SourceLink<\/a> enables source debugging directly within your .NET Core packages. At the same time, it also inserts the repository attribute in your project to have the link show up on the NuGet package’s details page. To use it, you need to add the following to your csproj<\/code> file.<\/p>\n
<PropertyGroup>\n    <!-- Optional: Publish the repository URL in the built .nupkg (in the NuSpec <Repository> element) -->\n    <PublishRepositoryUrl>true<\/PublishRepositoryUrl>\n<\/PropertyGroup>\n\n<ItemGroup>\n  <!-- For GitHub -->\n  <PackageReference Include=\"Microsoft.SourceLink.GitHub\" Version=\"1.0.0-beta-63127-02\" PrivateAssets=\"All\"\/>\n\n  <!-- For Visual Studio Team Services -->\n  <PackageReference Include=\"Microsoft.SourceLink.Vsts.Git\" Version=\"1.0.0-beta-63127-02\" PrivateAssets=\"All\"\/>\n\n  <!-- For Team Foundation Server -->\n  <PackageReference Include=\"Microsoft.SourceLink.Tfs.Git\" Version=\"1.0.0-beta-63127-02\" PrivateAssets=\"All\"\/>\n  <SourceLinkTfsGitHost Include=\"tfs-server-name\" VirtualDirectory=\"tfs\"\/>\n\n  <!-- For GitLab -->\n  <PackageReference Include=\"Microsoft.SourceLink.GitLab\" Version=\"1.0.0-beta-63127-02\" PrivateAssets=\"All\"\/>\n\n  <!-- For BitBucket -->\n  <PackageReference Include=\"Microsoft.SourceLink.Bitbucket.Git\" Version=\"1.0.0-beta-63127-02\" PrivateAssets=\"All\"\/>\n\n<\/ItemGroup><\/code><\/pre>\n
For example, you can refer to the Newtonsoft.Json’s implementation<\/a>.<\/p>\n
Using Cake Build<\/h3>\n
Many open source projects use Cake Build<\/a> to package their projects. Here\u2019s how you need to change your NuGetPackSettings<\/code> to allow the source code repository link to be surfaced on NuGet.org:<\/p>\n
var nuGetPackSettings = new NuGetPackSettings\n    {\n        \/\/ snipped\n        Repository = new NuGetRepository {\n                Type = \"git\",\n                Url = \"https:\/\/github.com\/org\/repository\"\n            }\n        \/\/ snipped\n    };<\/code><\/pre>\n
Conclusion<\/h3>\n
With these small changes to your packaging process, you will quickly get a source code link next to your project. You won’t have to choose between your project page or your project repository anymore. For more information on how nuspec and csproj properties are mapped, look at our documentation<\/a>. If you want to reach out to us, you can either create a new GitHub issue<\/a> or tag @nuget<\/a> in your tweets.<\/p>\n","protected":false},"excerpt":{"rendered":"
NuGet.org now supports surfacing source code repository link for NuGet packages. This will enable package authors to surface both the project’s website and the source repository using the projectUrl and the repository properties respectively instead of having to choose between the two using just the projectUrl property. The nuspec has supported the repository property for […]<\/p>\n","protected":false},"author":41506,"featured_media":56238,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[7933,7874,7931],"tags":[],"class_list":["post-138","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-feature-announcement","category-nuget","category-nuget-org"],"acf":[],"blog_post_summary":"
NuGet.org now supports surfacing source code repository link for NuGet packages. This will enable package authors to surface both the project’s website and the source repository using the projectUrl and the repository properties respectively instead of having to choose between the two using just the projectUrl property. The nuspec has supported the repository property for […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/138","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/41506"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=138"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/138\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/56238"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=138"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=138"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=138"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}