Kom i gang

RayCraft Free hentes fra nuget.org. RayCraft Complete hentes fra et privat NuGet-feed og kræver en aktiv licens og et adgangstoken.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

Feedet er https://nuget.raycraft.dev/v3/index.json, brugernavnet er rcf, og adgangskoden er tokenet (det begynder med rcf_).

• 1
  Opret et token

  Log ind på auth.raycraft.dev, åbn Pakkeadgang, og opret et token. Det vises kun én gang, så kopiér det med det samme. Der kan være op til 10 tokens pr. licens; et tilbagekaldt token holder op med at virke med det samme.

• 2
  Tilføj feedet på computeren

  Kommandoen gemmer kilden i brugerens nuget.config, ikke i projektet.

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 er nødvendigt på Linux, macOS og på build-agenter. I Windows kan det udelades, og adgangskoden krypteres så til brugeren.

Build-server

Læg en nuget.config i repositoriet, der læser tokenet fra en variabel, og angiv RAYCRAFT_FEED_TOKEN som hemmelighed i build-systemet.

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

Installér pakkerne

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

Registrér og brug

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

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

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

Angiv temaet på html i Components/App.razor, og tilføj filerne:

<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

Kontrollerne kan derefter bruges direkte, for eksempel <ThemeMenu />, <DialogHost /> og <SnackbarHost />. Linjen AddRayCraftOffice og Office-typografiarket skal kun bruges sammen med Office-pakken.

Kontroller adgangen

Uden token svarer feedet 401, hvilket viser, at adressen er rigtig, og adgangen er beskyttet. Med token, en skrivebeskyttet kontrol:

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

Forventet: JSON med version og en liste resources.

Almindelige problemer

Skriv til support@raycraft.dev med pakkens navn og version, platform, .NET-version og feed-linjerne fra dotnet restore -v d (uden tokenet).