Kom i gang

RayCraft Free hentes fra nuget.org. RayCraft Complete hentes fra en privat NuGet-feed og krever en aktiv lisens og et tilgangstoken.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

Feeden er https://nuget.raycraft.dev/v3/index.json, brukernavnet er rcf, og passordet er tokenet (det begynner med rcf_).

• 1
  Opprett et token

  Logg inn på auth.raycraft.dev, åpne Pakketilgang, og opprett et token. Det vises bare én gang, så kopier det med en gang. Det kan finnes opptil 10 tokener per lisens; et tilbakekalt token slutter å virke umiddelbart.

• 2
  Legg til feeden på datamaskinen

  Kommandoen lagrer kilden i brukerens nuget.config, ikke i prosjektet.

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 trengs på Linux, macOS og på build-agenter. I Windows kan det utelates, og passordet krypteres da for brukeren.

Byggserver

Legg en nuget.config i repositoriet som leser tokenet fra en variabel, og angi RAYCRAFT_FEED_TOKEN som hemmelighet i byggesystemet.

<?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>

Installer pakkene

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

Registrer og bruk

I Program.cs (ved WebAssembly og Auto også i klientprosjektet):

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

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

Angi temaet på html i Components/App.razor, og legg til filene:

<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>

I Components/_Imports.razor:

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

Kontrollene kan deretter brukes direkte, for eksempel <ThemeMenu />, <DialogHost /> og <SnackbarHost />. Linjen AddRayCraftOffice og Office-stilarket trengs bare sammen med Office-pakken.

Kontroller tilgangen

Uten token svarer feeden 401, noe som viser at adressen er riktig og tilgangen beskyttet. Med token, en skrivebeskyttet kontroll:

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

Forventet: JSON med version og en liste resources.

Vanlige problemer

Skriv til support@raycraft.dev med pakkens navn og versjon, plattform, .NET-versjon og feed-linjene fra dotnet restore -v d (uten tokenet).