Skip to content

Commit 198d260

Browse files
dimodiyordan-mitev
andauthored
docs(common): Improve NuGet troubleshooting info (#1351)
* docs(common): Improve NuGet troubleshooting info * Update common-features/icons.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update installation/nuget.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update troubleshooting/nuget-feed.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update troubleshooting/nuget-feed.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> --------- Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com>
1 parent f5ad0c5 commit 198d260

File tree

3 files changed

+21
-0
lines changed

3 files changed

+21
-0
lines changed

common-features/icons.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,8 @@ The Telerik Blazor components use built-in icons with the help of two NuGet pack
3535
* `Telerik.FontIcons` - defines the `FontIcon` `enum` for easier usage of built-in **font** icons
3636
* `Telerik.SvgIcons` - defines the `ISvgIcon` interface and the `SvgIcon` static class for built-in **SVG** icons
3737

38+
>tip Unlike the `Telerik.UI.for.Blazor` package, the icon packages are available from the `nuget.org` source. Keep this in mind when using [`packageSourceMapping`](https://learn.microsoft.com/en-us/nuget/consume-packages/package-source-mapping).
39+
3840
To use the icons, import one or both namespaces, for example in `_Imports.razor`:
3941

4042
>caption Register Telerik Blazor icon namespaces

installation/nuget.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,12 @@ To use a `nuget.config` file for the Telerik feed, you need to:
127127
</packageSourceCredentials>
128128
</configuration>
129129

130+
131+
## Troubleshooting
132+
133+
For tips about common pitfalls when working with the Telerik NuGet feed, see the [NuGet Troubleshooting]({%slug troubleshooting-nuget%}) article.
134+
135+
130136
## Next Steps
131137

132138
@[template](/_contentTemplates/common/get-started.md#after-install)

troubleshooting/nuget-feed.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ This article provides ways to fix the most common problems we have had reported
1414

1515
* [I do not see the Telerik Packages](#i-do-not-see-the-telerik-packages)
1616
* [Error 401 Logon failed.](#error-401-login-failed)
17+
* [Error `Unable to find package`](#unable-to-find-package)
1718

1819
## I do not see the Telerik Packages
1920

@@ -63,6 +64,18 @@ Add-Type -AssemblyName System.Web
6364
![Powershell Encoding](images/encode-passwords-with-powershell.png)
6465

6566

67+
## Unable to Find Package
68+
69+
The error `Unable to find package` can imply the following:
70+
71+
* If the error occurs for the `Telerik.UI.for.Blazor` package, the [Telerik NuGet source]({%slug installation/nuget%}) may not be added or enabled. The possible causes are:
72+
* Missing configuration in the `NuGet.Config` file (or Visual Studio).
73+
* The correct `NuGet.Config` file is not used. This is common in Docker scenarios and the solution is to copy the `NuGet.Config` file explicitly during build. See the forum thread about [private NuGet feeds in Docker](https://www.telerik.com/forums/can-the-telerik-blazor-and-asp-net-tools-be-used-in-a-docker-container) and [some DevOps examples](https://github.com/LanceMcCarthy/DevOpsExamples)).
74+
* If the error occurs for the [icon packages (`Telerik.FontIcons` and `Telerik.SvgIcons`)]({%slug general-information/font-icons%}), the NuGet client is not using `nuget.org` as a NuGet source. The possible causes are:
75+
* The NuGet source is disabled.
76+
* The [`packageSourceMapping`](https://learn.microsoft.com/en-us/nuget/consume-packages/package-source-mapping) forces the NuGet client to search for the icon packages in the `nuget.telerik.com` source. However, the icon packages are published on `nuget.org`.
77+
78+
6679
## See Also
6780

6881
* [Setup of the Telerik Online Private NuGet Feed]({%slug installation/nuget%})

0 commit comments

Comments
 (0)