Skip to content

Commit cf3c96b

Browse files
docs(common): Document NuGet v2 EOL (#2136)
Co-authored-by: Dimo Dimov <[email protected]>
1 parent 1bdab82 commit cf3c96b

File tree

2 files changed

+23
-0
lines changed

2 files changed

+23
-0
lines changed

installation/nuget.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,18 @@ The `Telerik.UI.for.Blazor` NuGet package and most of its dependencies reside on
159159

160160
> 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.
161161
162+
163+
## Obsolete Telerik NuGet URL
164+
165+
In addition to feed URL `https://nuget.telerik.com/v3/index.json`, there is also an obsolete NuGet v2 server at `https://nuget.telerik.com/nuget`, which is no longer recommended.
166+
167+
> The NuGet v2 server at `https://nuget.telerik.com/nuget` will be sunset in November 2024.
168+
>
169+
> The new v3 protocol offers faster package searches and restores, improved security, and more reliable infrastructure.
170+
>
171+
> To redirect your feed to the NuGet v3 protocol, all you have to do is to change your NuGet package source URL to `https://nuget.telerik.com/v3/index.json`.
172+
173+
162174
## Troubleshooting
163175

164176
See the [NuGet Troubleshooting]({%slug troubleshooting-nuget%}) article for tips about common pitfalls when working with the Telerik NuGet feed.

troubleshooting/nuget-feed.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ Regardless of the cause for the issue, it is recommended that you start from the
2121
* [Error `503 Service Unavailable`](#error-503-service-unavailable)
2222
* [Message about package `version not found`](#package-version-not-found)
2323
* [Error `Unable to resolve ... . PackageSourceMapping is enabled`](#unable-to-resolve-package-due-to-packagesourcemapping)
24+
* [Error `Failed to retrieve information about ... from remote source`](#failed-to-retrieve-information-from-remote-source)
2425

2526
## Tips for Handling Common NuGet Issues
2627

@@ -107,6 +108,16 @@ Incorrect package source mapping can result in errors similar to:
107108

108109
The solution is to check the **Package Source Mapping** settings in Visual Studio, or [review all applicable `NuGet.Config` files](https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior#config-file-locations-and-uses) on the machine. Then, [adjust the package source mapping configuration]({%slug installation/nuget%}#package-source-mapping).
109110

111+
## Failed to Retrieve Information from Remote Source
112+
113+
An attempt to use the [obsolete Telerik NuGet v2 feed]({%slug installation/nuget%}#obsolete-telerik-nuget-url) after November 2024 will result in an error:
114+
115+
`Failed to retrieve information about 'Telerik.UI.for.Blazor' from remote source 'https://nuget.telerik.com/nuget/FindPackagesById()?id='Telerik.UI.for.Blazor'&semVerLevel=2.0.0'.`
116+
117+
The solution is to [use the Telerik NuGet v3 feed]({%slug installation/nuget%}).
118+
119+
Another possible reason for the same error is an incorrect NuGet feed URL.
120+
110121
## See Also
111122

112123
* [Setting Up the Online Private Telerik NuGet Feed]({%slug installation/nuget%})

0 commit comments

Comments
 (0)