Първи стъпки

RayCraft Free се тегли от nuget.org. RayCraft Complete се тегли от частен NuGet feed и изисква активен лиценз и токен за достъп.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

Feed-ът е https://nuget.raycraft.dev/v3/index.json, потребителят е rcf, а паролата е вашият токен (започва с rcf_).

• 1
  Създайте токен

  Влезте в auth.raycraft.dev, отворете Достъп до пакетите и създайте токен. Показва се само веднъж, затова го копирайте веднага. Можете да имате до 10 токена на лиценз; отменен токен спира веднага.

• 2
  Добавете feed-а на вашия компютър

  Командата записва източника в потребителския nuget.config, не в проекта.

dotnet nuget add source https://nuget.raycraft.dev/v3/index.json --name RayCraft --username rcf --password <YOUR_TOKEN> --store-password-in-clear-text

--store-password-in-clear-text е нужен на Linux, macOS и в билд агенти. В Windows можете да го пропуснете и паролата се шифрира за вашия потребител.

Билд сървър

Добавете в хранилището nuget.config, който чете токена от променлива, и задайте RAYCRAFT_FEED_TOKEN като тайна във вашата билд система.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="RayCraft" value="https://nuget.raycraft.dev/v3/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <RayCraft>
      <add key="Username" value="rcf" />
      <add key="ClearTextPassword" value="%RAYCRAFT_FEED_TOKEN%" />
    </RayCraft>
  </packageSourceCredentials>
</configuration>

Инсталиране на пакетите

dotnet add package RayCraft.Blazor.Complete --source RayCraft
dotnet restore

Регистрация и употреба

В Program.cs (при WebAssembly и Auto и в клиентския проект):

using RayCraft.Blazor;
using RayCraft.Blazor.Office;

builder.Services.AddRayCraft();
builder.Services.AddRayCraftOffice();

В Components/App.razor задайте темата на html и добавете файловете:

<html lang="en" data-raycraft-theme="light">
<head>
    <link rel="stylesheet" href="_content/RayCraft.Blazor/css/raycraft.css" />
    <link rel="stylesheet" href="_content/RayCraft.Blazor.Office/css/raycraft-office.css" />
</head>
<body>
    <Routes @rendermode="InteractiveServer" />
    <script src="_content/RayCraft.Blazor/raycraft.js"></script>
    <script src="_framework/blazor.web.js"></script>
</body>
</html>

В Components/_Imports.razor:

@using RayCraft.Blazor
@using RayCraft.Blazor.Components

След това контролите се ползват директно, например <ThemeMenu />, <DialogHost /> и <SnackbarHost />. Редът AddRayCraftOffice и стиловият файл на Office са нужни само с пакета Office.

Проверка на достъпа

Без токен feed-ът отговаря с 401, което показва, че адресът е верен и достъпът е защитен. С токен, проверка само за четене:

curl -s -u rcf:$RAYCRAFT_FEED_TOKEN https://nuget.raycraft.dev/v3/index.json

Очаквано: JSON с version и списък resources.

Често срещани проблеми

За всичко друго пишете на support@raycraft.dev с името и версията на пакета, платформата, версията на .NET и редовете за feed от dotnet restore -v d (без токена).