You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _contentTemplates/common/get-started.md
+28-16Lines changed: 28 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,39 +36,51 @@ Whenever you need to authenticate your system with the Telerik NuGet server, use
36
36
#end
37
37
38
38
#add-nuget-feed
39
-
## Step 3: Add the Telerik NuGet Feed to Visual Studio
39
+
## Step 3: Add the Telerik NuGet Feed
40
40
41
-
In this tutorial, you will use the [Telerik NuGet feed](slug:installation/nuget) to download the UI for Blazor components. This NuGet feed is private and requires you to authenticate with a NuGet API key.
41
+
In this tutorial, you will use the [Telerik NuGet server](slug:installation/nuget) to download the UI for Blazor components. The NuGet feed is private and requires you to authenticate with a NuGet API key.
42
42
43
-
To generate your NuGet API key:
43
+
### Generate NuGet API Key
44
44
45
45
1. Go to the [API Keys](https://www.telerik.com/account/downloads/api-keys) page in your Telerik account.
46
-
47
46
1. Click **Generate New Key +**.
48
-
49
47
1. In the **Key Note** field, add a note that describes the API key.
50
-
51
48
1. Click **Generate Key**.
52
-
53
49
1. Select **Copy and Close**. Once you close the window, you can no longer copy the generated key. For security reasons, the **API Keys** page displays only a portion of the key.
54
-
55
50
1. Store the generated NuGet API key as you will need it in the next steps.
56
51
57
-
Next, add the Telerik NuGet feed to Visual Studio:
58
-
59
-
1. In Visual Studio and go to **Tools** > **NuGet Package Manager** > **Package Manager Settings**.
52
+
Next, add the Telerik NuGet feed to your local development environment:
60
53
61
-
1. Select **Package Sources** and then click the **+** button to add a new package source.
54
+
*[Visual Studio on Windows](#visual-studio)
55
+
*[All IDEs and operating systems](#all-ides-and-operating-systems)
62
56
63
-
1. Enter a **Name** for the new package source, for example, `telerik.com`.
57
+
>tip For more information on the Telerik NuGet packages and download options, check [section NuGet Packages in the Workflow article](slug:getting-started/what-you-need#nuget-packages).
64
58
65
-
1. Add the `https://nuget.telerik.com/v3/index.json` URL as a **Source**. Click **OK**.
59
+
### Visual Studio
66
60
67
-

61
+
The following approach will store the Telerik NuGet server URL in your [global `NuGet.Config` file](https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior), and save your NuGet API key in the Windows Credential Manager.
68
62
63
+
1. Go to **Tools** > **NuGet Package Manager** > **Package Manager Settings**.
64
+
1. Select **Package Sources** and then click the **+** or **Add** button.
65
+
1. Enter a **Name** for the new package source. The examples in this documentation usually use `TelerikOnlineFeed`.
66
+
1. Add `https://nuget.telerik.com/v3/index.json` as a **Source** URL. Click **OK** or **Save**.
69
67
1. Whenever Visual Studio displays a dialog to enter credentials for `nuget.telerik.com`, use `api-key` as the username and your NuGet API key as the password.
70
68
71
-
>tip For alternative NuGet package download options, check the [Workflow article](slug:getting-started/what-you-need).
69
+
### All IDEs and Operating Systems
70
+
71
+
Run [`dotnet nuget add source`](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-nuget-add-source) in your preferred command line interface (cmd, Terminal, PowerShell, Bash). The command will store the Telerik NuGet server URL and your NuGet API key in your [global `NuGet.Config` file](https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior).
72
+
73
+
Replace `<YOUR-NUGET-API-KEY>` with the API key that you [generated previously](#generate-nuget-api-key).
74
+
75
+
>caption Use the .NET CLI to add the Telerik NuGet source
Copy file name to clipboardExpand all lines: getting-started/client-blazor.md
+3-15Lines changed: 3 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,26 +32,14 @@ This article explains how to get the <a href = "https://www.telerik.com/blazor-u
32
32
33
33
## Step 2: Create a New Project
34
34
35
-
1. Open Visual Studio and select **Create a new project**.
36
-
37
-
1. Select the **Blazor WebAssembly App** project type, enter a name for your project, and then click **Next**.
38
-
39
-
1. Select the **ASP.NET Core hosted** checkbox and the desired framework, and then click **Create**.
35
+
* To create a new Blazor app, open your preferred IDE or [run the `dotnet new` .NET CLI command](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-new).
36
+
* Use the [**Blazor WebAssembly Standalone App**](https://learn.microsoft.com/en-us/aspnet/core/blazor/project-structure) project template.
1. Select the `telerik.com`**Package source** that you [added earlier](#step-3-add-the-telerik-nuget-feed-to-visual-studio). As this is a private NuGet feed, you must authenticate using `api-key` as the username and [your NuGet API key](#step-3-add-the-telerik-nuget-feed-to-visual-studio) as the password.
52
-
1. Select the **Browse** tab, find the `Telerik.UI.for.Blazor` NuGet package, and click **Install**.
53
-
54
-

42
+
Add the `Telerik.UI.for.Blazor` NuGet package from the package source that you [added earlier](#step-3-add-the-telerik-nuget-feed) to every project that will use the Telerikk Blazor components. When prompted, authenticate using `api-key` as the username and [your NuGet API key](#generate-nuget-api-key) as the password.
Copy file name to clipboardExpand all lines: getting-started/web-app.md
+8-15Lines changed: 8 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,17 +36,16 @@ This article explains how to use the Telerik UI for Blazor components in a Blazo
36
36
37
37
## Step 2: Create a New Project
38
38
39
-
1. Open Visual Studio and select **Create a new project**.
39
+
To create a new Blazor app:
40
40
41
-
1. Select the [**Blazor Web App**](https://learn.microsoft.com/en-us/aspnet/core/blazor/project-structure?view=aspnetcore-8.0#blazor-web-app) project type, enter a name for your project, and then click **Next**.
42
-
43
-
1. Select the desired [Interactive render mode](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-8.0#render-modes) and **Global** Interactivity location. Global interactivity ensures easier setup and usage of the Telerik components.
44
-
45
-
1. Click **Create**.
41
+
1. Open your preferred IDE or [run the `dotnet new` .NET CLI command](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-new).
42
+
1. Use the [**Blazor Web App**](https://learn.microsoft.com/en-us/aspnet/core/blazor/project-structure) project template.
43
+
1. Select the desired [interactive render mode](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes).
44
+
1. Enable **Global** Interactivity location.
46
45
47
46
### Interactive Render Mode
48
47
49
-
> Telerik UI for Blazor requires interactive render mode. Using [**Global** Interactivity location](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#apply-a-render-mode-to-the-entire-app) is highly recommended.
48
+
> Telerik UI for Blazor requires interactive render mode. Using [**Global** Interactivity location](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#apply-a-render-mode-to-the-entire-app) is highly recommended, as it ensures easier setup and usage of the Telerik components.
50
49
> The Telerik Blazor components will not respond to user actions and the Blazor framework will not refresh their UI in [Static server-side rendering mode (static SSR)](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#static-server-side-rendering-static-ssr). Telerik Blazor components with JavaScript rendering (Barcodes, Charts, Gauges, Maps, and QR Codes) will not render in static SSR at all.
51
50
>
52
51
> The `Account` section in the Blazor Web App template with identity is static by design. Most Telerik Blazor components cannot work in this section.
@@ -55,15 +54,9 @@ This article explains how to use the Telerik UI for Blazor components in a Blazo
55
54
56
55
## Step 4: Install the Telerik UI for Blazor Components
57
56
58
-
1. To include the Telerik component library, right-click each project that will use Telerik Blazor components, and select **Manage NuGet Packages**.
59
-
60
-
* Apps with interactive Server render mode need the Telerik Nuget package in the server project.
61
-
* Apps with global interactive Auto or WebAssembly render mode need the Telerik NuGet package in the client project.
62
-
63
-
1. Install the Telerik Blazor NuGet package:
57
+
Add the `Telerik.UI.for.Blazor` package from the NuGet source that you [added earlier](#step-3-add-the-telerik-nuget-feed) to every project that will use the Telerik Blazor components. Apps with global interactive **Auto** or **WebAssembly** render mode need the Telerik NuGet package in the `Client` project.
64
58
65
-
1. Select the `telerik.com`**Package source** that you [added earlier](#step-3-add-the-telerik-nuget-feed-to-visual-studio). As this is a private NuGet feed, you must authenticate using `api-key` as the username and [your NuGet API key](#step-3-add-the-telerik-nuget-feed-to-visual-studio) as the password.
66
-
1. Select the **Browse** tab, find the `Telerik.UI.for.Blazor` NuGet package, and click **Install**.
59
+
When prompted, authenticate using `api-key` as the username and [your NuGet API key](#generate-nuget-api-key) as the password.
0 commit comments