Skip to content

chore(common): update package source mapping #2577

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 28, 2024
Merged

chore(common): update package source mapping #2577

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 24 additions & 16 deletions installation/nuget.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,7 @@ To edit a `NuGet.Config` file and add the Telerik feed, you need to:
<packageSources>
<!--To inherit the global NuGet package sources remove the <clear/> line below -->
<clear />
<add key="nuget" value="https://api.nuget.org/v3/index.json" />
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
<add key="TelerikOnlineFeed" value="https://nuget.telerik.com/v3/index.json" />
</packageSources>
<packageSourceCredentials>
Expand Down Expand Up @@ -142,28 +142,36 @@ You can [generate your Telerik NuGet API Key on telerik.com](https://www.telerik

The `Telerik.UI.for.Blazor` NuGet package and most of its dependencies reside on `nuget.telerik.com`. On the other hand, the [Telerik icon packages]({%slug common-features-icons%}) reside on `nuget.org`. The correct [package source mapping](https://learn.microsoft.com/en-us/nuget/consume-packages/package-source-mapping) configuration should be similar to:

> Make sure that the `key` values in the `packageSourceMapping` section match the `key` values in the `packageSources` section, otherwise you will get a "Package not found" error.
Copy link
Contributor

@ikoevska ikoevska Dec 4, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Our style guide recommends code formatting for error messages.

Suggested change
> Make sure that the `key` values in the `packageSourceMapping` section match the `key` values in the `packageSources` section, otherwise you will get a "Package not found" error.
> Make sure that the `key` values in the `packageSourceMapping` section match the `key` values in the `packageSources` section, otherwise you will get a `Package not found` error.


>caption packageSourceMapping configuration for Telerik UI for Blazor and other Telerik Packages

<div class="skip-repl"></div>

````CSHTML
<packageSourceMapping>
<packageSource key="nuget.org">
<package pattern="*" />
<package pattern="Telerik.FontIcons" />
<package pattern="Telerik.SvgIcons" />
</packageSource>
<packageSource key="TelerikOnlineFeed">
<package pattern="Telerik*" />
<package pattern="Kendo*" />
<package pattern="UI.for*" />
<package pattern="JustMock*" />
</packageSource>
</packageSourceMapping>
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<packageSources>
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
<add key="TelerikOnlineFeed" value="https://nuget.telerik.com/v3/index.json" />
</packageSources>

<packageSourceMapping>
<packageSource key="nuget.org">
<package pattern="*" />
<package pattern="Telerik.FontIcons" />
<package pattern="Telerik.SvgIcons" />
</packageSource>
<packageSource key="TelerikOnlineFeed">
<package pattern="Telerik*" />
<package pattern="Kendo*" />
<package pattern="UI.for*" />
<package pattern="JustMock*" />
</packageSource>
</packageSourceMapping>
</configuration>
````

> Make sure that the `key` values in the `packageSourceMapping` section match the `key` values in the `packageSources` section, otherwise you will get a "Package not found" error.


## Access NuGet Packages behind Firewall

Expand Down
Loading